back to the main mandoc site

docbook2mdoc — DocBook to mdoc converter — current version 1.1.0 (May 2, 2019)

The DocBook to mdoc converter

The docbook2mdoc utility is a converter from DocBook version 4.x and 5.x XML to mdoc. Unlike most DocBook utilities, it's a standalone ISC-licensed ISO C utility with no external dependencies that should compile on any modern UNIX system.

docbook2mdoc is no longer experimental, but many features are likely to still be missing, and the rendering of many elements is not ideal yet. However, it can already be used for production purposes and was tested on parts of the OpenGL and X.Org DocBook corpuses.

News

May 2, 2019: Version 1.1.0 was released with a new -s command line option, large numbers of improvements to whitespace handling, and some minor improvements.
April 29, 2019: Version 1.0.2 was released with new parsing and formatting support for <abstract> and <reference> and internal framework improvents, in particular for creating, editing, and moving nodes.
April 24, 2019: Version 1.0.1 was released featuring support for file inclusion via "<!ENTITY %", decimal character entities, and several formatting improvements and bugfixes.
April 17, 2019: Version 1.0.0 was released with lots of new features and a major overhaul of the internal code structure. The former dependency on the expat library was removed.

Documentation and help

The docbook2mdoc(1) manual page explains how to use the utility.
Release notes — ChangeLog
The README file explains how to add missing elements.
Contact the docbook2mdoc developers, for example for bug reports or for questions.

Availability and installation

Newest release tarball
Archive of release tarballs
CVS web interface
Anonymous CVS access (module docbook2mdoc)