32v 1m troff

From Computer History Wiki
Jump to: navigation, search

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 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.
    _N_r_o_f_f _o_n_l_y
    -T_n_a_m_e Prepare output for specified terminal.  Known _n_a_m_e_s
           are 37 for the (default) Teletype Corporation Model
           37 terminal, tn300 for the GE TermiNet 300 (or any
           terminal without half-line capability), 300S for the
           DASI-300S, 300 for the DASI-300, and 450 for the
           DASI-450 (Diablo Hyterm).
    -e     Produce equally-spaced words in adjusted lines, using
           full terminal resolution.
    -h     Use output tabs during horizontal spacing to speed
           output and reduce output character count.  Tab set-
           tings are assumed to be every 8 nominal character
           widths.
    _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 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 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 elasped time.
    -g     Prepare output for a GCOS phototypesetter and direct
           it to the standard output (see _g_c_a_t(1)).
    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)
    col(1), tk(1) (_n_r_o_f_f only)
    tc(1) (_t_r_o_f_f only)