


      TROFF(1)                      (DWB)                      TROFF(1)



      NAME
           troff - text formatting and typesetting

      SYNTAX
           troff [ option ] ...  [ file ] ...

      DESCRIPTION
           Troff formats text in the named files for printing on a
           phototypesetter.  It is the new "device-independent" version
           of the old otroff (see nroff(1)).  Its capabilities are
           described in the Documenter's Workbench Text Formatter's
           Reference.

           If no file 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.

           -Tdest Prepare output for typesetter dest.

      FILES
           /tmp/trtmp*           temporary file
           /usr/lib/tmac/tmac.*  standard macro files
           /usr/lib/macros/*     standard macro files



      Page 1                                          (73 A2 02MT REV1)






      TROFF(1)                      (DWB)                      TROFF(1)



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

           Documenter's Workbench Text Formatter's Reference.

      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                                          (73 A2 02MT REV1)



