Building the pkg-perl HTML manual with Sphinx
=============================================

You need to install the following packages:

    apt-get install \
        python3-sphinx python3-sphinx-rtd-theme \
        texlive-latex-base texlive-generic-extra \
        texlive-latex-recommended texlive-fonts-recommended \
        texlive-latex-extra libpod-pom-view-restructured-perl

Then convert the POD files to rST:

    make rst

Build HTML pages locally:

    make html

And publish them on alioth:

    make rsync

Only the pages listed in the index.rst file will be used to build
the manual. Please, add any other files you'd like to see too.

Note that the Makefile was autogenerated by Sphinx, with no other
modifications. The conf.py was also generated but was modified to
accommodate pkg-perl.