summaryrefslogtreecommitdiff
path: root/textproc/doclifter/DESCR
diff options
context:
space:
mode:
authorrecht <recht@pkgsrc.org>2004-01-17 01:07:14 +0000
committerrecht <recht@pkgsrc.org>2004-01-17 01:07:14 +0000
commit3077f64e4a8b180d3f92355e1d6cae04c95d2929 (patch)
tree2f441f5c108c525477e564422595ba16ff0e4393 /textproc/doclifter/DESCR
parent23dc291ab165b60915d3d3d0329c253d65e85321 (diff)
downloadpkgsrc-3077f64e4a8b180d3f92355e1d6cae04c95d2929.tar.gz
initial import of doclifter 1.6
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 most of the hard parts, but not all. TBL tables diagrams are translated into DocBook table markup and and PIC into SVG, but EQN is not translated. 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 all sections of a full installation of Red Hat 9 with Fedore Core 1 updates. It lifts 96% of 9836 pages without requiring any hand-hacking required.
Diffstat (limited to 'textproc/doclifter/DESCR')
-rw-r--r--textproc/doclifter/DESCR15
1 files changed, 15 insertions, 0 deletions
diff --git a/textproc/doclifter/DESCR b/textproc/doclifter/DESCR
new file mode 100644
index 00000000000..71d29e544dd
--- /dev/null
+++ b/textproc/doclifter/DESCR
@@ -0,0 +1,15 @@
+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 most of the hard parts, but not all. TBL tables diagrams are
+translated into DocBook table markup and and PIC into SVG, but EQN is not
+translated.
+
+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 all sections of a full installation of Red Hat 9 with Fedore Core 1 updates.
+It lifts 96% of 9836 pages without requiring any hand-hacking required.