4.3BSD-UWisc/man/cat1/troff.1

TROFF(1)            UNIX Programmer's Manual             TROFF(1)



NAME
     troff, nroff - text formatting and typesetting

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

     nroff [ option ] ...  [ file ] ...

DESCRIPTION
     _T_r_o_f_f formats text in the named _f_i_l_e_s for printing on a
     Graphic Systems C/A/T phototypesetter; _n_r_o_f_f is used for for
     typewriter-like devices.  Their capabilities are described
     in the _N_r_o_f_f/_T_r_o_f_f _u_s_e_r'_s _m_a_n_u_a_l.

     If no _f_i_l_e 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:

     -o_l_i_s_t Print only pages whose page numbers appear in the
            comma-separated _l_i_s_t 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.

     -n_N    Number first generated page _N.

     -s_N    Stop every _N pages.  _N_r_o_f_f will halt prior to every _N
            pages (default _N=1) to allow paper loading or chang-
            ing, and will resume upon receipt of a newline.
            _T_r_o_f_f will stop the phototypesetter every _N pages,
            produce a trailer to allow changing cassettes, and
            resume when the typesetter's start button is pressed.

     -m_n_a_m_e Prepend the macro file /usr/lib/tmac/tmac._n_a_m_e to the
            input _f_i_l_e_s.

     -r_a_N   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_r_o_f_f _o_n_l_y

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

     -f     Refrain from feeding out paper and stopping



Printed 12/27/86         April 29, 1985                         1






TROFF(1)            UNIX Programmer's Manual             TROFF(1)



            phototypesetter at the end of the run.

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

     -b     Report whether the phototypesetter is busy or avail-
            able.  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.

     -F_f_o_n_t_d_i_r
            The directory _f_o_n_t_d_i_r 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 /_u_s_r/_a_d_m/_t_r_a_c_c_t is writable, _t_r_o_f_f keeps photo-
     typesetter accounting records there.  The integrity of that
     file may be secured by making _t_r_o_f_f a 'set user-id' program.

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

SEE ALSO
     J. F. Ossanna, _N_r_o_f_f/_T_r_o_f_f _u_s_e_r'_s _m_a_n_u_a_l
     B. W. Kernighan, _A _T_R_O_F_F _T_u_t_o_r_i_a_l
     eqn(1), tbl(1), ms(7), me(7), man(7), col(1)


















Printed 12/27/86         April 29, 1985                         2