


Pod::Html(3p)    Perl Programmers Reference Guide   Pod::Html(3p)


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.  It can automatically generate indexes and
       cross-references, and it keeps a 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 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



29/Apr/1999            perl 5.005, patch 03                     1





Pod::Html(3p)    Perl Programmers Reference Guide   Pod::Html(3p)


           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




29/Apr/1999            perl 5.005, patch 03                     2





Pod::Html(3p)    Perl Programmers Reference Guide   Pod::Html(3p)


           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.



























29/Apr/1999            perl 5.005, patch 03                     3





Pod::Html(3p)    Perl Programmers Reference Guide   Pod::Html(3p)



























































29/Apr/1999            perl 5.005, patch 03                     4


