Summary

Lift documents in nroff markups to XML-DocBook.

Lifting documents from presentation level to semantic level is hard, and a really good job requires human polishing. This tool aims to do everything that can be mechanized, and to preserve any troff-level information that might have structural implications in XML comments. This tool does the hard parts. TBL tables are translated into DocBook table markup, PIC into SVG, and EQN into MathML (relying on pic2svg and GNU eqn for the last two).

Resources


doclifter-2.18.md5source tarball MD5 checksum
doclifter-2.18.tar.gzgzipped source tarball
READMEroadmap file
COPYINGproject license
NEWSproject news
TODOto-do file
manlifter.htmlHTML rendering of manlifter.1
doclifter.htmlHTML rendering of doclifter.1

You can browse a report on manual-page bugs found by doclifter.

The project repository is at https://gitlab.com/esr/doclifter.

If you appreciate this code (and especially if you make money by using it) please support me on Patreon.

Recent Changes

  .in +4/.EX...EE/,in is bow translate structurally.
  Cope gracefully with dsome idiodsyncracies in OpenSSL library pages.
  Recognize new-style pod2man header.
  Ignore .Dd $Mdocdate$.  Authomatically lift 2-digit dates to 4 digits.
  Mwww fix to .MTO generation; also, ignore .LIBKSTYLE.
  In mm, interpret .DS/.DE as informal figure and .FG as a caption element.
  Process mdoc .Lk request.

Supporters

This work is funded by...

My Bronze supporters on Patreon: Martin Hohenberg, Jae Yang, Daniel Garber, Kyle Burkholder, Mike Nichols, Mark Ping, John D. Bell, Tom Taylor, Arnold F. Williams, George Brower, Michael Nygard, Brendan Long, Sven Dowideit, Dave Witten, Jonathan Cast, James Cronin, David L. Jessup, Christopher Chang, Killer Delicious, Jacob Lyles, Neil Anuskiewicz, Mordant, Clemens Ladisch, Wojciech Woytniak, Masa Bando, John Carmack, Xingyu Wang, Jane Tang.

My Institutional supporters on Patreon: Jason Azze and the DEVOPS team at his $DAYJOB.