1 .fp 1 R LuxiSans
2 .fp 2 I LuxiSans-Oblique
3 .fp 3 B LuxiSans-Bold
4 .fp 4 BI LuxiSans-BoldOblique
5 .fp 5 L LuxiMono
6 .ds 9 /usr/local/plan9
7 .if n .uf 4
8 .if n .bd 3
9 .if n .rm bd
10 '''\"	PWB Manual Entry Macros - 1.36 of 11/11/80
11 '''\"	Nroff/Troff Version	@(#)1.36
12 '''\"  Option -rs1 short (9") pages
13 '''\"  Option -rp# set no. of first page, put no. of pgs. on stderr
14 '''\"  Option -rd1 give modified date instead of printed date
15 ... temporary fixes for neat manual printing...
16 .de th
17 .tm wrong version of man entry macros - use -man6
18 .ab 
19 ..
20 .if n .ds Tm \uTM\d
21 .if t .ds Tm \v'-0.5m'\s-4TM\s+4\v'0.5m'
22 .de }E
23 .}f
24 .in \\n()Ru+\\n(INu
25 .ll \\n(LLu
26 .lt \\n(LLu
27 .pl \\n()Lu
28 ..
29 .de DT
30 .if t .ta 3.6m 7.2m 10.8m 14.4m 18m 21.6m 25.2m 28.8m 32.4m 36m 39.6m 43.2m 46.8m
31 .if n .ta 5n 10n 15n 20n 25n 30n 35n 40n 45n 50n 55n 60n 65n
32 ..
33 .de HY
34 .hy 14
35 ..
36 .de }f
37 .if t .vs \\n()Vp
38 .ps \\n()S
39 .ft 1
40 ..
41 .de }H
42 .ev 1
43 .}C
44 .}E
45 .ie \\n()s 'sp |2v
46 .el 'sp |3v
47 .". ps\\n()S-1
48 .tl \\*(]H\\*(]L\\*(]H
49 .ft 1
50 .ps \\n()S
51 .ie \\n()s 'sp 1.5v
52 .el 'sp 3v
53 .ev
54 .ns
55 .if \\n(CL .2C
56 ..
57 .de }F
58 .ev 1
59 .}E
60 .if \\n()s 'sp |\\n(.pu-1v-1p
61 .if \\n()t 'sp |\\n(.pu-3v
62 .if n 'sp |\\n(.pu-4v
63 .if n .tl Page %\\*(]D\\*(]W
64 .if t .tl %
65 .ev
66 'bp
67 ..
68 .if n .ig
69 .de }C
70 .if "\\*(.T"aps"\{\
71 .	p o0i
72 .	l t7.5i
73 .	i f\\n()s .tl \l0.25i\l0.25i\h1i\l0.25i
74 .	i f\\n()t .tl \l0.25i\l0.25i
75 .	l t
76 .	p o\}
77 ..
78 .de }M
79 .}N
80 .wh -.5p }C
81 .ll \\n(LLu
82 .}P
83 ..
84 .de }K
85 .}N
86 .pl 1
87 .ll \\n(LLu
88 ..
89 .de }P
90 .nr )P \\n%+1-\\np
91 .if \\nq .tm \\n(.F \\n()P \\np
92 .bp
93 .if \\nq .nr p \\n%
94 ..
95 .de TH
96 .PD
97 .nr IN \\n()Mu
98 .if t .ds ]H \\$1\^(\^\\$2\^)
99 .if n .ds ]H \\$1(\\$2)
100 .if \\n()s .ds ]D
101 .if \\n()t .ds ]D Plan 9
102 .if n .ds ]D Plan 9
103 .ds ]L
104 .if !\\$3 .ds ]L (\^\\$3\^)
105 .if !\\$4 .ds ]D \\$4
106 .wh 0 }H
107 .wh -\\n(:mu }F
108 .em }M
109 .if \\n(nl .}P
110 .nr )I \\n()Mu
111 .nr )R 0
112 .}E
113 .DT
114 .if n \{.na
115 .nh \}
116 .if t \{.bd S 3 3
117 .HY \}
118 \Xhtml <B>
119 \Xhtml [<A HREF="/sys/man/index.html">manual index</A>]
120 \Xhtml [<A HREF="/sys/man/\\$2/INDEX.html">section index</A>]
121 \Xhtml </B>
122 ..
123 .de HR
124 .ie '\\$2'' \\$4\X'html href \\$1'\fL\\$1\fP\X'html /href'\\$3
125 .el \\$4\X'html href \\$1'\\$2\X'html /href'\\$3
126 ..
127 .de SH
128 .PD
129 .}X 0 "\\$1"
130 .nr )E 2
131 \&\Xhtml <H4>\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>
132 ..
133 .de SS
134 .PD
135 .}X 3n "" ""
136 .nr )E 2
137 \Xhtml <H4>\&\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>
138 ..
139 .de }X
140 .}E
141 .ti \\$1
142 .sp \\n(PDu
143 .ne 1.1v
144 .nr )R 0
145 .fi
146 '''ss12
147 '''if\\$2SYNOPSIS .ss 18
148 .it 1 }N
149 .if !\\$3 .SM
150 .ft 3
151 ..
152 .de }2
153 .nr )E 0
154 .}E
155 .nr )I \\n()Mu
156 .ns
157 .ft 1
158 ..
159 .de SM
160 .nh
161 .ps \\n()S-1
162 .if !\\$1 \&\\$1
163 .if !\\$2 \&\\$2
164 .if !\\$3 \&\\$3
165 .if !\\$4 \&\\$4
166 .if !\\$5 \&\\$5
167 .if !\\$6 \&\\$6
168 .if !\\$1 .ps \\n()S
169 .if \\$1 .it 1 }N
170 .HY
171 ..
172 .de I
173 .nh
174 .ft 2
175 .it 1 }N
176 .if !\\$1 \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
177 .HY
178 ..
179 .de B
180 .nh
181 .it 1 }N
182 .ie !\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
183 .el .ft5
184 .HY
185 ..
186 .de L
187 .nh
188 .it 1 }N
189 .if t \{.ie!\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
190 .el .ft5 \}
191 .if n \{.ft5
192 .if !\\$1 \{.ie\\$2 `\\$1'
193 .el .ie\\$3 `\\$1 \\$2'
194 .el .ie\\$4 `\\$1 \\$2 \\$3'
195 .el .ie\\$5 `\\$1 \\$2 \\$3 \\$4'
196 .el .ie\\$6 `\\$1 \\$2 \\$3 \\$4 \\$5'
197 .el `\\$1 \\$2 \\$3 \\$4 \\$5 \\$6'\}\}
198 .HY
199 ..
200 .de RI
201 .nh
202 .}S 1 2 \& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
203 .HY
204 .}f
205 ..
206 .de IR
207 .nh
208 .}S 2 1 \& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
209 .HY
210 .}f
211 ..
212 .\" MR - manual reference, as in .MR cat (1) ,
213 .\" $3 is the punctuation after the reference ends, if any.
214 .de MR
215 .nh
216 .}S 2 1 \& "\Xhtml manref start \\$1 \\$2\\$1" "\\$2\Xhtml manref end \\$1 \\$2\\$3"
217 .HY
218 .}f
219 ..
220 .de IB
221 .nh
222 .if t .}S 2 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
223 .if n .}S 2 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
224 .HY
225 .}f
226 ..
227 .de RB
228 .nh
229 .if t .}S 1 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
230 .if n .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
231 .HY
232 .}f
233 ..
234 .de BR
235 .nh
236 .if t .}S 5 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
237 .if n .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
238 .HY
239 .}f
240 ..
241 .de BI
242 .nh
243 .if t .}S 5 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
244 .if n .}S 1 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
245 .HY
246 .}f
247 ..
248 .de LR
249 .nh
250 .if t \%\&\f5\\$1\f1\\$2
251 .if n \%`\\$1'\\$2
252 .HY
253 ..
254 .de RL
255 .nh
256 .if t \%\&\f1\\$1\\f5\\$2\\f1\\$3
257 .if n \%\\$1`\\$2'\\$3
258 .HY
259 ..
260 .de }S
261 .ds ]F
262 .if \\$12 .if !\\$5 .ds ]F \^
263 .if \\$22 .if !\\$5 .ds ]F \^
264 .ie !\\$4 .}S \\$2 \\$1 "\\$3\f\\$1\\$4\\*(]F" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
265 .el \\$3
266 .}f
267 ..
268 .de EX
269 .if t .ft5
270 .nf
271 ..
272 .de EE
273 .ft 1
274 .fi
275 ..
276 .de }p
277 .sp \\n(PDu
278 .ne 1.1v
279 .}E
280 .nr )I \\n()Mu
281 .ns
282 ..
283 .de PP  \"indirect PP so we can attach html - see tmac.anhtml
284 .}p
285 ..
286 .de P
287 .PP
288 ..
289 .de LP
290 .PP
291 ..
292 .de PD
293 .if t .nr PD .4v
294 .if n .nr PD 1v
295 .if !\\$1 .nr PD \\$1v
296 ..
297 .de HP
298 .sp \\n(PDu
299 .ne 1.1v
300 .if !\\$1 .nr )I \\$1n
301 .ll \\n(LLu
302 .in \\n()Ru+\\n(INu+\\n()Iu
303 .ti \\n()Ru+\\n(INu
304 .}f
305 ..
306 .de IP
307 .ie !\\$1 \{.TP "\\$2"
308 \&\\$1\}
309 .el \{.sp\\n(PDu
310 .ne 1.1v
311 .if !\\$2 .nr )I \\$2n
312 .}f
313 .ll \\n(LLu
314 .in \\n()Ru+\\n(INu+\\n()Iu
315 .lg \}
316 ..
317 .de TP
318 .if !\\$1 \{.nr )I \\$1n
319 .if \\$10 .nr )I \\n()M\}
320 .sp \\n(PDu
321 .ne 1.1v
322 .in \\n()Ru
323 .lg 0
324 .ns
325 .it 1 }N
326 .nr )E 1
327 .di ]B
328 ..
329 .de TF
330 .IP "" "\w'\f5\\$1\ \ \fP'u"
331 .PD 0
332 ..
333 .de }1
334 .ds ]X \&\\*(]B\\
335 .rm ]B
336 .nr )E 0
337 .if !\\$1 .nr )I \\$1n
338 .}f
339 .ll \\n(LLu
340 .in \\n()Ru+\\n(INu+\\n()Iu
341 .ti \\n(INu
342 .ie !\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\\*(]X
343 .br \}
344 .el \\*(]X\h|\\n()Iu+\\n()Ru\c
345 .}f
346 .lg
347 ..
348 .de }N
349 .if \\n()E .br
350 .if \\n()E1 .di
351 .if \\n()E0 .}f
352 .if \\n()E1 .}1
353 .if \\n()E2 .}2
354 ..
355 .de RS
356 .nr ]\\n+()p \\n()I
357 .nr )\\n()p \\n()R
358 .ie !\\$1 .nr )R +\\$1n
359 .el .nr )R +\\n()I
360 .nr )I \\n()Mu
361 .}E
362 ..
363 .de RE
364 .if !\\$1 \{.ie \\$10 .nr )p 1 1
365 .el .nr )p \\$1 1 \}
366 .ds ]i \\*(]I\\n()p
367 .ds ]r \\*(]R\\n()p
368 .nr )I \\*(]i
369 .nr )R \\*(]r
370 .if \\n()p .nr )p -1
371 .}E
372 ..
373 '''\"	.2C begin 2-column display, by diversion
374 '''\"   CC=amount of text that will fit on page
375 '''\"	CL=1 multicolumn in effect, else 0
376 '''\"	CI saved indent
377 '''\"	CB contains diverted text
378 .de 2C
379 .ne 2
380 .nf
381 .nr CC \\n(.t/1v*2v
382 .nr CI \\n(IN
383 .nr IN 0
384 .di CB
385 .nr CL 1
386 .}E
387 .dt \\n(CCu C1
388 ..
389 '''\"	.1C return to 1-column
390 .de 1C
391 .nr CL 0
392 .C1
393 .fi
394 ..
395 '''\"	end of diversion, at end of page or return to 1-column
396 '''\"	CC=pos of nominal column end
397 .de C1
398 .dt
399 \!.C3
400 .di
401 .if \\n(dn \{.nr CC \\n(dnu/2u+\\n(nlu
402 .wh \\n(CCu C2
403 .mk
404 .nf
405 .nr IN \\n(CIu
406 .}E
407 .CB \}
408 ..
409 '''\"	end of first column retrieved from diversion
410 '''\"	CC=pos of actual column end
411 .de C2
412 .wh \\n(CCu
413 .mk CC
414 .po +(\\n(LLu/2u)u
415 .rt
416 .if \\n(dn>1v .ns
417 ..
418 '''\"	end of second column
419 .de C3
420 .br
421 .po -(\\n(LLu/2u)u
422 .if \\n(CC>\\n(nl .sp |\\n(CCu
423 .ne 2
424 ..
425 .de PM
426 .if \\$1 .nr !K 0
427 .if \w\\$1 \{\
428 .ie \\$1P .nr !K 1
429 .el .ie \\$1BP .nr !K 3
430 .el .ie \\$1BR .nr !K 4
431 .el .nr !K 2 \}
432 .if \\n(!K .wh -(\\n(:mu+5v) )G
433 ..
434 .de )G
435 .if \\n(!K 'sp 2v
436 .ie \\n(!K=1 \{\
437 .ie t .bd1 3
438 .el .bd1 0
439 .tl PRIVATE
440 .bd 1
441 .tl This information should not be disclosed to unauthorized persons.
442 .tl It is meant solely for use by authorized Bell System employees. \}
443 .el .ie \\n(!K=3 \{\
444 .ie t .bd1 3
445 .el .bd1 0
446 .tl BELL LABORATORIES PROPRIETARY
447 .bd 1
448 .tl Not for use or disclosure outside Bell Laboratories except by
449 .tl written approval of the director of the distributing organization. \}
450 .el .ie \\n(!K=4 \{\
451 .ie t .bd1 3
452 .el .bd1 0
453 .tl BELL LABORATORIES RESTRICTED
454 .bd 1
455 .tl The information herein is meant solely for use by authorized
456 .tl Bell Laboratories employees and is not to be disclosed to others. \}
457 .el .if \\n(!K=2 \{\
458 .ie t .bd1 3
459 .el .bd1 0
460 .tl NOTICE
461 .bd 1
462 .tl Not for use or disclosure outside the
463 .tl Bell System except under written agreement. \}
464 ..
465 .nr )s 0
466 .if t .if \ns .nr )s 1
467 .nr )t 0
468 .if t .if !\ns .nr )t 1
469 .if \n()s \{.nr )L 9i
470 .nr LL 4.75i
471 .nr )O .75i
472 .nr )S 8
473 .nr )V 9 \}
474 .if \n()t \{.nr )L 11i
475 .nr LL 6.5i
476 .nr )O 1i
477 .nr )S 9
478 .nr )V 11 \}
479 .if t \{.ds R ®
480 .ds S \s\n()S
481 ..\}
482 .if n \{.nr )L 11i
483 .nr LL 6.5i
484 .nr )O .463i
485 .if '\*(.T'think' \{.nrLL 80n
486 .nr )O 0\}
487 .if '\*(.T'thinksmall' \{.nrLL 142n
488 .vs 9p
489 .nr )O 0\}
490 .ds R (Reg.)
491 .ds S
492 ..\}
493 .if \nT .nr LL 80n
494 .if \nV>1 \{
495 .nr LL 82n
496 .nr )L 84v
497 .rm ul \}
498 .nr )p 0 1
499 .ds ]I \\\\n(]
500 .ds ]R \\\\n()
501 .if \nd0 .nr m \n(mo-1
502 .if \nm0 .ds ]m January
503 .if \nm1 .ds ]m February
504 .if \nm2 .ds ]m March
505 .if \nm3 .ds ]m April
506 .if \nm4 .ds ]m May
507 .if \nm5 .ds ]m June
508 .if \nm6 .ds ]m July
509 .if \nm7 .ds ]m August
510 .if \nm8 .ds ]m September
511 .if \nm9 .ds ]m October
512 .if \nm10 .ds ]m November
513 .if \nm11 .ds ]m December
514 .if n \{.nr m \nm+1
515 .nr yD (\n(yr%100
516 .af yD 01
517 .ie \nd .ds ]W (last mod. \nm/\nd/\ny)
518 .el .ds ]W (printed \n(mo/\n(dy/\n(yD)
519 ..\}
520 .if \n()s .ds ]W
521 .if \n()t \{.ie \nd .ds ]W \*(]m \nd, 20\ny
522 .el .ds ]W \*(]m \n(dy, 20\n(yr
523 ..\}
524 .pl \n()Lu
525 .ll \n(LLu
526 .lt \n(LLu
527 .po \n()Ou
528 .if t .tr \``\''
529 .}f
530 .if \n()s .nr :m 3.5v
531 .if \n()t .nr :m 6v
532 .if n .nr :m 7v
533 .if t .nr )M 3.6m
534 .if n .nr )M 5n
535 .em }K
536 .nr q \np
537 .if !\np .nr p 1
538 .pn \np