---
name: "pod2docbook"
section: "1p"
platform: "linux"
package: "libpod-2-docbook-perl"
version: "0.03-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pod2docbook"
---

# pod2docbook(1p)

Convert POD data to DocBook SGML

## 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