troff(1BSD)          (BSD System Compatibility)          troff(1BSD)


       NAME
             troff - (BSD) typeset or format documents

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

       DESCRIPTION
             troff formats text in the files.  Input to troff is expected
             to consist of text interspersed with formatting requests and
             macros.  If no file argument is present, troff reads standard
             input.  A - as a file 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 argument 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 file.

             -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/ucblib/doctools/tmac/name to
                   the input files.  Note: most references to macro
                   packages include the leading m as part of the name; for
                   example, the man macro package resides in
                   /usr/ucblib/doctools/tmac/an.

             -nN   Number first generated page N.




                           Copyright 1994 Novell, Inc.               Page 1

      troff(1BSD)          (BSD System Compatibility)          troff(1BSD)


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

                  aps   Autologic APS-5.  This is the default value.

            -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
            /var/tmp/trtmp                        temporary file

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

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

      REFERENCES
            checknr(1BSD), eqn(1BSD), man(5BSD), me(5BSD), ms(5BSD),
            nroff(1BSD), tbl(1BSD)












                          Copyright 1994 Novell, Inc.               Page 2