pod2docbook1p
Convert pod data to docbook sgml
Usage
pod2docbook [--help]
[{--doctype=article | chapter | section | refentry}]
[--title=title]
[--spaces=#
spaces
per
indent
level]
[--fix-double-quotes]
[--no-header]
[--base-id=idstring]
[infile
[outfile]]
Overview
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
--doctypewill 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>)
Releases
7 releases since Debian 7 (Wheezy); the text changed 2 times.