1 .TH TROFF 1
2 .SH NAME
3 troff, nroff \- text formatting and typesetting
4 .SH SYNOPSIS
5 .B troff
6 [
7 .I option ...
8 ]
9 [
10 .I file ...
11 ]
12 .PP
13 .B nroff
14 [
15 .I option ...
16 ]
17 [
18 .I file ...
19 ]
20 .SH DESCRIPTION
21 .I Troff
22 formats text in the named
23 .I files
24 for
25 printing on a typesetter.
26 .I Nroff
27 does the same, but produces output suitable
28 for typewriter-like devices.
29 .PP
30 If no
31 .I file
32 argument is present, the standard input is read.
33 An argument consisting of a single minus
34 .RB ( - )
35 is taken to be
36 a file name corresponding to the standard input.
37 The options are:
38 .nr xx \w'\fL-m\f2name\ \ '
39 .TP \n(xxu
40 .BI -o list
41 Print pages in the comma-separated
42 .I list
43 of numbers and ranges.
44 A range
45 .IB N - M
46 means 
47 .I N
48 through
49 .IR M ;
50 initial
51 .BI - M
52 means up to
53 .IR M ;
54 final
55 .IB N -
56 means from
57 .I N
58 to the end.
59 .TP
60 .BI -n N
61 Number first generated page
62 .IR N .
63 .TP
64 .BI -m name
65 Process the macro file
66 .BI /sys/lib/tmac/tmac. name
67 before the input
68 .IR files .
69 .TP
70 .BI -r aN
71 Set register
72 .I a
73 (one character name) to
74 .IR N .
75 .TP
76 .B -i
77 Read standard input after the input files are exhausted.
78 .TP
79 .B -q
80 Invoke the simultaneous input-output mode of the
81 .B rd
82 request.
83 .TP
84 .B -N
85 Produce output suitable for typewriter-like devices.
86 .SS Typesetter devices (not \fL-N\fP) only
87 .TP \n(xxu
88 .B -a
89 Send a printable
90 textual
91 approximation
92 of the results to the standard output.
93 .TP
94 .BI -T dest
95 Prepare output for typesetter
96 .IR dest :
97 .br
98 .ns
99 .RS
100 .TP \w'\fL-TLatin1\ 'u
101 .B -Tutf
102 (The default.) PostScript printers with
103 preprocessing to handle Unicode
104 characters encoded in
105 .SM UTF
106 .PD0
107 .TP
108 .B -Tpost
109 Regular PostScript printers
110 .PD0
111 .TP
112 .B -T202
113 Mergenthaler Linotron 202 
114 .RE
115 .PD
116 .TP "\w'\fL-m\f2name 'u"
117 .BI -F dir
118 Take font information from directory
119 .IR dir .
120 .SS Typewriter (\fL-N\fP) output only
121 .TP \n(xxu
122 .BI -s N
123 Halt prior to every
124 .I N
125 pages (default
126 .IR N =1)
127 to allow paper loading or changing.
128 .TP
129 .BI -T name
130 Prepare output for specified terminal.
131 Known
132 .I names
133 include
134 .B utf
135 for the normal Plan 9
136 .SM UTF
137 encoding of the Unicode Standard character set (default),
138 .B 37
139 for the
140 Teletype model 37,
141 .B lp
142 (`line-printer')
143 for any terminal without half-line capability,
144 .B 450
145 for the \s-1DASI\s+1-450
146 (Diablo Hyterm),
147 and
148 .B think
149 (HP ThinkJet).
150 .TP
151 .B -e
152 Produce equally-spaced words in adjusted
153 lines, using full terminal resolution.
154 .TP
155 .B -h
156 Use output tabs during horizontal spacing
157 to speed output and reduce output character count.
158 Tab settings are assumed to be every
159 8 nominal character widths.
160 .SH FILES
161 .TF \*9/troff/term/*
162 .TP
163 .B /tmp/trtmp*
164 temporary file
165 .TP
166 .B \*9/tmac/tmac.*
167 standard macro files
168 .TP
169 .B \*9/troff/term/*
170 terminal driving tables for
171 .I nroff
172 .TP
173 .B \*9/troff/font/*
174 font width tables for
175 .I troff
176 .SH SOURCE
177 .B \*9/src/cmd/troff
178 .SH "SEE ALSO"
179 .MR lpr (1) ,
180 .MR proof (1) ,
181 .MR tr2post (1) ,
182 .IR eqn (1), 
183 .IR tbl (1), 
184 .IR pic (1), 
185 .MR grap (1) ,
186 .IR doctype (1), 
187 .MR ms (7) ,
188 .MR image (7) ,
189 .MR tex (1) ,
190 .MR deroff (1)
191 .br
192 J. F. Ossanna and B. W. Kernighan,
193 ``Troff User's Manual''
194 .br
195 B. W. Kernighan,
196 ``A TROFF Tutorial'',
197 .I
198 Unix Research System Programmer's Manual,
199 Tenth Edition, Volume 2.