Copy the script troff2page to a directory in your PATH.
Copy the files with extension .tmac to a directory in your
GROFF_TMAC_PATH, or to your home directory.

*

The script troff2page is known to run on the following
Common Lisp and operating systems:

CLISP: Cygwin, Mac OS X, Solaris
Clozure: Mac OS X
SBCL: Mac OS X, Solaris

It will use the Common Lisp mentioned by the shell
environment variable LISP.  Currently, the values supported
for LISP are: clisp, clozure, and sbcl (all lowercase).  If
LISP is not set, clozure is assumed on Mac OS X, and clisp is
assumed for other systems.  Here are some ways
to invoke troff2page (assume LISP unset):

  % troff2page jobname.ms    # uses Clozure on Mac OS, CLISP elsewhere

  % LISP=clozure troff2page jobname.ms  # uses Clozure

  % export LISP=sbcl         # uses SBCL henceforth
  % troff2page jobname.ms

To have troff2page run on Common Lisp implementations other
than these, you will have to add lines to the head of the
troff2page file.

To have .eval (see manual) work for groff and not just
troff2page, you will have to add lines to the head of the
file eval4troff.tmac as well.

*

It is not necessary to use the file troff2page as a Unix
script.  You can simply load troff2page (which is really a
Lisp file) into your Common Lisp, and then call the Lisp
procedure troff2page:troff2page (i.e., the procedure named
troff2page in the package troff2page) on your source
document.  E.g.,

  (load "pathname/of/troff2page")
  (troff2page:troff2page "my-troff-document.1")

The procedure troff2page:troff2page can be called 
several times, on the same or different documents, from
within the same Lisp session.

-------------------------
Last modified: 2008-09-15