TROFF(1)                                                              TROFF(1)


NAME
     troff - text formatting and typesetting language

SYNOPSIS
     troff [ option(s) ] [ -- ] [ file(s) ] | typesetter

DESCRIPTION
     Troff formats text in the named files for printing on a phototypesetter
     or comparable device.  If no file(s) argument is present, the standard
     input is read.  An argument consisting of a single minus (-) is taken to
     be a file name corresponding to the standard input.  The options, which
     may appear in any order so long as they appear before the files, are:

     -olist Print only pages whose page numbers appear in the comma-separated
            list of numbers and ranges.  A range N-M means pages N through M;
            an initial -N means from the beginning to page N; and a final N-
            means from N to the end.  (See BUGS below.)

     -nN    Number first generated page N.

     -sN    Generate output to encourage typesetter to stop every N pages.

     -mname Prepend the macro file /usr/lib/tmac/tmac.name to the input files.

     -raN   Set register a (one character name) to N.

     -i     Read standard input after the input files are exhausted.

     -q     Invoke the simultaneous input-output mode of the .rd request.

     -z     Print only messages generated by .tm requests.

     -a     Send a printable ASCII approximation of the results to the
            standard output.

     -Ttty_type
            Prepare output for typesetter or laser printer tty_type.
            Currently, the only supported device is psc (Apple LaserWriter).
            Alternatively, the environment variable TYPSETTER may be set.

FILES
     /tmp/trtmp*           temporary file
     /usr/lib/tmac/tmac.*  standard macro files
     /usr/lib/macros/*     standard macro files
     /usr/lib/font/dev*/*  font width tables

SEE ALSO
     grap(1), eqn(1), mmt(1), nroff(1), pic(1), tbl(1), tc(1).

     The "nroff/troff Technical Discussion"
     "The Formatter troff" in the User's Guide.


BUGS
     The .tl request may not be used before the first break-producing request
     in the input to troff.

     Troff believes in Eastern Standard Time; as a result, depending on the
     time of the year and on your local time zone, the date that troff
     generates may be off by one day from your idea of what the date is.

     When troff is used with the -olist option inside a pipeline (e.g., with
     one or more of pic(1), eqn(1), and tbl(1)), it may cause a harmless
     ``broken pipe'' diagnostic if the last page of the document is not
     specified in list.


                                                                        Page 2