Convert pod data to docbook sgml
pod2docbook [--help] [--doctype=article|chapter|section|refentry] [--title=title] [--spaces=# spaces per indent level] [--fix-double-quotes] [--no-header] [--base-id=idstring] [infile [outfile]]
pod2docbook converts files from pod format (see perlpod) to DocBook 4.2 \s-1SGML\s0 (see <http://www.docbook.org/>). The program itself is merely a driver for the Pod::2::DocBook class; if you're interested in details of pod-to-SGML translation see Pod::2::DocBook.
Print usage and exit.
Specifies the document type for the output file; the default is section.
Specifies the document title. The default is infile, if it is supplied, or empty string otherwise.
Specifies the number of spaces per indent level in the \s-1SGML\s0 output; the default is 2.
Replace pairs of double quotes in regular paragraphs with <quote> and </quote> (see Pod::2::DocBook for details).
Omit the \s-1DOCTYPE\s0 line from the output.
The name of the file from which to read pod source; if not supplied, \s-1STDIN\s0 is used for input.
The name of the file to which to write \s-1SGML\s0; if not supplied, \s-1STDOUT\s0 is used for output.
The root element of the --doctype will have the idstring set for attribute id. The default is an input file name \*(L"cleaned up\*(R" to conform with \s-1XML\s0 restriction for characteds used in id strings. (\s-1SEE\s0 http://www.w3.org/TR/2000/REC-xml-20001006#NT-Name <http://www.w3.org/TR/2000/REC-xml-20001006#NT-Name>)
pod2docbook, perlpod, Pod::DocBook, \s-1SVN\s0 repo - https://cle.sk/repos/pub/cpan/Pod-2-DocBook/ <https://cle.sk/repos/pub/cpan/Pod-2-DocBook/>, http://www.ohloh.net/projects/pod-2-docbook <http://www.ohloh.net/projects/pod-2-docbook>, doc/ + examples/pod2docbook-docbook/ for Pod::2::DocBook DocBook documentation
DocBook related links: <http://www.docbook.org/>, <http://www.sagehill.net/docbookxsl/>, http://developers.cogentrts.com/cogent/prepdoc/pd-axfrequentlyuseddocbooktags.html <http://developers.cogentrts.com/cogent/prepdoc/pd-axfrequentlyuseddocbooktags.html>
Alligator Descartes <[email protected]> wrote a module called Pod::2::DocBook, which was later maintained by Jan Iven <[email protected]>. That module was based on the original pod2html by Tom Christiansen <[email protected]>.
Nandu Shah <[email protected]> wrote Pod::DocBook, which is unrelated to the previous module (even though they both perform the same function). (http://search.cpan.org/~nandu/Pod-DocBook-1.2/ <http://search.cpan.org/~nandu/Pod-DocBook-1.2/>)
Jozef Kutej <[email protected]> renamed the module to Pod::2::DocBook because Nandus version was buried in the \s-1CPAN\s0 archive as an \*(L"\s-1UNAUTHORIZED\s0 \s-1RELEASE\s0\*(R".
Copyright 2004, Nandu Shah <[email protected]>
Copyright 2008, Jozef Kutej <[email protected]>
This library is free software; you may redistribute it and/or modify it under the same terms as Perl itself