[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
Commit	Line	Data
362b077f C	1
	2
	3
	4	TROFF(1) UNIX Programmer's Manual TROFF(1)
	5
	6
	7
	8	N\bNA\bAM\bME\bE
	9	troff, nroff - text formatting and typesetting
	10
	11	S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
	12	t\btr\bro\bof\bff\bf [ option ] ... [ file ] ...
	13
	14	n\bnr\bro\bof\bff\bf [ option ] ... [ file ] ...
	15
	16	D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
	17	_\bT_\br_\bo_\bf_\bf formats text in the named _\bf_\bi_\bl_\be_\bs for printing on a
	18	Graphic Systems C/A/T phototypesetter; _\bn_\br_\bo_\bf_\bf is used for for
	19	typewriter-like devices. Their capabilities are described
	20	in the _\bN_\br_\bo_\bf_\bf/_\bT_\br_\bo_\bf_\bf _\bu_\bs_\be_\br'_\bs _\bm_\ba_\bn_\bu_\ba_\bl.
	21
	22	If no _\bf_\bi_\bl_\be argument is present, the standard input is read.
	23	An argument consisting of a single minus (-\b-) is taken to be
	24	a file name corresponding to the standard input. The
	25	options, which may appear in any order so long as they
	26	appear before the files, are:
	27
	28	-\b-o\bo_\bl_\bi_\bs_\bt Print only pages whose page numbers appear in the
	29	comma-separated _\bl_\bi_\bs_\bt of numbers and ranges. A range
	30	_\bN-\b-_\bM means pages _\bN through _\bM; an initial -_\bN means from
	31	the beginning to page _\bN; and a final _\bN- means from _\bN
	32	to the end.
	33
	34	-\b-n\bn_\bN Number first generated page _\bN.
	35
	36	-\b-s\bs_\bN Stop every _\bN pages. _\bN_\br_\bo_\bf_\bf will halt prior to every _\bN
	37	pages (default _\bN=1) to allow paper loading or chang-
	38	ing, and will resume upon receipt of a newline.
	39	_\bT_\br_\bo_\bf_\bf will stop the phototypesetter every _\bN pages,
	40	produce a trailer to allow changing cassettes, and
	41	resume when the typesetter's start button is pressed.
	42
	43	-\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
	44	input _\bf_\bi_\bl_\be_\bs.
	45
	46	-\b-r\br_\ba_\bN Set register _\ba (one-character) to _\bN.
	47
	48	-\b-i\bi Read standard input after the input files are
	49	exhausted.
	50
	51	-\b-q\bq Invoke the simultaneous input-output mode of the r\brd\bd
	52	request.
	53
	54	_\bT_\br_\bo_\bf_\bf _\bo_\bn_\bl_\by
	55
	56	-\b-t\bt Direct output to the standard output instead of the
	57	phototypesetter.
	58
	59	-\b-f\bf Refrain from feeding out paper and stopping
	60
	61
	62
	63	Printed 7/9/88 April 29, 1985 1
	64
65
66
67
68
69
70	TROFF(1) UNIX Programmer's Manual TROFF(1)
71
72
73
74	phototypesetter at the end of the run.
75
76	-\b-w\bw Wait until phototypesetter is available, if currently
77	busy.
78
79	-\b-b\bb Report whether the phototypesetter is busy or avail-
80	able. No text processing is done.
81
82	-\b-a\ba Send a printable ASCII approximation of the results
83	to the standard output.
84
85	-\b-p\bpN Print all characters in point size _\bN while retaining
86	all prescribed spacings and motions, to reduce photo-
87	typesetter elapsed time.
88
89	-\b-F\bF_\bf_\bo_\bn_\bt_\bd_\bi_\br
90	The directory _\bf_\bo_\bn_\bt_\bd_\bi_\br contains the font width tables
91	instead of the default directory /usr/lib/fonts. This
92	option can be used to produce output for devices
93	besides the phototypesetter.
94
95	If the file /_\bu_\bs_\br/_\ba_\bd_\bm/_\bt_\br_\ba_\bc_\bc_\bt is writable, _\bt_\br_\bo_\bf_\bf keeps photo-
96	typesetter accounting records there. The integrity of that
97	file may be secured by making _\bt_\br_\bo_\bf_\bf a 'set user-id' program.
98
99	F\bFI\bIL\bLE\bES\bS
100	/tmp/ta* temporary file
101	/usr/lib/tmac/tmac.* standard macro files
102	/usr/lib/term/* terminal driving tables for _\bn_\br_\bo_\bf_\bf
103	/usr/lib/font/* font width tables for _\bt_\br_\bo_\bf_\bf
104	/dev/cat phototypesetter
105	/usr/adm/tracct accounting statistics for /dev/cat
106
107	S\bSE\bEE\bE A\bAL\bLS\bSO\bO
108	J. F. Ossanna, _\bN_\br_\bo_\bf_\bf/_\bT_\br_\bo_\bf_\bf _\bu_\bs_\be_\br'_\bs _\bm_\ba_\bn_\bu_\ba_\bl
109	B. W. Kernighan, _\bA _\bT_\bR_\bO_\bF_\bF _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl
110	eqn(1), tbl(1), ms(7), me(7), man(7), col(1)
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129	Printed 7/9/88 April 29, 1985 2
130
131
132