Clarify what new code should not cast unused
[dragonfly.git] / contrib / groff / MORE.STUFF
1 More stuff for groff
2 ====================
3
4 win32
5 -----
6
7 Here two ports using the gcc compiler and other GNU tools:
8
9 . Cygwin:
10
11     http://sources.redhat.com/cygwin/
12
13   Look for a convenient mirror site in
14
15     http://sources.redhat.com/cygwin/mirrors.html
16
17   At any of those mirrors, groff can be found in the directory
18   latest/groff.
19
20 . Kees Zeelenberg <c.zeelenberg@hccnet.nl>:
21
22     http://gnuwin32.sourceforge.net/packages/groffl.htm
23
24   This port includes recent versions of grap and deroff.
25
26 dos
27 ---
28
29 Binaries for Eli Zaretskii's port using the djgpp compiler are available
30 from
31
32   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/gro*b.zip
33
34 and its mirrors; for installation details please read `arch/djgpp/README'.
35 This port also runs on win32 systems, except Win2K.
36
37 grap
38 ----
39
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
43
44   http://www.lunabase.org/~faber/Vault/software/grap/
45
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
48
49   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/
50
51 It is intended to be used with the djgpp port of groff.
52
53 A win32 port is included in the groff package available from
54
55     http://gnuwin32.sourceforge.net/
56
57 plot2dev
58 --------
59
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
64
65   ftp://ftp.ffii.org/pub/groff/plot2dev-x.x.tar.gz
66
67 troffcvt
68 --------
69
70 From the web page:
71
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.
77
78 Note that you need a lot of additional packages to compile troffcvt;
79 everything is available from
80
81   http://www.primate.wisc.edu/software/troffcvt/
82
83 unroff
84 ------
85
86 From the README file:
87
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.
91
92     http://www.informatik.uni-bremen.de/~net/unroff/unroff.html
93
94 You need als Elk, the Scheme based Extension Language Kit, which is
95 available from
96
97   http://www.informatik.uni-bremen.de/~net/elk
98
99 deroff
100 ------
101
102 Deroff removes roff constructs from documents for the purpose of indexing,
103 spell checking etc.
104
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.
110
111   http://www.moria.de/deroff/
112
113 Version 1.6 compiled with DJGPP (for MS-DOS and all Win32 systems, i.e.
114 Win95, Win98, WinNT) is available from
115
116   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/
117
118 and its mirrors.
119
120 A win32 port of version 1.8 is available from
121
122   http://gnuwin32.sourceforge.net/
123
124 David Frey <dfrey@debian.org> has also written a deroff implementation
125 for Debian; it is available from
126
127   ftp://ftp.debian.org/debian/pool/main/d/deroff/
128
129 miscellaneous
130 -------------
131
132 . Ralph Corderoy's excellent page on troff:
133
134     www.troff.org
135
136   There are links for virtually everything related to troff.
137
138 . Dr. Robert Hermann's groff gems are available from
139
140     http://www.eas.slu.edu/People/RBHerrmann/GROFF/index.html
141
142   At present there are examples for
143
144   o creating business cards
145   o using groff to make large format posters for presentations
146
147 . Robert Marks's collection of useful macros and scripts is available from
148
149     http://www.agsm.edu.au/~bobm/odds+ends/scripts.html
150
151   Description:
152
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.
160
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.
165
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.
170
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
174
175     http://perso.libertysurf.fr/baruchel/
176
177 . gpresent, written by Bob Diertens <bobd@science.uva.nl>.  From the README
178   file:
179
180     gpresent is a package for making presentation with groff and acroread.
181     It consist of a set of macros to be used with groff and a post-processor
182     for manipulating the PostScript output of groff.  Without the use of the
183     PAUSE macro, it can also be used for making slides.
184     
185   It is available from
186
187     www.science.uva.nl/~bobd/useful/gpresent/
188
189
190 documentation
191 -------------
192
193 Many documents related to the original versions of troff, ditroff, pic,
194 and others can be accessed from the following web pages:
195
196   http://www.cs.bell-labs.com/cm/cs/cstr.html
197   http://www.cs.bell-labs.com/cm/cs/papers.html