The docbook2mdoc utility is a converter from DocBook into DocBook V4.x and v5.x XML into mdoc. Unlike most DocBook utilities, it's a standalone ISC-licensed ISO C utility @@ -43,20 +44,24 @@ 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 Kristaps 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.