doclifter

doclifter

Lift documents in {n,t}roff markups to XML-DocBook.

Name Last Update
tests Loading commit data...
.gitignore Loading commit data...
.shipper Loading commit data...
COPYING Loading commit data...
Makefile Loading commit data...
NEWS Loading commit data...
PATCHES Loading commit data...
README Loading commit data...
TODO Loading commit data...
buglist.py Loading commit data...
c_parse.py Loading commit data...
clonepatch Loading commit data...
control Loading commit data...
doclifter Loading commit data...
doclifter-logo.png Loading commit data...
doclifter.el Loading commit data...
doclifter.xml Loading commit data...
man_page_howto.xml Loading commit data...
manlifter Loading commit data...
manlifter.xml Loading commit data...
problemgen.py Loading commit data...
repatch Loading commit data...
shipmail.py Loading commit data...
			doclifter

The doclifter program translates documents written in troff macros to 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).

Install by doing, "make install". To install to a prefix other than
the default (/usr), set a PREFIX environment variable
e.g. "PREFIX=/usr/local make -e install"

Test loads are included in the distribution; do "make check" to run
the regression tests.  The code has been live tested in about the most
brutal possible way; it has been run against every single man page in
all sections of a desktop Ubuntu installation.  It lifts over 93% of
these pages without requiring any hand-hacking.

There is a detailed change log in the NEWS file.