MORE.STUFF

   1     Copyright 2000, 2001, 2002, 2007
   2       Free Software Foundation, Inc.
   3
   4     Copying and distribution of this file, with or without modification,
   5     are permitted in any medium without royalty provided the copyright
   6     notice and this notice are preserved.
   7
   8 More stuff for groff
   9 ====================
  10
  11 Windows 32
  12 ----------
  13
  14 Here are two ports using the gcc compiler and other GNU tools:
  15
  16 . Cygwin:
  17
  18     http://sources.redhat.com/cygwin/
  19
  20   Look for a convenient mirror site in
  21
  22     http://sources.redhat.com/cygwin/mirrors.html
  23
  24   At any of those mirrors, groff can be found in the directory
  25   latest/groff.
  26
  27 . Kees Zeelenberg <c.zeelenberg@hccnet.nl>:
  28
  29     http://gnuwin32.sourceforge.net/packages/groffl.htm
  30
  31   This port includes recent versions of grap and deroff.
  32
  33 dos
  34 ---
  35
  36 Binaries for Eli Zaretskii's port using the djgpp compiler are available
  37 from
  38
  39   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/gro*b.zip
  40
  41 and its mirrors; for installation details please read `arch/djgpp/README'.
  42 This port also runs on Windows 32 systems, except Windows 2000.
  43
  44 grap
  45 ----
  46
  47 An implementation of Kernighan & Bentley's grap language for typesetting
  48 graphs.  Written by Ted Faber <faber@lunabase.org>.  The actual version
  49 can be found at
  50
  51   http://www.lunabase.org/~faber/Vault/software/grap/
  52
  53 A djgpp port which runs on dos and most Windows 32 systems (Windows 95,
  54 Windows 98, Windows NT) done by Kees Zeelenberg <c.zeelenberg@hccnet.nl>
  55 is available from
  56
  57   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/
  58
  59 It is intended to be used with the djgpp port of groff.
  60
  61 A Windows 32 port is included in the groff package available from
  62
  63     http://gnuwin32.sourceforge.net/
  64
  65 plot2dev
  66 --------
  67
  68 This utility program can convert plot graphics to either pic or gremlin
  69 files.  It has been written by Richard Murphey <richard-murphey@rice.edu>
  70 and Daniel Senderowicz <daniel@synchrods.com> (who has added the gremlin
  71 driver).  The actual version can be found as
  72
  73   ftp://ftp.ffii.org/pub/groff/plot2dev-x.x.tar.gz
  74
  75 troffcvt
  76 --------
  77
  78 From the web page:
  79
  80   troffcvt is a translator that turns troff input into a form that can be
  81   more easily processed.  The troffcvt distribution comes with
  82   postprocessors that turn troffcvt into various destination formats such
  83   as HTML (Hypertext Markup Language), RTF (Rich Text Format) or plain
  84   text.
  85
  86 Note that you need a lot of additional packages to compile troffcvt;
  87 everything is available from
  88
  89   http://www.primate.wisc.edu/software/troffcvt/
  90
  91 unroff
  92 ------
  93
  94 From the README file:
  95
  96   Unroff is a Scheme-based, programmable, extensible troff translator with
  97   a back-end for the Hypertext Markup Language.  Unroff is free software
  98   and is distributed both as source and as precompiled binaries.
  99
 100     http://www.informatik.uni-bremen.de/~net/unroff/unroff.html
 101
 102 You need als Elk, the Scheme based Extension Language Kit, which is
 103 available from
 104
 105   http://www.informatik.uni-bremen.de/~net/elk
 106
 107 deroff
 108 ------
 109
 110 Deroff removes roff constructs from documents for the purpose of indexing,
 111 spell checking etc.
 112
 113 Michael Haardt's <michael@moria.de> implementation is a little smarter
 114 than traditional implementations, because it knows about certain -man and
 115 -mm macros.  It is able to generate a word list for spell checking tools
 116 or omit headers for sentence analysis tools.  It can further generate
 117 cpp-style #line lines.
 118
 119   http://www.moria.de/deroff/
 120
 121 Version 1.6 compiled with DJGPP (for MS-DOS and all Windows 32 systems,
 122 i.e. Windows 95, Windows 98, Windows NT) is available from
 123
 124   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/
 125
 126 and its mirrors.
 127
 128 A Windows 32 port of version 1.8 is available from
 129
 130   http://gnuwin32.sourceforge.net/
 131
 132 David Frey <dfrey@debian.org> has also written a deroff implementation
 133 for Debian; it is available from
 134
 135   ftp://ftp.debian.org/debian/pool/main/d/deroff/
 136
 137 doclifter
 138 ---------
 139
 140 doclifter lifts troff macro markup to XML-Docbook.  It doesn't do raw troff
 141 at all well (raw troff has insufficient structural information) but it
 142 handles manual pages, ms, mm, and me markup, producing clean lifts
 143 to valid XML more than 96% of the time.  pic markup is translated to SVG,
 144 eqn markup to Presentation MathML.
 145
 146 doclifter with the -w option behaves as a portability checker and validator,
 147 warning about constructs that aren't portable across *roff implementations
 148 and viewers.
 149
 150 It is available from
 151
 152   http://catb.org/~esr/doclifter
 153
 154 pic2plot
 155 --------
 156
 157 pic2plot, part of the GNU plotutils package, can lift pic markup to SVG.
 158 The plotutils package is available at
 159
 160   http://www.gnu.org/software/plotutils/
 161
 162 miscellaneous
 163 -------------
 164
 165 . Ralph Corderoy's excellent page on troff:
 166
 167     www.troff.org
 168
 169   There are links for virtually everything related to troff.
 170
 171 . Dr. Robert Hermann's groff gems are available from
 172
 173     http://www.eas.slu.edu/People/RBHerrmann/GROFF/index.html
 174
 175   At present there are examples for
 176
 177   o creating business cards
 178   o using groff to make large format posters for presentations
 179
 180 . Robert Marks's collection of useful macros and scripts is available from
 181
 182     http://www.agsm.edu.au/~bobm/odds+ends/scripts.html
 183
 184   Description:
 185
 186   o `polish': Is a sed (= the Unix stream editor) script that does many
 187     things to ASCII text.  Amongst other things, it breaks lines at new
 188     sentences, reduces upper-case acronyms by one point size, adds
 189     diacriticals, changes simple quotes into smart quotes, and makes a few
 190     simple grammar checks.  The best way to see what it does is to run it
 191     as a sed script file (or files) on a text file and then compare the
 192     output file with the original.
 193
 194   o `DropCaps' is a troff script which replaces the initial letters of
 195     paragraphs immediately after H1 and H2 headings with drop-capitals of
 196     specified point size, and automatically flows the text around the new
 197     drop cap.
 198
 199   o `AJM Header' is a set of troff macros used in production of the
 200     Australian Journal of Management.  They use the Memorandum Macros (mm)
 201     of AT&T, and so should be invoked with the UNIX troff -mm flag; they
 202     should also work with the GNU troff -mm flag.
 203
 204 . Thomas Baruchel <baruchel@libertysurf.fr> has developed Meta-tbl, a tbl
 205   postprocessor to manipulate table cells (like adding gray shades).  The
 206   latest version can be found at
 207
 208     http://perso.libertysurf.fr/baruchel/
 209
 210 . gpresent, written by Bob Diertens <bobd@science.uva.nl>.  From the README
 211   file:
 212
 213     gpresent is a package for making presentation with groff and acroread.
 214     It consist of a set of macros to be used with groff and a post-processor
 215     for manipulating the PostScript output of groff.  Without the use of the
 216     PAUSE macro, it can also be used for making slides.
 217
 218   It is available from
 219
 220     www.science.uva.nl/~bobd/useful/gpresent/
 221
 222
 223 documentation
 224 -------------
 225
 226 Many documents related to the original versions of troff, ditroff, pic,
 227 and others can be accessed from the following web pages:
 228
 229   http://www.cs.bell-labs.com/cm/cs/cstr.html
 230   http://www.cs.bell-labs.com/cm/cs/papers.html