freebsd-dev/contrib/groff/MORE.STUFF

More stuff for groff
====================

win32
-----

Here two ports using the gcc compiler and other GNU tools:

  Thomer M. Gil <tmgil@cs.vu.nl>:

    http://www.cs.vu.nl/~tmgil/misc/wingroff.html

  Kees Zeelenberg <c.zeelenberg@hccnet.nl>:

    http://gnuwin32.sourceforge.net/

dos
---

Binaries for Eli Zaretskii's port using the djgpp compiler
are available from

  ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/gro*b.zip

and its mirrors; for installation details please read `arch/djgpp/README'.

grap
----

An implementation of Kernighan & Bentley's grap language for typesetting
graphs.  Written by Ted Faber <faber@lunabase.org>.  The actual version
can be found at 

  http://www.lunabase.org/~faber/Vault/software/grap/

A djgpp port which runs on MS-DOS and all Win32 systems (Win95, Win98,
WinNT) done by Kees Zeelenberg <c.zeelenberg@hccnet.nl> is available from

  ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/

It is intended to be used with the djgpp port of groff.

plot2dev
--------

This utility program can convert plot graphics to either pic or gremlin
files.  It has been written by Richard Murphey <richard-murphey@rice.edu>
and Daniel Senderowicz <daniel@synchrods.com> (who has added the gremlin
driver).  The actual version can be found as

  ftp://ftp.ffii.org/pub/groff/plot2dev-x.x.tar.gz

troffcvt
--------

From the web page:

  troffcvt is a translator that turns troff input into a form that can be
  more easily processed.  The troffcvt distribution comes with
  postprocessors that turn troffcvt into various destination formats such
  as HTML (Hypertext Markup Language), RTF (Rich Text Format) or plain
  text.

Note that you need a lot of additional packages to compile troffcvt;
everything is available from

  http://www.primate.wisc.edu/software/troffcvt/

unroff
______

From the README file:

  Unroff is a Scheme-based, programmable, extensible troff translator with
  a back-end for the Hypertext Markup Language.  Unroff is free software
  and is distributed both as source and as precompiled binaries.

    http://www.informatik.uni-bremen.de/~net/unroff/unroff.html

You need als Elk, the Scheme based Extension Language Kit, which is
available from

  http://www.informatik.uni-bremen.de/~net/elk

deroff
------

Deroff removes roff constructs from documents for the purpose of indexing,
spell checking etc.

Michael Haardt's <michael@moria.de> implementation is a little smarter than
traditional implementations, because it knows about certain -man and
-mm macros.  It is able to generate a word list for spell checking tools
or omit headers for sentence analysis tools.  It can further generate
cpp-style #line lines.

  http://www.moria.de/deroff/

Version 1.6 compiled with DJGPP (for MS-DOS and all Win32 systems, i.e.
Win95, Win98, WinNT) is available from

  ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/

and its mirrors.

miscellaneous
-------------

. Dr. Robert Hermann's groff gems are available from

    http://www.eas.slu.edu/People/RBHerrmann/GROFF/index.html

  At present there are examples for

  o creating business cards
  o using groff to make large format posters for presentations

. Robert Marks's collection of useful macros and scripts is available from

    http://www.agsm.edu.au/~bobm/odds+ends/scripts.html

  Description:

  o `polish': Is a sed (= the Unix stream editor) script that does many
    things to ASCII text.  Amongst other things, it breaks lines at new
    sentences, reduces upper-case acronyms by one point size, adds
    diacriticals, changes simple quotes into smart quotes, and makes a few
    simple grammar checks.  The best way to see what it does is to run it as
    a sed script file (or files) on a text file and then compare the output
    file with the original.

  o `DropCaps' is a troff script which replaces the initial letters of
    paragraphs immediately after H1 and H2 headings with drop-capitals of
    specified point size, and automatically flows the text around the new
    drop cap.

  o `AJM Header' is a set of troff macros used in production of the
    Australian Journal of Management.  They use the Memorandum Macros (mm)
    of AT&T, and so should be invoked with the UNIX troff -mm flag; they
    should also work with the GNU troff -mm flag.

. Thomas Baruchel <baruchel@libertysurf.fr> has developed Meta-tbl, a tbl
  postprocessor to manipulate table cells (like adding gray shades).  The
  latest version can be found at

    http://perso.libertysurf.fr/baruchel/

documentation
-------------

Many documents related to the original versions of troff, ditroff, pic, and
others can be accessed from the following web page:

  http://www.cs.bell-labs.com/cm/cs/cstr.html