NAME

troff, nroff − text formatting and typesetting

SYNOPSIS

troff [ options ] [ files ]

nroff [ options ] [ files ]

DESCRIPTION

Troff formats text in the named files for printing on a Graphic Systems C/A/T phototypesetter.  Nroff formats files for typewriter-like devices.  The Nroff/Troff User’s Manual describes the capabilities of both nroff and troff. 

If no file argument is present, troff or nroff reads the standard input.  An argument consisting of a single minus (−) is taken to be a filename corresponding to the standard input. 

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. 

OPTIONS

The options, which may appear in any order so long as they appear before the files, are:

−i Reads standard input after the input files are exhausted. 

−olist Prints 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. 

−mname Prepends the macro file /usr/lib/tmac/tmac.name to the input files.

−nN Numbers first generated page N.

−q Invokes the simultaneous input-output mode of the rd request. 

−raN Sets register a (one-character) to N.

−sN Stops 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 phototypesetter every N pages, produce a trailer to allow changing cassettes, and resume when the typesetter’s start button is pressed. 

Troff only

−a Sends a printable ASCII approximation of the results to the standard output. 

−b Reports whether the phototypesetter is busy or available.  No text processing is done. 

−f Refrains from feeding out paper and stopping phototypesetter at the end of the run. 

−Ffontdir The directory fontdir contains the font width tables instead of the default directory /usr/lib/fonts. You can use this option to produce output for devices besides the phototypesetter. 

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

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

−w Waits until phototypesetter is available, if currently busy. 

FILES

/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

J. F. Ossanna, Nroff/Troff user’s manual
B. W. Kernighan, A TROFF Tutorial
eqn(1), tbl(1), ms(7), me(7), man(7), col(1)

INTEGRATED SOLUTIONS 4.3 BSD  —  April 29, 1985