Pod::Html(3) Perl Programmers Reference Guide Pod::Html(3)NAMEPod::Html - module to convert pod files to HTML
SYNOPSIS
use Pod::Html;
pod2html([options]);
DESCRIPTION
Converts files from pod format (see the perlpod manpage)
to HTML format. It can automatically generate indexes and
cross-references, and it keeps a cache of things it knows
how to cross-reference.
ARGUMENTSPod::Html takes the following arguments:
help
--help
Displays the usage message.
htmlroot
--htmlroot=name
Sets the base URL for the HTML files. When cross-
references are made, the HTML root is prepended to the
URL.
infile
--infile=name
Specify the pod file to convert. Input is taken from
STDIN if no infile is specified.
outfile
--outfile=name
Specify the HTML file to create. Output goes to
STDOUT if no outfile is specified.
podroot
--podroot=name
Specify the base directory for finding library pods.
podpath
--podpath=name:...:name
16/Sep/1999 perl 5.005, patch 03 1
Pod::Html(3) Perl Programmers Reference Guide Pod::Html(3)
Specify which subdirectories of the podroot contain
pod files whose HTML converted forms can be linked-to
in cross-references.
libpods
--libpods=name:...:name
List of page names (eg, "perlfunc") which contain
linkable =items.
netscape
--netscape
Use Netscape HTML directives when applicable.
nonetscape
--nonetscape
Do not use Netscape HTML directives (default).
index
--index
Generate an index at the top of the HTML file (default
behaviour).
noindex
--noindex
Do not generate an index at the top of the HTML file.
recurse
--recurse
Recurse into subdirectories specified in podpath
(default behaviour).
norecurse
--norecurse
Do not recurse into subdirectories specified in
podpath.
title
--title=title
16/Sep/1999 perl 5.005, patch 03 2
Pod::Html(3) Perl Programmers Reference Guide Pod::Html(3)
Specify the title of the resulting HTML file.
verbose
--verbose
Display progress messages.
EXAMPLE
pod2html("pod2html",
"--podpath=lib:ext:pod:vms",
"--podroot=/usr/src/perl",
"--htmlroot=/perl/nmanual",
"--libpods=perlfunc:perlguts:perlvar:perlrun:perlop",
"--recurse",
"--infile=foo.pod",
"--outfile=/perl/nmanual/foo.html");
AUTHOR
Tom Christiansen, <tchrist@perl.com>.
BUGS
Has trouble with etc in = commands.
SEE ALSO
the perlpod manpage
COPYRIGHT
This program is distributed under the Artistic License.
16/Sep/1999 perl 5.005, patch 03 3
Pod::Html(3) Perl Programmers Reference Guide Pod::Html(3)16/Sep/1999 perl 5.005, patch 03 4