troff(1)                (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.




   8/91                                                                 Page 1

   troff(1)                (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                                                                 8/91