NAME

troff, nroff − text formatting and typesetting

SYNTAX

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

DESCRIPTION

The troff command formats text in the named files for printing on a Graphic Systems C/A/T phototypesetter.  The nroff command formats text in the named files for typewriter-like devices.  Their capabilities are described in the “Nroff/Troff user’s manual”. 

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. 

OPTIONS

The options may appear in any order so long as they appear before the files. 

−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.  The nroff command will halt prior to every N pages (default N=1) to allow paper loading or changing, and will resume upon receipt of a newline. The troff command will stop the phototypesetter 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.  The −mr option simulates roff output. 

−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 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 settings are assumed to be every 8 nominal character widths. 

Troff only

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

−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 standard output. 

−pN Print all characters in point size N while retaining all prescribed spacings and motions, to reduce phototypesetter elapsed time. 

−g Prepare output for a GCOS phototypesetter and direct it to the standard output. 

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/suftabsuffix 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/catphototypesetter
/usr/adm/tracctaccounting statistics for /dev/cat

SEE ALSO

col(1), eqn(1), roff(1), tbl(1), tc(1), tk(1)
“Nroff/Troff User’s Manual”
“A TROFF Tutorial”