BSD 4_3_Tahoe development
[unix-history] / usr / man / cat1 / troff.0
TROFF(1) UNIX Programmer's Manual TROFF(1)
N\bNA\bAM\bME\bE
troff, nroff - text formatting and typesetting
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
t\btr\bro\bof\bff\bf [ option ] ... [ file ] ...
n\bnr\bro\bof\bff\bf [ option ] ... [ file ] ...
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
_\bT_\br_\bo_\bf_\bf formats text in the named _\bf_\bi_\bl_\be_\bs for printing on a
Graphic Systems C/A/T phototypesetter; _\bn_\br_\bo_\bf_\bf is used for for
typewriter-like devices. Their capabilities are described
in the _\bN_\br_\bo_\bf_\bf/_\bT_\br_\bo_\bf_\bf _\bu_\bs_\be_\br'_\bs _\bm_\ba_\bn_\bu_\ba_\bl.
If no _\bf_\bi_\bl_\be argument is present, the standard input is read.
An argument consisting of a single minus (-\b-) 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:
-\b-o\bo_\bl_\bi_\bs_\bt Print only pages whose page numbers appear in the
comma-separated _\bl_\bi_\bs_\bt of numbers and ranges. A range
_\bN-\b-_\bM means pages _\bN through _\bM; an initial -_\bN means from
the beginning to page _\bN; and a final _\bN- means from _\bN
to the end.
-\b-n\bn_\bN Number first generated page _\bN.
-\b-s\bs_\bN Stop every _\bN pages. _\bN_\br_\bo_\bf_\bf will halt prior to every _\bN
pages (default _\bN=1) to allow paper loading or chang-
ing, and will resume upon receipt of a newline.
_\bT_\br_\bo_\bf_\bf will stop the phototypesetter every _\bN pages,
produce a trailer to allow changing cassettes, and
resume when the typesetter's start button is pressed.
-\b-m\bm_\bn_\ba_\bm_\be Prepend the macro file /\b/u\bus\bsr\br/\b/l\bli\bib\bb/\b/t\btm\bma\bac\bc/\b/t\btm\bma\bac\bc.\b._\bn_\ba_\bm_\be to the
input _\bf_\bi_\bl_\be_\bs.
-\b-r\br_\ba_\bN Set register _\ba (one-character) to _\bN.
-\b-i\bi Read standard input after the input files are
exhausted.
-\b-q\bq Invoke the simultaneous input-output mode of the r\brd\bd
request.
_\bT_\br_\bo_\bf_\bf _\bo_\bn_\bl_\by
-\b-t\bt Direct output to the standard output instead of the
phototypesetter.
-\b-f\bf Refrain from feeding out paper and stopping
Printed 7/9/88 April 29, 1985 1
TROFF(1) UNIX Programmer's Manual TROFF(1)
phototypesetter at the end of the run.
-\b-w\bw Wait until phototypesetter is available, if currently
busy.
-\b-b\bb Report whether the phototypesetter is busy or avail-
able. No text processing is done.
-\b-a\ba Send a printable ASCII approximation of the results
to the standard output.
-\b-p\bpN Print all characters in point size _\bN while retaining
all prescribed spacings and motions, to reduce photo-
typesetter elapsed time.
-\b-F\bF_\bf_\bo_\bn_\bt_\bd_\bi_\br
The directory _\bf_\bo_\bn_\bt_\bd_\bi_\br 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 /_\bu_\bs_\br/_\ba_\bd_\bm/_\bt_\br_\ba_\bc_\bc_\bt is writable, _\bt_\br_\bo_\bf_\bf keeps photo-
typesetter accounting records there. The integrity of that
file may be secured by making _\bt_\br_\bo_\bf_\bf a 'set user-id' program.
F\bFI\bIL\bLE\bES\bS
/tmp/ta* temporary file
/usr/lib/tmac/tmac.* standard macro files
/usr/lib/term/* terminal driving tables for _\bn_\br_\bo_\bf_\bf
/usr/lib/font/* font width tables for _\bt_\br_\bo_\bf_\bf
/dev/cat phototypesetter
/usr/adm/tracct accounting statistics for /dev/cat
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
J. F. Ossanna, _\bN_\br_\bo_\bf_\bf/_\bT_\br_\bo_\bf_\bf _\bu_\bs_\be_\br'_\bs _\bm_\ba_\bn_\bu_\ba_\bl
B. W. Kernighan, _\bA _\bT_\bR_\bO_\bF_\bF _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl
eqn(1), tbl(1), ms(7), me(7), man(7), col(1)
Printed 7/9/88 April 29, 1985 2