MORE.STUFF

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