docbook2X converts DocBook to man pages in two steps:
The DocBook source is converted by a stylesheet into an intermediate XML format, Man-XML.
Man-XML is simpler than DocBook and closer to the man page format; it is intended to make the stylesheets’ job easier.
The stylesheet for this purpose is in xslt/man/docbook.xsl
. For portability, it should
always be referred to by the following URI:
http://docbook2x.sourceforge.net/latest/xslt/man/docbook.xsl
Run this stylesheet with db2x_xsltproc.
Man-XML is converted to the actual man pages by db2x_manxml.
The docbook2man command does both steps automatically, but if any problems occur, you can see the errors more clearly if you do each step separately:
$
db2x_xsltproc -s man
mydoc
.xml -omydoc
.mxml$
db2x_manxml
mydoc
.mxml