troff.1 - 9base - revived minimalist port of Plan 9 userland to Unix | |
git clone git://git.suckless.org/9base | |
Log | |
Files | |
Refs | |
README | |
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. |