docbook2man

Name

docbook2man --  convert DocBook documents to man pages

Synopsis

docbook2man [xml_document...] [--refentry-only] [--default-section=section] [--default-misc=miscinfo] [--default-date=date] [--default-manual=manualname]

Description

docbook2man converts XML DocBook documents to man pages.

If no files are specified, docbook2texi reads from standard input.

The result is written to standard output and/or to individual man pages in the current directory for any refentry content in the input document.

Options

--refentry-only

Content that is not part of a refentry will not be converted. (Thus, nothing is written to standard output.)

--default-section=section

The default man page section to use when the source document does not specify it (using refmeta /manvolnum markup). The default is 1.

--default-misc=miscinfo

The string to use for miscellaneous information (typically the source of the command or function), if not specified by the source document (using refmeta/ refmiscinfo).

--default-date=date

Sets date as the date to use for content that does not specify the date (using docinfo /date markup).

--default-manual=manualname

The string to use for the collective manual name on man pages.

Limitations

Always validate the input document. Although some docbook2X tools try to be resiliant against unrecognized markup, the behavior when encountering such markup is undefined.

The docbook2X tools do not support all of DocBook, or may produce wrong output or even die with markup that is claimed to be supported. These are bugs and you should nag the maintainer about them.

See Also

docbook2man-spec.pl
docbook2manxml