TROFF(1)TROFF(1)NAME
troff, nroff - text formatting and typesetting
SYNOPSIStroff [ option ] ... [ file ] ...
nroff [ option ] ... [ file ] ...
DESCRIPTION
Troff formats text in the named files for printing on a Graphic Systems
C/A/T phototypesetter; nroff for typewriter-like devices. Their capa‐
bilities are described in the Nroff/Troff user's manual.
If no file argument is present, the standard input is read. An argu‐
ment consisting of a single minus (-) is taken to be a file name corre‐
sponding 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-sepa‐
rated 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. Nroff will halt prior to every N pages
(default N=1) to allow paper loading or changing, and will
resume upon receipt of a newline. 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.
-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.
Nroff only
-Tname Prepare output for specified terminal. Known names are 37 for
the (default) Teletype Corporation Model 37 terminal, tn300 for
the GE TermiNet 300 (or any terminal without half-line capabil‐
ity), 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 ter‐
minal resolution.
-h Use output tabs during horizontal spacing to speed output and
reduce output character count. Tab settings are assumed to be
every 8 nominal character widths.
Troff only
-t Direct output to the standard output instead of the phototype‐
setter.
-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 stan‐
dard output.
-pN Print all characters in point size N while retaining all pre‐
scribed spacings and motions, to reduce phototypesetter elasped
time.
-g Prepare output for a GCOS phototypesetter and direct it to the
standard output (see gcat(1)).
If the file /usr/adm/tracct is writable, troff keeps phototypesetter
accounting records there. The integrity of that file may be secured by
making troff a `set user-id' program.
FILES
/usr/lib/suftab suffix hyphenation tables
/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
J. F. Ossanna, Nroff/Troff user's manual
B. W. Kernighan, A TROFF Tutorial
eqn(1), tbl(1)col(1), tk(1) (nroff only)
tc(1), gcat(1) (troff only)
TROFF(1)