NAME

Pod::DocBook - module to convert pod files to DocBook SGML

SYNOPSIS

    use Pod::DocBook;
    pod2docbook( [options] );

DESCRIPTION

Converts files from pod format ( see perlpod ) to DocBook format. It can automatically generate indexes and cross-references, and it keeps a cache of things it knows how to cross-reference.

ARGUMENTS

Pod::DocBook takes the following arguments:

help

    --help

Displays the usage message.

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.

title

    --title=title

Specify the title of the resulting HTML file.

no-header

    --no-header

Doesn't write a default header out for the DTD.

no-footer

    --no-footer

Doesn't write a default footer out for the DTD.

root-id

    --root-id

Specifies the root identifier for the base element used in chapter and section tags. The default is pod2docbook-ch-1.

verbose

    --verbose

Display progress messages.

EXAMPLE

    pod2docbook( "pod2docbook", "--infile=foo.pod", 
                 "--outfile=/perl/nmanual/foo.sgml" );

AUTHOR

Alligator Descartes <descarte@arcana.co.uk> from the original pod2html source code by Tom Christiansen, <tchrist@perl.com>, for it is he. Many thanks to Chris Maden of O'Reilly & Associations for doing serious road-testing on this module.

BUGS

Has trouble with etc in = commands.

LIMITATIONS

Nested =over/=back lists are not supported within DocBook.

SEE ALSO

perlpod

COPYRIGHT

This program is distributed under the Artistic License.