troff(1)                 USER COMMANDS                   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 pack-
          ages 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.
     -sN  Stop the phototypesetter every N pages.  On  some  dev-
          ices,  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



             Last change: BSD Compatibility Package             1

troff(1)                 USER COMMANDS                   troff(1)



          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 embol-
          dening factor to 0.















































             Last change: BSD Compatibility Package             2

troff(1)                 USER COMMANDS                   troff(1)



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.










































             Last change: BSD Compatibility Package             3