[pve-devel] building pve-docs - Can't locate PVE/RESTHandler.pm

[Sylvain Faivre]

On Sat, Sep 18, 2021 at 1:07 PM Thomas Lamprecht <t.lamprecht at proxmox.com>
wrote:

> Hi,
>
> On 17.09.21 16:57, Sylvain Faivre wrote:
> > 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 ?
> >
>
> The Makefile target dependencies are not ideal for a
> minimal-build-dependency build,
> but you should be able to workaround that by faking that the extracted api
> is already
> up-to-date step doing something like:
>
> touch api-viewer/apidata.js
> make index
>
> cheers,
> Thomas
>
>
Hello,

Here is an update on my process :

I always get this error when trying to "make index" :
make: *** No rule to make target
'/usr/share/javascript/proxmox-widget-toolkit-dev/APIViewer.js', needed by
'api-viewer/apidoc.js'.  Stop.

Following Thomas' suggestion, I tried to :
touch api-viewer/apidata.js
touch api-viewer/apiddoc.js

But it didn't change anything, so for the moment I edited the Makefile to
comment the "${API_VIEWER_SOURCES}" in the index.html entry, in order to
skip this part.

I then had errors for missing binaries :
rsvg-convert (provided by the librsvg2-bin Debian package)
a2x (provided by the asciidoc Debian package)

So I installed these packages on my desktop. I also wanted to install them
on my Proxmox server, but asciidoc depends on about 200 packages, and I
cannot install all this stuff on the production server. I guess I could
build a developement server, but it seems overkill for a small
documentation update.

On my desktop, I still get the PVE::RESTHandler error, but for a different
target now :

$ make index
./scan-adoc-refs *.adoc --depends .pve-doc-depends.tmp > link-refs.json.tmp
./scan-adoc-refs *.adoc --depends .pve-doc-depends.tmp > link-refs.json.tmp
PVE_GENERATING_DOCS=1 perl -I. ./gen-cpu-models.conf.5-opts.pl
>cpu-models.conf.5-opts.adoc.tmp
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 ./
gen-cpu-models.conf.5-opts.pl line 6.
BEGIN failed--compilation aborted at ./gen-cpu-models.conf.5-opts.pl line 6.
make: *** [pve-doc-generator.mk:23: cpu-models.conf.5-opts.adoc] Error 2

I think I'm going to write patches for the source files without checking
the compile output, it should be OK for small changes.

Best regards.

Sylvain