From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id C85316ABCD for ; Fri, 17 Sep 2021 16:58:37 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id B7989AA3C for ; Fri, 17 Sep 2021 16:58:07 +0200 (CEST) Received: from mail-lf1-x131.google.com (mail-lf1-x131.google.com [IPv6:2a00:1450:4864:20::131]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id EC3E7AA26 for ; Fri, 17 Sep 2021 16:58:05 +0200 (CEST) Received: by mail-lf1-x131.google.com with SMTP id z24so8063531lfu.13 for ; Fri, 17 Sep 2021 07:58:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:from:date:message-id:subject:to; bh=eeZ3W8qxmXvXc1MZ6FOeQ+5XfoZxG2/j2IHr4hq2SYQ=; b=H6LQMTYZEwsaqJE/X4rzUIGHv665/MxIl+7jf8NWx+HcGW19dpQZBVui1uL4YvvYKO 0EyvQxtzy2sCCa1zhsfFazljO+7CDswarpGQjGt1hubdz5aZZZ6fGPaa+iKOSK1BOxqK QhslraF59e9XeaUDEuNRjzt8cY6yJhWhZ6PM8Lrzi1O8ztXN6Zzk5651M84DXtXXSV55 kwhoorAWCJXUKaXHIDNJNHqWtbPJpERoK493dzupLMhIQFJZXxSGhMj1HYGb3Lv6yCHg pkgoLT96K9iI7S3F3wpdR6eidxedRpyWXS2tFy6FO807ynVyGonyylS2g3yUi8OXgvv/ g6Kg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=eeZ3W8qxmXvXc1MZ6FOeQ+5XfoZxG2/j2IHr4hq2SYQ=; b=nhJlCvlPDoNUv3hYqmhMv/V4mGCZJbn2l/Vv3OxI563alNwjZSZBgn8FWhjeYeUqtr Ws+M5AeoZZ/yZTn3QIszFyUnWoUUEEAXlKB9c9o1EbvCjFw79/F8rhLfpAYILDd3HS/A cr3MEWDHHc7Yxz4l/WIV0GpaCoUogY3kAtUvjKZ5JMISJIFljl9/sEP990cHAzbPyLrR eQ8qx+JBoDN47sMsKOGXTaGoqZvGM+bLL8OqjNlapVV2oGC8rKbPpoiPl5Oir4MlmfCf p5GamAQihY9L0O9Jdo3WVcoJ4h6SJF+KnbAIXHPBky5bB9XublNwvBXaIkyy9ONU3F2z xupw== X-Gm-Message-State: AOAM5334N/Inkwb41v00SPOrLG/W6LxGlc3NnCj/mL9zXR/+zcT/UvTF MadtC2iG+nQAy1gCEjt3dgwBtzE8XS2g5l4OBbU7RPteUIgJQA== X-Google-Smtp-Source: ABdhPJwXsgiFpM6aAeOO+SptUgZxszqwG3PS2c7elGj0BsdS/wvZw2s1O1Y7qeKpsZ5EpxgFZjS/x2tdfqJfP7hkSVY= X-Received: by 2002:ac2:51ad:: with SMTP id f13mr8947791lfk.582.1631890657668; Fri, 17 Sep 2021 07:57:37 -0700 (PDT) MIME-Version: 1.0 From: Sylvain Faivre Date: Fri, 17 Sep 2021 16:57:26 +0200 Message-ID: To: pve-devel@lists.proxmox.com X-SPAM-LEVEL: Spam detection results: 0 BAYES_00 -1.9 Bayes spam probability is 0 to 1% DKIM_SIGNED 0.1 Message has a DKIM or DK signature, not necessarily valid DKIM_VALID -0.1 Message has at least one valid DKIM or DK signature DKIM_VALID_AU -0.1 Message has a valid DKIM or DK signature from author's domain DKIM_VALID_EF -0.1 Message has a valid DKIM or DK signature from envelope-from domain FREEMAIL_FROM 0.001 Sender email is commonly abused enduser mail provider HTML_MESSAGE 0.001 HTML included in message RCVD_IN_DNSWL_NONE -0.0001 Sender listed at https://www.dnswl.org/, no trust SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record URIBL_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to URIBL was blocked. See http://wiki.apache.org/spamassassin/DnsBlocklists#dnsbl-block for more information. [pve-doc-generator.mk, extractapi.pl, mk.in, resthandler.pm, proxmox.com] Content-Type: text/plain; charset="UTF-8" X-Content-Filtered-By: Mailman/MimeDel 2.1.29 Subject: [pve-devel] building pve-docs - Can't locate PVE/RESTHandler.pm X-BeenThere: pve-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox VE development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 17 Sep 2021 14:58:37 -0000 Hello, I am planning to submit patches for the Proxmox docs, following my post at https://forum.proxmox.com/threads/some-notes-and-questions-about-proxmox-cluster-networking.96001/ I found the pve-docs git repo, and read through https://pve.proxmox.com/wiki/Developer_Documentation In order to see the results of my changes, I am trying to compile the docs from the .adoc source files. For this, I read the README.adoc file in the pve-docs repo, which says : > To simplify the documentation task, we keep all Documentation within > this repository. It is possible to generate the docs without installing > any additional Proxmox packages with: > > make pve-doc-generator.mk > make index The first command seems to run fine : $ make pve-doc-generator.mk ./scan-adoc-refs *.adoc --depends .pve-doc-depends.tmp > link-refs.json.tmp cat pve-doc-generator.mk.in .pve-doc-depends > pve-doc-generator.mk.tmp sed -i "s/@RELEASE@$/7.0/" pve-doc-generator.mk.tmp mv pve-doc-generator.mk.tmp pve-doc-generator.mk make: 'pve-doc-generator.mk' is up to date. The second command fails with : $ make index ./extractapi.pl >api-viewer/apidata.js Can't locate PVE/RESTHandler.pm in @INC (you may need to install the PVE::RESTHandler module) (@INC contains: /etc/perl /usr/local/lib/x86_64-linux-gnu/perl/5.32.1 /usr/local/share/perl/5.32.1 /usr/lib/x86_64-linux-gnu/perl5/5.32 /usr/share/perl5 /usr/lib/x86_64-linux-gnu/perl-base /usr/lib/x86_64-linux-gnu/perl/5.32 /usr/share/perl/5.32 /usr/local/lib/site_perl) at ./extractapi.pl line 6. BEGIN failed--compilation aborted at ./extractapi.pl line 6. make: *** [Makefile:155: api-viewer/apidata.js] Error 2 I don't know where to find the PVE::RESTHandler module. What should I do next ? Thanks in advance. Sylvain