MORE.STUFF

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