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>] [--ignore=<name>,...,<name>] [--verbose]
installhtml converts a collection of POD pages to a corresponding collection of HTML pages. This is used to convert the pod pages found in the perl distribution. (It is not intended as a general-purpose converter/installer of POD pages in HTML format. See Pod::Html.)
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, a separate program in the Perl 5 core distribution, 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 of files that shouldn't be installed, given relative to podroot.
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 \ --recurse \ --verbose
Chris Hall <hallc@cs.colorado.edu>
To install less, copy and paste the appropriate command in to your terminal.
cpanm
cpanm less
CPAN shell
perl -MCPAN -e shell install less
For more information on module installation, please visit the detailed CPAN module installation guide.