troff(1)           UNIX System V(BSD Compatibility Package)            troff(1)


NAME
      troff - typeset or format documents

SYNOPSIS
      /usr/ucb/troff [ -afiz ] [ -Fdir ] [ -mname ] [ -nN ] [ -olist ] [ -raN ]
      [ -sN ]
                         [ -Tdest ] [ -uN ] [ filename ] . . .

DESCRIPTION
      troff formats text in the filenames.  Input to troff is expected to
      consist of text interspersed with formatting requests and macros.  If no
      filename argument is present, troff reads standard input.  A - as a
      filename argument indicates that standard input is to be read at that
      point in the list of input files; troff reads the files named ahead of
      the - in the arguments list, then text from the standard input, and then
      text from the files named after the -.

      The following options may appear in any order, but they all must appear
      before the first filename.

      -a    Send a printable approximation of the formatted output to the
            standard output file.

      -f    Do not print a trailer after the final page of output or cause the
            postprocessor to relinquish control of the device.

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

      -z    Suppress formatted output.  Only diagnostic messages and messages
            output using the .tm request are output.

      -Fdir Search the directory dir for font width tables instead of the
            system-dependent default directory.

      -mname
            Prepend the macro file /usr/lib/tmac/tmac.name to the input
            filenames.  Note: most references to macro packages include the
            leading m as part of the name; for example, the man macro package
            resides in /usr/lib/tmac/tmac.an.

      -nN   Number first generated page N.

      -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.

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





10/89                                                                    Page 1

troff(1)           UNIX System V(BSD Compatibility Package)            troff(1)


      -sN   Stop the phototypesetter every N pages.  On some devices, troff
            produces a trailer so you can change cassettes; resume by pressing
            the typesetter's start button.

      -Tdest
            Prepare output for typesetter dest.  The following values can be
            supplied for dest:
                  202   Mergenthaler Linotron 202. This is the default value.
                  cat   Graphics Systems C/A/T.
                  aps   Autologic APS-5.

      -uN   Set the emboldening factor for the font mounted in position 3 to N.
            If N is missing, then set the emboldening factor to 0.

FILES
      /tmp/trtmp                            temporary file

      /usr/ucblib/doctools/tmac/tmac.*      standard macro files

      /usr/ucblib/doctools/font/*           font width tables for alternate
                                            mounted troff fonts

SEE ALSO
      checknr(1), chmod(1), eqn(1), lpd(1M), lpr(1), nroff(1), tbl(1), man(7),
      me(7), ms(7)

      chmod(1), col(1) in the User's Reference Manual



























Page 2                                                                    10/89