installhtml - converts a collection of POD pages to HTML format.
installhtml [--help] [--podpath=<name>:...:<name>] [--podroot=<name>] [--htmldir=<name>] [--htmlroot=<name>] [--norecurse] [--recurse] [--splithead=<name>,...,<name>] [--splititem=<name>,...,<name>] [--libpods=<name>,...,<name>] [--verbose]
installhtml converts a collection of POD pages to a corresponding collection of HTML pages. This is primarily used to convert the pod pages found in the perl distribution.
Displays the usage.
The base directory to search for all .pod and .pm files to be converted. Default is current directory.
The list of directories to search for .pod and .pm files to be converted. Default is `podroot/.'.
Whether or not to convert all .pm and .pod files found in subdirectories too. Default is to not recurse.
The base directory which all HTML files will be written to. This should be a path relative to the filesystem, not the resulting URL.
The base directory which all resulting HTML files will be visible at in a URL. The default is `/'.
Comma-separated list of pod files to split by the =head directive. The .pod suffix is optional. These files should have names specified relative to podroot.
Comma-separated list of all pod files to split by the =item directive. The .pod suffix is optional. installhtml does not do the actual split, rather it invokes splitpod to do the dirty work. As with --splithead, these files should have names specified relative to podroot.
The directory containing the splitpod program. The default is `podroot/pod'.
Comma-separated list of "library" pod files. This is the same list that will be passed to pod2html when any pod is converted.
Self-explanatory.
The following command-line is an example of the one we use to convert perl documentation:
./installhtml --podpath=lib:ext:pod:vms \ --podroot=/usr/src/perl \ --htmldir=/perl/nmanual \ --htmlroot=/perl/nmanual \ --splithead=pod/perlipc \ --splititem=pod/perlfunc \ --libpods=perlfunc,perlguts,perlvar,perlrun,perlop \ --recurse \ --verbose
Chris Hall <hallc@cs.colorado.edu>
To install lib, copy and paste the appropriate command in to your terminal.
cpanm
cpanm lib
CPAN shell
perl -MCPAN -e shell install lib
For more information on module installation, please visit the detailed CPAN module installation guide.