Sync usage with man page.
[netbsd-mini2440.git] / gnu / dist / groff / MORE.STUFF
blobb1c18f744b5d4f91b2acbf14d9120d4412698d3f
1 More stuff for groff
2 ====================
4 Windows 32
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 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 miscellaneous
131 -------------
133 . Ralph Corderoy's excellent page on troff:
135     www.troff.org
137   There are links for virtually everything related to troff.
139 . Dr. Robert Hermann's groff gems are available from
141     http://www.eas.slu.edu/People/RBHerrmann/GROFF/index.html
143   At present there are examples for
145   o creating business cards
146   o using groff to make large format posters for presentations
148 . Robert Marks's collection of useful macros and scripts is available from
150     http://www.agsm.edu.au/~bobm/odds+ends/scripts.html
152   Description:
154   o `polish': Is a sed (= the Unix stream editor) script that does many
155     things to ASCII text.  Amongst other things, it breaks lines at new
156     sentences, reduces upper-case acronyms by one point size, adds
157     diacriticals, changes simple quotes into smart quotes, and makes a few
158     simple grammar checks.  The best way to see what it does is to run it
159     as a sed script file (or files) on a text file and then compare the
160     output file with the original.
162   o `DropCaps' is a troff script which replaces the initial letters of
163     paragraphs immediately after H1 and H2 headings with drop-capitals of
164     specified point size, and automatically flows the text around the new
165     drop cap.
167   o `AJM Header' is a set of troff macros used in production of the
168     Australian Journal of Management.  They use the Memorandum Macros (mm)
169     of AT&T, and so should be invoked with the UNIX troff -mm flag; they
170     should also work with the GNU troff -mm flag.
172 . Thomas Baruchel <baruchel@libertysurf.fr> has developed Meta-tbl, a tbl
173   postprocessor to manipulate table cells (like adding gray shades).  The
174   latest version can be found at
176     http://perso.libertysurf.fr/baruchel/
178 . gpresent, written by Bob Diertens <bobd@science.uva.nl>.  From the README
179   file:
181     gpresent is a package for making presentation with groff and acroread.
182     It consist of a set of macros to be used with groff and a post-processor
183     for manipulating the PostScript output of groff.  Without the use of the
184     PAUSE macro, it can also be used for making slides.
185     
186   It is available from
188     www.science.uva.nl/~bobd/useful/gpresent/
191 documentation
192 -------------
194 Many documents related to the original versions of troff, ditroff, pic,
195 and others can be accessed from the following web pages:
197   http://www.cs.bell-labs.com/cm/cs/cstr.html
198   http://www.cs.bell-labs.com/cm/cs/papers.html