troff(1)                   DG/UX 4.30                    troff(1)



     NAME
          troff - text formatting and typesetting

     SYNOPSIS
          troff [ option ] ...  [ file ] ...

     DESCRIPTION
          Troff formats text in the named files for printing on a
          phototypesetter or other high-resolution output device.  It
          is the new `device-independent' version of the old otroff.
          Its capabilities are described in the Using the Documenter's
          Tool Kit on the DG/UX System.

          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.  The only device
                 supported currently is the IMAGEN laser printer
                 (-Ti10, -TIMAGEN).






     Licensed material--property of copyright holder(s)         Page 1

     troff(1)                   DG/UX 4.30                    troff(1)



     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
          di10(1), eqn(1), grap(1), nroff(1), mmt(1), pic(1), tbl(1).
          Using the Documenter's Tool Kit on the DG/UX System.
          Documenter's Tool Kit Technical Summary for the DG/UX
          System.

     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 eqn(1), grap(1), pic(1), and
          tbl(1)), it may cause a harmless `broken pipe' diagnostic if
          the last page of the document is not specified in list.






























     Licensed material--property of copyright holder(s)         Page 2