podtohtml - (DEPRECATED) convert POD documentation to HTML
THIS IS A DEPRECATED PROGRAM. See Pod::Simple::HTML instead. podtohtml [-bhqvIS] [-i index] [-d outdirectory] [-s sfx] <pods or directories of pods...>
THIS IS A DEPRECATED PROGRAM.
podtohtml converts POD documentation to HTML. It is based on the generic Pod::Parser. It works by making two passes over the selected pods, the fisrt pass uses Pod::Links to pre-scan for L<> links and =head1 NAME sections, and then a second to build a tree of HTML::Elements for each POD and calling the as_HTML method on the resulting tree.
podtohtml
=head1 NAME
as_HTML
The Generated HTML uses relative links.
The following command line options affect the behaviour:
Create broken links
The directory into which the HTML is written.
Run as quietly as possible
Verbose - print messages about files being processed.
Set the suffix for generated files. Default is '.html' for HTML files and '.ps' for PostScript files.
Build an index file in index.
Search perl's @INC for pods. Heuristics implemented in Pod::Find attempt to restrict search to files related to the version of perl executing the script.
@INC
Search directory that is specified in Config as install location of scripts for pods.
Config
Generate PostScript rather than HTML. This is done using HTML::FormatPS and font sizes etc. are not yet specifiable.
Print Data::Dumper dump of generated tree rather than generating HTML (for debugging).
podtohtml -I -S -d "/home/WWW/perl" -i "/home/WWW/perl/index.html"
That takes rather a long time (22 minutes on my 60MHz SPARCStation10).
podtohtml -d "/home/WWW/Tk8" -i /home/WWW/TkIndex.html ~/Tk8/pod
THIS IS A DEPRECATED PROGRAM. THESE BUGS WILL NOT BE FIXED.
Active links are only built for pods processed in the same invocation.
Large documents are not split.
HTML::FormatPS's style does not suit Nick's taste.
The index file needs more structure.
Pod::Simple::HTML
Nick Ing-Simmons <nick@ni-s.u-net.com>
To install Pod::Links, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Pod::Links
CPAN shell
perl -MCPAN -e shell install Pod::Links
For more information on module installation, please visit the detailed CPAN module installation guide.