MAN page from Old RedHat 5.X perl-5.004-4.i386.rpm

Pod::Html

Section: Perl Programmers Reference Guide (3)
Updated: perl 5.004, patch 04
Index

NAME

Pod::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. Itcan automatically generate indexes and cross-references, and it keepsa cache of things it knows how to cross-reference.

ARGUMENTS

Pod::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 noinfile is specified.

outfile

    --outfile=name

Specify the HTML file to create. Output goes to STDOUT if no outfileis specified.

podroot

    --podroot=name

Specify the base directory for finding library pods.

podpath

    --podpath=name:...:name

Specify which subdirectories of the podroot contain pod files whoseHTML 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

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, <tchristAATTperl.com>.

BUGS

Has trouble with etc in = commands.

COPYRIGHT

This program is distributed under the Artistic License.

This document was created byman2html,using the manual pages.