* doc/groff.texinfo: Add documentation of remaining escapes.
[s-roff.git] / MORE.STUFF
bloba35ea9721ade5320a9633e2fda0a3c114819c643
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.7 is available from
122   http://gnuwin32.sourceforge.net/
124 miscellaneous
125 -------------
127 . Dr. Robert Hermann's groff gems are available from
129     http://www.eas.slu.edu/People/RBHerrmann/GROFF/index.html
131   At present there are examples for
133   o creating business cards
134   o using groff to make large format posters for presentations
136 . Robert Marks's collection of useful macros and scripts is available from
138     http://www.agsm.edu.au/~bobm/odds+ends/scripts.html
140   Description:
142   o `polish': Is a sed (= the Unix stream editor) script that does many
143     things to ASCII text.  Amongst other things, it breaks lines at new
144     sentences, reduces upper-case acronyms by one point size, adds
145     diacriticals, changes simple quotes into smart quotes, and makes a few
146     simple grammar checks.  The best way to see what it does is to run it
147     as a sed script file (or files) on a text file and then compare the
148     output file with the original.
150   o `DropCaps' is a troff script which replaces the initial letters of
151     paragraphs immediately after H1 and H2 headings with drop-capitals of
152     specified point size, and automatically flows the text around the new
153     drop cap.
155   o `AJM Header' is a set of troff macros used in production of the
156     Australian Journal of Management.  They use the Memorandum Macros (mm)
157     of AT&T, and so should be invoked with the UNIX troff -mm flag; they
158     should also work with the GNU troff -mm flag.
160 . Thomas Baruchel <baruchel@libertysurf.fr> has developed Meta-tbl, a tbl
161   postprocessor to manipulate table cells (like adding gray shades).  The
162   latest version can be found at
164     http://perso.libertysurf.fr/baruchel/
166 documentation
167 -------------
169 Many documents related to the original versions of troff, ditroff, pic,
170 and others can be accessed from the following web pages:
172   http://www.cs.bell-labs.com/cm/cs/cstr.html
173   http://www.cs.bell-labs.com/cm/cs/papers.html