The docbook2mdoc utility is a converter from DocBook into mdoc.
+ href="http://www.oasis-open.org/docbook/">DocBook V4.x and v5.x XML into mdoc.
Unlike most DocBook utilities, it's a standalone ISC-licensed ISO C utility
that should compile on any modern UNIX system.
- The only requirement is libexpat (for parsing XML), which is
- installed by default on most systems.
- docbook2mdoc is very experimental: it probably won't work with your manual
- without improvement.
- However, it does work with the DocBook reference manuals (minimally rendered here with mandoc -Thtml): printf, ls, as, iovec.
+ docbook2mdoc is experimental: it still has many missing elements.
+ However, it works with the DocBook reference examples and documents found in the wild.
+ Contact the developers with questions or missing nodes; or better yet, download
+ the source and add new elements yourself as described in the README.
+
+ New in version @VERSION@...
+
- Contact Kristaps with questions, but please make sure any formatting issue
- hasn't already been covered in the manual.
+ Now supports most tags as found in the OpenGL DocBook corpus.
+ The main missing elements are <inlineequation> and <informalequation>,
+ although a few others (<footnote> et al.) are in there too.
+ The DocBook is also malformed in some areas—improper parenting.