32v 1m troff
From Computer History Wiki
TROFF(1) UNIX Programmer's Manual TROFF(1)
Contents
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)