troff.1 - 9base - revived minimalist port of Plan 9 userland to Unix
(HTM) git clone git://git.suckless.org/9base
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
troff.1 (3099B)
---
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 .IR lpr (1),
180 .IR proof (1),
181 .IR tr2post (1),
182 .IR eqn (1),
183 .IR tbl (1),
184 .IR pic (1),
185 .IR grap (1),
186 .IR doctype (1),
187 .IR ms (7),
188 .IR image (7),
189 .IR tex (1),
190 .IR 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.