TROFF(1)                             BSD                              TROFF(1)



NAME
     troff - text formatting and typesetting

SYNOPSIS
     troff [ options ] ...  [ file(s) ] ...

DESCRIPTION
     troff formats text in the named files for printing on a phototypesetter;
     nroff(1) is used for for typewriter-like devices.  The UNIX Text
     Processing manual offers a complete description of the use of each.

     If no file argument is present, or if you specify a single dash (-),
     nroff reads the standard input.

OPTIONS
     The options may appear in any order so long as they appear before the
     files.

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

     -nN       Number first generated page N.

     -sN       Stop every N pages.  troff will stop the phototypesetter every
               N pages, produce a trailer to allow changing cassettes, and
               resume when the typesetter's start button is pressed.

     -mname    Prefix the macro file /usr/lib/tmac/tmac.name to the input
               files.

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

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

     -q        Invoke the simultaneous input-output mode of the rd request.

     -t        Direct output to the standard output instead of the
               phototypesetter.

     -f        Refrain from feeding out paper and stopping phototypesetter at
               the end of the run.

     -w        Wait until phototypesetter is available, if currently busy.

     -b        Report whether the phototypesetter is busy or available.  No
               text processing is done.

     -a        Send a printable ASCII approximation of the results to the
               standard output.

     -pN       Print all characters in point size N while retaining all
               prescribed spacings and motions, to reduce phototypesetter
               elapsed time.

     -Ffontdir The directory fontdir contains the font width tables instead of
               the default directory /usr/lib/fonts.  Use this option to
               produce output for devices besides the phototypesetter.

FILES

     /tmp/ta*                 temporary file
     /usr/lib/tmac/tmac.*     standard macro files
     /usr/lib/font/*          font width tables for troff

SEE ALSO
     nroff(1), eqn(1), tbl(1), ms(7), me(7), man(7), col(1), colcrt(1);
     UNIX Text Processing;
     J. F. Ossanna, Nroff/Troff User's Manual
     B. W. Kernighan, A Troff Tutorial.