TROFF(1-BSD)        RISC/os Reference Manual         TROFF(1-BSD)



NAME
     troff - text formatting and typesetting

SYNOPSIS
     troff [ option ] ...  [ file ] ...

DESCRIPTION
     troff formats text in the named files for printing on a pho-
     totypesetter.

     If no file argument is present, the standard input is read.
     An argument consisting of a single minus (-) is taken to be
     a file name corresponding to the standard input.  The
     options, which may appear in any order so long as they
     appear before the files, are:

     -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 photo-
            typesetter every N pages, produce a trailer to allow
            changing cassettes, and resume when the typesetter's
            start button is pressed.

     -mname Prepend the macro file /usr/lib/tmac/tmac.name to the
            input files.  See man(5-BSD), me(5-BSD), and ms(5-
            BSD) for information on the -man, -me, and -ms macro
            packages.

     -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 photo-
            typesetter at the end of the run.

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

     -b     Report whether the phototypesetter is busy or



                         Printed 1/15/91                   Page 1

TROFF(1-BSD)        RISC/os Reference Manual         TROFF(1-BSD)



            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 photo-
            typesetter elapsed time.

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

     If the file /usr/adm/tracct is writable, troff keeps photo-
     typesetter accounting records there.  The integrity of that
     file may be secured by making troff a 'set user-id' program.

FILES
     /tmp/ta*              temporary file
     /usr/lib/tmac/tmac.*  standard macro files
     /usr/lib/term/*       terminal driving tables for nroff
     /usr/lib/font/*       font width tables for troff
     /dev/cat              phototypesetter
     /usr/adm/tracct       accounting statistics for /dev/cat

SEE ALSO
     col(1-BSD), deroff(1-BSD), eqn(1-BSD), nroff(1-BSD), tbl(1-
     BSD).
     man(5-BSD), me(5-BSD), ms(5-BSD) in the Programmer's Refer-
     ence Manual.
     J. F. Ossanna, nroff/troff user's manual
     B. W. Kernighan, A TROFF Tutorial
     Documenter's Workbench.




















 Page 2                  Printed 1/15/91