|
Pod::DocBook - module to convert pod files to DocBook SGML |
Pod::DocBook - module to convert pod files to DocBook SGML
use Pod::DocBook;
pod2docbook( [options] );
Converts files from pod format ( see the perlpod manpage ) to DocBook format. It can automatically generate indexes and cross-references, and it keeps a cache of things it knows how to cross-reference.
Pod::DocBook takes the following arguments:
--help
Displays the usage message.
--infile=name
Specify the pod file to convert. Input is taken from STDIN if no infile is specified.
--outfile=name
Specify the HTML file to create. Output goes to STDOUT if no outfile is specified.
--title=title
Specify the title of the resulting HTML file.
--no-header
Doesn't write a default header out for the DTD.
--no-footer
Doesn't write a default footer out for the DTD.
--root-id
Specifies the root identifier for the base element used in chapter and section tags. The default is pod2docbook-ch-1.
--verbose
Display progress messages.
pod2docbook( "pod2docbook", "--infile=foo.pod",
"--outfile=/perl/nmanual/foo.sgml" );
Alligator Descartes <descarte@arcana.co.uk> from the original the pod2html manpage 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.
Has trouble with etc in = commands.
Nested =over/=back lists are not supported within DocBook.
This program is distributed under the Artistic License.
|
Pod::DocBook - module to convert pod files to DocBook SGML |