fix typo which prevents compilation with picky compilers
[s-roff.git] / MORE.STUFF
blobc8c22cc8fc5efe98aec9579a02a64dff3190b906
1 More stuff for groff
2 ====================
4 Windows 32
5 ----------
7 Here are 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 those 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 recent versions of grap and deroff.
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 Windows 32 systems, except Windows 2000.
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 Windows 32 systems (Windows 95,
47 Windows 98, Windows NT) done by Kees Zeelenberg <c.zeelenberg@hccnet.nl>
48 is available from
50   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/
52 It is intended to be used with the djgpp port of groff.
54 A Windows 32 port is included in the groff package available from
56     http://gnuwin32.sourceforge.net/
58 plot2dev
59 --------
61 This utility program can convert plot graphics to either pic or gremlin
62 files.  It has been written by Richard Murphey <richard-murphey@rice.edu>
63 and Daniel Senderowicz <daniel@synchrods.com> (who has added the gremlin
64 driver).  The actual version can be found as
66   ftp://ftp.ffii.org/pub/groff/plot2dev-x.x.tar.gz
68 troffcvt
69 --------
71 From the web page:
73   troffcvt is a translator that turns troff input into a form that can be
74   more easily processed.  The troffcvt distribution comes with
75   postprocessors that turn troffcvt into various destination formats such
76   as HTML (Hypertext Markup Language), RTF (Rich Text Format) or plain
77   text.
79 Note that you need a lot of additional packages to compile troffcvt;
80 everything is available from
82   http://www.primate.wisc.edu/software/troffcvt/
84 unroff
85 ------
87 From the README file:
89   Unroff is a Scheme-based, programmable, extensible troff translator with
90   a back-end for the Hypertext Markup Language.  Unroff is free software
91   and is distributed both as source and as precompiled binaries.
93     http://www.informatik.uni-bremen.de/~net/unroff/unroff.html
95 You need als Elk, the Scheme based Extension Language Kit, which is
96 available from
98   http://www.informatik.uni-bremen.de/~net/elk
100 deroff
101 ------
103 Deroff removes roff constructs from documents for the purpose of indexing,
104 spell checking etc.
106 Michael Haardt's <michael@moria.de> implementation is a little smarter
107 than traditional implementations, because it knows about certain -man and
108 -mm macros.  It is able to generate a word list for spell checking tools
109 or omit headers for sentence analysis tools.  It can further generate
110 cpp-style #line lines.
112   http://www.moria.de/deroff/
114 Version 1.6 compiled with DJGPP (for MS-DOS and all Windows 32 systems,
115 i.e. Windows 95, Windows 98, Windows NT) is available from
117   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/
119 and its mirrors.
121 A Windows 32 port of version 1.8 is available from
123   http://gnuwin32.sourceforge.net/
125 David Frey <dfrey@debian.org> has also written a deroff implementation
126 for Debian; it is available from
128   ftp://ftp.debian.org/debian/pool/main/d/deroff/
130 doclifter
131 ---------
133 doclifter lifts troff macro markup to XML-Docbook.  It doesn't do raw troff
134 at all well (raw troff has insufficient structural information) but it 
135 handles manual pages, ms, mm, and me markup, producing clean lifts
136 to valid XML more than 96% of the time.  pic markup is translated to SVG,
137 eqn markup to Presentation MathML.
139 doclifter with the -w option behaves as a portability checker and validator,
140 warning about constructs that aren't portable across *roff implementations
141 and viewers.
143 It is available from
145   http://catb.org/~esr/doclifter
147 pic2plot
148 --------
150 pic2plot, part of the GNU plotutils package, can lift pic markup to SVG.
151 The plotutils package is available at
153   http://www.gnu.org/software/plotutils/
155 miscellaneous
156 -------------
158 . Ralph Corderoy's excellent page on troff:
160     www.troff.org
162   There are links for virtually everything related to troff.
164 . Dr. Robert Hermann's groff gems are available from
166     http://www.eas.slu.edu/People/RBHerrmann/GROFF/index.html
168   At present there are examples for
170   o creating business cards
171   o using groff to make large format posters for presentations
173 . Robert Marks's collection of useful macros and scripts is available from
175     http://www.agsm.edu.au/~bobm/odds+ends/scripts.html
177   Description:
179   o `polish': Is a sed (= the Unix stream editor) script that does many
180     things to ASCII text.  Amongst other things, it breaks lines at new
181     sentences, reduces upper-case acronyms by one point size, adds
182     diacriticals, changes simple quotes into smart quotes, and makes a few
183     simple grammar checks.  The best way to see what it does is to run it
184     as a sed script file (or files) on a text file and then compare the
185     output file with the original.
187   o `DropCaps' is a troff script which replaces the initial letters of
188     paragraphs immediately after H1 and H2 headings with drop-capitals of
189     specified point size, and automatically flows the text around the new
190     drop cap.
192   o `AJM Header' is a set of troff macros used in production of the
193     Australian Journal of Management.  They use the Memorandum Macros (mm)
194     of AT&T, and so should be invoked with the UNIX troff -mm flag; they
195     should also work with the GNU troff -mm flag.
197 . Thomas Baruchel <baruchel@libertysurf.fr> has developed Meta-tbl, a tbl
198   postprocessor to manipulate table cells (like adding gray shades).  The
199   latest version can be found at
201     http://perso.libertysurf.fr/baruchel/
203 . gpresent, written by Bob Diertens <bobd@science.uva.nl>.  From the README
204   file:
206     gpresent is a package for making presentation with groff and acroread.
207     It consist of a set of macros to be used with groff and a post-processor
208     for manipulating the PostScript output of groff.  Without the use of the
209     PAUSE macro, it can also be used for making slides.
210     
211   It is available from
213     www.science.uva.nl/~bobd/useful/gpresent/
216 documentation
217 -------------
219 Many documents related to the original versions of troff, ditroff, pic,
220 and others can be accessed from the following web pages:
222   http://www.cs.bell-labs.com/cm/cs/cstr.html
223   http://www.cs.bell-labs.com/cm/cs/papers.html