Import of mom
[s-roff.git] / MORE.STUFF
blob4428277be545ccc2cf079e7ab7215dfbb8d87438
1 More stuff for groff
2 ====================
4 win32
5 -----
7 Here two ports using the gcc compiler and other GNU tools:
9 . Cygwin:
11     http://sources.redhat.com/cygwin/
13   Look for a convenient mirror site in
15     http://sources.redhat.com/cygwin/mirrors.html
17   At any of this mirrors, groff can be found in the directory
18   latest/groff.
20 . Kees Zeelenberg <c.zeelenberg@hccnet.nl>:
22     http://gnuwin32.sourceforge.net/packages/groffl.htm
24   This port includes grap-1.10 and deroff-1.7.
26 dos
27 ---
29 Binaries for Eli Zaretskii's port using the djgpp compiler are available
30 from
32   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/gro*b.zip
34 and its mirrors; for installation details please read `arch/djgpp/README'.
35 This port also runs on win32 systems, except Win2K.
37 grap
38 ----
40 An implementation of Kernighan & Bentley's grap language for typesetting
41 graphs.  Written by Ted Faber <faber@lunabase.org>.  The actual version
42 can be found at
44   http://www.lunabase.org/~faber/Vault/software/grap/
46 A djgpp port which runs on dos and most win32 systems (Win95, Win98,
47 WinNT) done by Kees Zeelenberg <c.zeelenberg@hccnet.nl> is available from
49   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/
51 It is intended to be used with the djgpp port of groff.
53 A win32 port is included in the groff package available from
55     http://gnuwin32.sourceforge.net/
57 plot2dev
58 --------
60 This utility program can convert plot graphics to either pic or gremlin
61 files.  It has been written by Richard Murphey <richard-murphey@rice.edu>
62 and Daniel Senderowicz <daniel@synchrods.com> (who has added the gremlin
63 driver).  The actual version can be found as
65   ftp://ftp.ffii.org/pub/groff/plot2dev-x.x.tar.gz
67 troffcvt
68 --------
70 From the web page:
72   troffcvt is a translator that turns troff input into a form that can be
73   more easily processed.  The troffcvt distribution comes with
74   postprocessors that turn troffcvt into various destination formats such
75   as HTML (Hypertext Markup Language), RTF (Rich Text Format) or plain
76   text.
78 Note that you need a lot of additional packages to compile troffcvt;
79 everything is available from
81   http://www.primate.wisc.edu/software/troffcvt/
83 unroff
84 ------
86 From the README file:
88   Unroff is a Scheme-based, programmable, extensible troff translator with
89   a back-end for the Hypertext Markup Language.  Unroff is free software
90   and is distributed both as source and as precompiled binaries.
92     http://www.informatik.uni-bremen.de/~net/unroff/unroff.html
94 You need als Elk, the Scheme based Extension Language Kit, which is
95 available from
97   http://www.informatik.uni-bremen.de/~net/elk
99 deroff
100 ------
102 Deroff removes roff constructs from documents for the purpose of indexing,
103 spell checking etc.
105 Michael Haardt's <michael@moria.de> implementation is a little smarter
106 than traditional implementations, because it knows about certain -man and
107 -mm macros.  It is able to generate a word list for spell checking tools
108 or omit headers for sentence analysis tools.  It can further generate
109 cpp-style #line lines.
111   http://www.moria.de/deroff/
113 Version 1.6 compiled with DJGPP (for MS-DOS and all Win32 systems, i.e.
114 Win95, Win98, WinNT) is available from
116   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/
118 and its mirrors.
120 A win32 port of version 1.8 is available from
122   http://gnuwin32.sourceforge.net/
124 David Frey <dfrey@debian.org> has also written a deroff implementation
125 for Debian; it is available from
127   ftp://ftp.debian.org/debian/pool/main/d/deroff/
129 miscellaneous
130 -------------
132 . Ralph Corderoy's excellent page on troff:
134     www.troff.org
136   There are links for virtually everything related to troff.
138 . Dr. Robert Hermann's groff gems are available from
140     http://www.eas.slu.edu/People/RBHerrmann/GROFF/index.html
142   At present there are examples for
144   o creating business cards
145   o using groff to make large format posters for presentations
147 . Robert Marks's collection of useful macros and scripts is available from
149     http://www.agsm.edu.au/~bobm/odds+ends/scripts.html
151   Description:
153   o `polish': Is a sed (= the Unix stream editor) script that does many
154     things to ASCII text.  Amongst other things, it breaks lines at new
155     sentences, reduces upper-case acronyms by one point size, adds
156     diacriticals, changes simple quotes into smart quotes, and makes a few
157     simple grammar checks.  The best way to see what it does is to run it
158     as a sed script file (or files) on a text file and then compare the
159     output file with the original.
161   o `DropCaps' is a troff script which replaces the initial letters of
162     paragraphs immediately after H1 and H2 headings with drop-capitals of
163     specified point size, and automatically flows the text around the new
164     drop cap.
166   o `AJM Header' is a set of troff macros used in production of the
167     Australian Journal of Management.  They use the Memorandum Macros (mm)
168     of AT&T, and so should be invoked with the UNIX troff -mm flag; they
169     should also work with the GNU troff -mm flag.
171 . Thomas Baruchel <baruchel@libertysurf.fr> has developed Meta-tbl, a tbl
172   postprocessor to manipulate table cells (like adding gray shades).  The
173   latest version can be found at
175     http://perso.libertysurf.fr/baruchel/
177 documentation
178 -------------
180 Many documents related to the original versions of troff, ditroff, pic,
181 and others can be accessed from the following web pages:
183   http://www.cs.bell-labs.com/cm/cs/cstr.html
184   http://www.cs.bell-labs.com/cm/cs/papers.html