|-W||Output non-fatal warning messages.|
docbook2mdoc supports only well-formed XML DocBook V4.x until V5.1. Some earlier DocBook constructs are accepted as well. SGML DocBook documents may be parsed unless they contain SGML-specific constructs, such as empty end tags </>. The only non-DocBook construct recognised (and discarded) is <xi:include />.
To pipe a DocBook document foo.xml through mandoc(1) and a pager:
% docbook2mdoc foo.xml | mandoc | more
docbook2mdoc was written by Kristaps Dzonsons,
.Mt email@example.com .
The docbook2mdoc utility is experimental. As such, only a modest subset of the <refentry> domain is accepted.
The output mdoc(7) could be much nicer: trailing spaces, superfluous space removal, new-line new-sentence, and other niceties are not used.