NAME

       pod2docbook - Convert POD data to DocBook SGML

SYNOPSIS

       pod2docbook [--help] [--doctype=article|chapter|section|refentry] [--title=title]
       [--spaces=# spaces per indent level] [--fix-double-quotes] [--no-header] [--base-id=idstring]
       [infile [outfile]]

DESCRIPTION

       pod2docbook converts files from pod format (see perlpod) to DocBook 4.2 SGML (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.

OPTIONS AND ARGUMENTS

       [--help]
           Print usage and exit.

       [--doctype=article|chapter|section|refentry]
           Specifies the document type for the output file; the default is section.

       [--title=title]
           Specifies the document title.  The default is infile, if it is supplied, or empty string otherwise.

       [--spaces=# spaces per indent level]
           Specifies the number of spaces per indent level in the SGML output; the default is 2.

       [--fix-double-quotes]
           Replace  pairs  of double quotes in regular paragraphs with <quote> and </quote> (see Pod::2::DocBook
           for details).

       [--no-header]
           Omit the DOCTYPE line from the output.

       infile
           The name of the file from which to read pod source; if not supplied, STDIN is used for input.

       outfile
           The name of the file to which to write SGML; if not supplied, STDOUT is used for output.

       [--base-id=idstring]
           The root element of the --doctype will have the idstring set for attribute id.   The  default  is  an
           input  file name "cleaned up" to conform with XML restriction for characteds used in id strings. (SEE
           <http://www.w3.org/TR/2000/REC-xml-20001006#NT-Name>)

SEE ALSO

       pod2docbook,  perlpod,   Pod::DocBook,   SVN   repo   -   <https://cle.sk/repos/pub/cpan/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>

AUTHOR

       Alligator  Descartes  <descarte@symbolstone.org>  wrote  a module called Pod::2::DocBook, which was later
       maintained by Jan Iven <jan.iven@cern.ch>.  That module  was  based  on  the  original  pod2html  by  Tom
       Christiansen <tchrist@mox.perl.com>.

       Nandu  Shah <nandu@zvolve.com> 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/>)

       Jozef Kutej <jkutej@cpan.org> renamed the module to Pod::2::DocBook because Nandus version was buried  in
       the CPAN archive as an "UNAUTHORIZED RELEASE".

COPYRIGHT

       Copyright 2004, Nandu Shah <nandu@zvolve.com>

       Copyright 2008, Jozef Kutej <jkutej@cpan.org>

       This  library  is  free  software;  you may redistribute it and/or modify it under the same terms as Perl
       itself

perl v5.30.0                                       2020-05-17                                    POD2DOCBOOK(1p)