Back to Eric's Home Page | Up to Site Map | $Date: 2001/11/08 03:55:48 $ |
doclifter translates documents written in troff macros to DocBook. This is an alpha release -- working and documented, but with some rough edges. You can read an HTML version of the man page to find out what it does.
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 SGML comments.
This tool does some of the hard parts, but not all. TBL tables are translated into DocBook table markup, but EQN and PIC are not translated (yet).
Test loads are included in the distribution. The code has been tested in about the most brutal possible way; it has been run against every single man page in Section 1 of a full installation of Red Hat 7.1. It generates valid DocBook from over 95% of those pages.
doclifter was written under Python 2.2a1. It will not work under Python 1.5.2, and may not work under 2.1. Upgrade, it will be good for you.
You can download the current doclifter distribution here.
Back to Eric's Home Page | Up to Site Map | $Date: 2001/11/08 03:55:48 $ |