The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

pod2cpanhtml - A utility to convert Pod to search.cpan.org style HTML.

SYNOPSIS

pod2cpanhtml [options] podfile [outfile]

    Options:
        --index    Generate a HTML index in output doc (the default).
        --help     Print a brief help message.
        --man      Print the full manpage.
        --version  Print the version of the program.
        --errata   Flag any Pod errors at the end of the doc (the default).

    Example:
        pod2cpanhtml SomeModule.pm > some_module.html

DESCRIPTION

This program is used for converting Pod documents to http://search.cpan.org/ style HTML.

Pod is Perl's Plain Old Documentation format, see perlpod.

The pod2cpanhtml utility produces HTML output similar to search.cpan.org by using the same conversion module, Pod::Simple::HTML and the same CSS, http://search.cpan.org/s/style.css.

It should be noted that this utility isn't the actual program used to create the HTML for seach.cpan.org. However, the output should visually be the same.

OPTIONS

podfile

The input file that contains the Pod file to be converted.

outfile

The converted output file in HTML format. Defaults to stdout if not specified.

--index or -i

Generate a HTML index in the output document. This is the default. To turn the index off use --no-index or -no-i.

--help or -h

Print a brief help message and exit.

--man or -m

Prints the manpage and exit.

--version or -v

Prints the version of the program.

--errata or -e

Generate a "Pod Errors" section at the end of the document if there are Pod errors. This is the default. To turn this feature off use --no-errata or -no-e. Equivalent to the Pod::Simple no_errata_section() method.

AUTHOR

John McNamara jmcnamara@cpan.org

COPYRIGHT

© MMIX, John McNamara.

All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 138:

Non-ASCII character seen before =encoding in '©'. Assuming CP1252