.\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
.\" ========================================================================
.de Sh \" Subsection heading
.de Sp \" Vertical space (when we can't use .PP)
.de Vb \" Begin verbatim text
.de Ve \" End verbatim text
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. | will give a
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
. tm Index:\\$1\t\\n%\t"\\$2"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. \" simple accents for nroff and troff
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
.\" ========================================================================
.TH Pod::Html 3 "2002-06-01" "perl v5.8.0" "Perl Programmers Reference Guide"
Pod::Html \- module to convert pod files to HTML
Converts files from pod format (see perlpod) to \s-1HTML\s0 format. It
can automatically generate indexes and cross\-references, and it keeps
a cache of things it knows how to cross\-reference.
Pod::Html takes the following arguments:
\& --backlink="Back to Top"
Adds \*(L"Back to Top\*(R" links in front of every \f(CW\*(C`head1\*(C'\fR heading (except for
the first). By default, no backlinks are generated.
Creates the item and directory caches in the given directory.
Specify the \s-1URL\s0 of a cascading style sheet. Also disables all \s-1HTML/CSS\s0
\&\f(CW\*(C`style\*(C'\fR attributes that are output by default (to avoid conflicts).
Flushes the item and directory caches.
Creates header and footer blocks containing the text of the \f(CW\*(C`NAME\*(C'\fR
section. By default, no headers are generated.
Displays the usage message.
Sets the directory in which the resulting \s-1HTML\s0 file is placed. This
is used to generate relative links to other files. Not passing this
causes all links to be absolute, since this is the value that tells
Pod::Html the root of the documentation tree.
Sets the base \s-1URL\s0 for the \s-1HTML\s0 files. When cross-references are made,
the \s-1HTML\s0 root is prepended to the \s-1URL\s0.
Generate an index at the top of the \s-1HTML\s0 file. This is the default
Specify the pod file to convert. Input is taken from \s-1STDIN\s0 if no
\& --libpods=name:...:name
List of page names (eg, \*(L"perlfunc\*(R") which contain linkable \f(CW\*(C`=item\*(C'\fRs.
\&\fBDeprecated\fR, has no effect. For backwards compatibility only.
Specify the \s-1HTML\s0 file to create. Output goes to \s-1STDOUT\s0 if no outfile
\& --podpath=name:...:name
Specify which subdirectories of the podroot contain pod files whose
\&\s-1HTML\s0 converted forms can be linked to in cross references.
Specify the base directory for finding library pods.
Don't display \fImostly harmless\fR warning messages. These messages
will be displayed by default. But this is not the same as \f(CW\*(C`verbose\*(C'\fR
Recurse into subdirectories specified in podpath (default behaviour).
Specify the title of the resulting \s-1HTML\s0 file.
Display progress messages. By default, they won't be displayed.
\& "--podpath=lib:ext:pod:vms",
\& "--podroot=/usr/src/perl",
\& "--htmlroot=/perl/nmanual",
\& "--libpods=perlfunc:perlguts:perlvar:perlrun:perlop",
\& "--outfile=/perl/nmanual/foo.html");
Uses \f(CW$Config{pod2html}\fR to setup default options.
Tom Christiansen, <tchrist@perl.com>.
This program is distributed under the Artistic License.