%sccs.include.proprietary.roff%

@(#)troff.1 6.2 (Berkeley) 04/18/91

.AT 3 troff, nroff - text formatting and typesetting troff [ option ] ... [ file ] ...

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

Troff formats text in the named files for printing on a Graphic Systems C/A/T phototypesetter; nroff is used for 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. The options, which may appear in any order so long as they appear before the files, are:

"\w'\f3-m\f1name 'u" -o list 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.

-n N Number first generated page N .

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

-m name Prepend the macro file /usr/lib/tmac/tmac. name to the input files .

-r aN 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.

.bd I 3 Troff only

.bd I

-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.

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

-F fontdir The directory fontdir contains the font width tables instead of the default directory /usr/lib/fonts. This option can be used to produce output for devices besides the phototypesetter.

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.

/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

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)