DragonFly On-Line Manual Pages

DOCBOOK2MDOC(1)        DragonFly General Commands Manual       DOCBOOK2MDOC(1)

NAME
     docbook2mdoc - Convert DocBook refentry to mdoc

SYNOPSIS
     docbook2mdoc [file]

DESCRIPTION
     The docbook2mdoc utility reads file and generates mdoc(7) from the
     <refentry> section of DocBook source, ignoring other sections.  If
     unspecified or -, file is taken to be standard input.  The arguments are
     as follows:

     -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 />.

EXIT STATUS
     The docbook2mdoc utility exits 0 on success, and >0 if an error occurs.

EXAMPLES
     To pipe a DocBook document foo.xml through mandoc(1) and a pager:

           % docbook2mdoc foo.xml | mandoc | more

SEE ALSO
     mandoc(1), mdoc(7)

AUTHORS
     docbook2mdoc was written by Kristaps Dzonsons, kristaps@bsd.lv.

CAVEATS
     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.

DragonFly 6.5-DEVELOPMENT       April 30, 2014       DragonFly 6.5-DEVELOPMENT