Annotation of src/share/tmac/doc-common, Revision 1.2
1.1 deraadt 1: .\" Copyright (c) 1991 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms, with or without
5: .\" modification, are permitted provided that the following conditions
6: .\" are met:
7: .\" 1. Redistributions of source code must retain the above copyright
8: .\" notice, this list of conditions and the following disclaimer.
9: .\" 2. Redistributions in binary form must reproduce the above copyright
10: .\" notice, this list of conditions and the following disclaimer in the
11: .\" documentation and/or other materials provided with the distribution.
12: .\" 3. All advertising materials mentioning features or use of this software
13: .\" must display the following acknowledgement:
14: .\" This product includes software developed by the University of
15: .\" California, Berkeley and its contributors.
16: .\" 4. Neither the name of the University nor the names of its contributors
17: .\" may be used to endorse or promote products derived from this software
18: .\" without specific prior written permission.
19: .\"
20: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30: .\" SUCH DAMAGE.
31: .\"
32: .\" @(#)doc-common 5.7 (Berkeley) 8/5/91
33: .\"
34: .\" %beginstrip%
35: .nr %A 1
36: .nr %J 1
37: .nr %N 1
38: .nr %O 1
39: .nr %R 1
40: .nr %T 1
41: .nr %V 1
42: .nr Ad 12n
43: .nr Ac 3
44: .nr Ao 12n
45: .nr Ap 2
46: .nr An 12n
47: .nr Aq 12n
48: .nr Ar 12n
49: .nr Bc 3
50: .nr Bl 1
51: .nr Bo 12n
52: .nr Bq 12n
53: .nr Bx 12n
54: .nr Cd 12n
55: .nr Cm 10n
56: .nr Co 15n
57: .nr Cx 20n
58: .nr Dc 3
59: .nr Do 10n
60: .nr Dq 12n
61: .nr Ds 6n
62: .nr Dq 12n
63: .nr Dv 12n
64: .nr tI \n(Dsu
65: .nr Ec 3
66: .nr El 1
67: .nr Eo 12n
68: .nr Eq 12n
69: .nr Em 10n
70: .nr Er 12n
71: .nr Ev 15n
72: .nr Ex 10n
73: .nr Fa 12n
74: .nr Fl 10n
75: .nr Fc 3
76: .nr Fo 16n
77: .nr Fn 16n
78: .nr Hl 1
79: .nr I1 6n
80: .nr I2 12n
81: .nr I3 18n
82: .nr Ic 10n
83: .nr Li 16n
84: .nr Ms 6n
85: .nr Nm 10n
86: .nr No 12n
87: .nr Ns 2
88: .nr Oo 10n
89: .nr Oc 3
90: .nr Op 14n
91: .nr Pa 32n
92: .nr Pf 12n
93: .nr Pc 3
94: .nr Po 12n
95: .nr Pq 12n
96: .nr Ql 16n
97: .nr Qc 3
98: .nr Qo 12n
99: .nr Qq 12n
100: .nr Sc 3
101: .nr So 12n
102: .nr Sq 12n
103: .nr Sy 6n
104: .nr Sx 16n
105: .nr Ra 1
106: .nr Rj 1
107: .nr Rn 1
108: .nr Ro 1
109: .nr Rr 1
110: .nr Rt 1
111: .nr Rv 1
112: .nr Tn 10n
113: .nr Ta 1
114: .nr Tv 1
115: .nr Tx 22n
116: .nr Ux 10n
117: .nr Va 12n
118: .nr Xc 3
119: .nr Xo 1
120: .nr Xr 10n
121: .ds sV \& \&
122: .ds hV \&\ \&
123: .ds iV \& \&
124: .ds tV \&\\t\&
125: .\" Punctuation values (3 = closing punctuation, 4 = opening)
126: .nr z. 3
127: .nr z, 3
128: .nr z: 3
129: .nr z; 3
130: .nr z( 4
131: .nr z) 3
132: .nr z[ 4
133: .nr z] 3
134: .\" Matching pairs
135: .ds z( z)
136: .ds z[ z]
137: .ds z< z>
138: .\" This is disgusting, troff not parse ``if'' stmt properly
139: .nr z0 0
140: .nr z1 0
141: .nr z2 0
142: .nr z3 0
143: .nr z4 0
144: .nr z5 0
145: .nr z6 0
146: .nr z7 0
147: .nr z8 0
148: .nr z9 0
149: .nr z# 0
150: .\" Header assembly macros
151: .de Dt
152: .ds dT UNTITLED
153: .ds vT LOCAL
154: .ds cH Null
155: .if !"\\$1"" .ds dT \\$1
156: .if !"\\$2"" \{\
157: . ds cH \\$2
158: .\" . if "\\$3"" \{\
1.2 ! deraadt 159: . if \\$2>=1 .if \\$2<=9 \{\
1.1 deraadt 160: . ds vT NetBSD Reference Manual
161: . if \\$2>1 .if \\$2<6 .ds vT NetBSD Programmer's Manual
162: . if "\\$2"8" .ds vT NetBSD System Manager's Manual
1.2 ! deraadt 163: . if "\\$2"9" .ds vT NetBSD Kernel Manual
1.1 deraadt 164: . nr sN \\$2
165: . \}
166: . if "\\$2"unass" .ds vT DRAFT
167: . if "\\$2"draft" .ds vT DRAFT
168: . if "\\$2"paper" .ds vT UNTITLED
169: .\" . \}
170: .\}
171: .if !"\\$3"" \{\
172: . if "\\$3"USD" .ds vT NetBSD User's Supplementary Documents
173: . if "\\$3"PS1" .ds vT NetBSD Programmers's Supplementary Documents
174: . if "\\$3"AMD" .ds vT NetBSD Ancestral Manual Documents
175: . if "\\$3"SMM" .ds vT NetBSD System Manager's Manual
176: . if "\\$3"URM" .ds vT NetBSD Reference Manual
177: . if "\\$3"PRM" .ds vT NetBSD Programmers's Manual
1.2 ! deraadt 178: . if "\\$3"KM" .ds vT NetBSD Kernel Manual
1.1 deraadt 179: . if "\\$3"IND" .ds vT NetBSD Manual Master Index
180: .\" . if "\\$3"CON" .ds vT NetBSD Contributed Software Manual
181: .\" . if "\\$3"IMP" .ds vT NetBSD Implementation Notes
182: .\" . if "\\$3"HOW" .ds vT NetBSD How Pocket Manual
183: . if "\\$3"LOCAL" .ds vT NetBSD Local Manual
184: . if "\\$3"amiga" .as vT \ (AMIGA Architecture)
185: . if "\\$3"da30" .as vT \ (DA30 Architecture)
186: . if "\\$3"hp300" .as vT \ (HP300 Architecture)
187: . if "\\$3"i386" .as vT \ (I386 Architecture)
188: . if "\\$3"mac68k" .as vT \ (MAC68K Architecture)
189: . if "\\$3"pc532" .as vT \ (PC532 Architecture)
190: . if "\\$3"pmax" .as vT \ (PMAX Architecture)
191: . if "\\$3"sparc" .as vT \ (SPARC Architecture)
192: . if "\\$3"sun3" .as vT \ (SUN3 Architecture)
193: . if "\\$3"tahoe" .as vT \ (TAHOE Architecture)
194: . if "\\$3"vax" .as vT \ (VAX Architecture)
195: . if "\\*(vT"LOCAL" .ds vT \\$3
196: .\}
197: ..
198: .\" NS Os macro - Operating System (behaviour changes after first call)
199: .\" . ds vT \f(CODRAFT\fP\ \ \-\-\ \ \\*(vT\ \ \-\-\ \ \f(CODRAFT
200: .\" . ds dD \f(CODRAFT\fP\ \ \-\-\ \ \\*(dD\ \ \-\-\ \ \f(CODRAFT
201: .\" .ds vT \s+4\f(CODRAFT\fP\s-4\ \ \-\-\ \ \\*(vT\ \ \-\-\ \ \s+4\f(CODRAFT\s-4
202: .\" .ds dD \s+4\f(CODRAFT\fP\s-4\ \ \-\-\ \ \\*(dD\ \ \-\-\ \ \s+4\f(CODRAFT\s-4
203: .de Os
204: .ds oS Null
205: .if "\\$1"" \{\
206: . ds oS BSD Experimental
207: .\}
208: .if "\\$2"" \{\
209: . ds aa Non-Null
210: .\}
211: .if "\\$1"ATT" \{\
212: . ds oS AT&T
213: . if "\\$2"" .as oS \0UNIX
214: . if "\\$2"7th" .as oS \07th Edition
215: . if "\\$2"7" .as oS \07th Edition
216: . if "\\$2"III" .as oS \0System III
217: . if "\\$2"3" .as oS \0System III
218: . if "\\$2"V" .as oS \0System V
219: . if "\\$2"V.2" .as oS \0System V Release 2
220: . if "\\$2"V.3" .as oS \0System V Release 3
221: . if "\\$2"V.4" .as oS \0System V Release 4
222: .\}
223: .if "\\$1"BSD" \{\
224: . if "\\$2"3" .ds oS 3rd Berkeley Distribution
225: . if "\\$2"4" .ds oS 4th Berkeley Distribution
226: . if "\\$2"4.1" .ds oS 4.1 Berkeley Distribution
227: . if "\\$2"4.2" .ds oS 4.2 Berkeley Distribution
228: . if "\\$2"4.3" .ds oS 4.3 Berkeley Distribution
229: . if "\\$2"4.3T" .ds oS 4.3-Tahoe Berkeley Distribution
230: . if "\\$2"4.3R" .ds oS 4.3-Reno Berkeley Distribution
231: . if "\\$2"4.3t" .ds oS 4.3-Tahoe Berkeley Distribution
232: . if "\\$2"4.3r" .ds oS 4.3-Reno Berkeley Distribution
233: . if "\\$2"4.4" .ds oS BSD Experimental
234: .\}
235: .if "\\$1"NetBSD" \{\
236: . ds oS NetBSD
237: . if "\\$2"0.8" .as oS \00.8
238: . if "\\$2"0.8a" .as oS \00.8a
239: . if "\\$2"0.9" .as oS \00.9
240: . if "\\$2"0.9a" .as oS \00.9a
241: . if "\\$2"1.0" .as oS \01.0
242: . if "\\$2"1.1" .as oS \01.1 Experimental
243: .\}
244: .if "\\*(oS"Null" .ds oS \0\\$1
245: .if "\\*(aa"Non-Null" .as oS \0\\$2
246: .rm aa
247: ..
248: .de Dd
249: .if !"\\*(dD"" .nr gX 1
250: .ie \\n(.$>0 \{\
251: . ie \\n(.$==3 \{\
252: . ds dD \\$1 \\$2 \\$3
253: . \}
254: . el \{\
255: . if "\\n(mo"1" .ds dD January
256: . if "\\n(mo"2" .ds dD February
257: . if "\\n(mo"3" .ds dD March
258: . if "\\n(mo"4" .ds dD April
259: . if "\\n(mo"5" .ds dD May
260: . if "\\n(mo"6" .ds dD June
261: . if "\\n(mo"7" .ds dD July
262: . if "\\n(mo"8" .ds dD August
263: . if "\\n(mo"9" .ds dD September
264: . if "\\n(mo"10" .ds dD October
265: . if "\\n(mo"11" .ds dD November
266: . if "\\n(mo"12" .ds dD December
267: . as dD \&\ \\n(dy, 19\\n(yr
268: . \}
269: .\}
270: .el \{\
271: . ds dD Epoch
272: .\}
273: ..
274: .de hM
275: .ev 1
276: .pL
277: .if !\\n(cR 'sp \\n(Hmu
278: .tl @\\*(Hs\\*(hT\fP@\\*(Vs\\*(vT\fP@\\*(Hs\\*(hT\fP@
279: 'sp \\n(Hmu
280: .ev
281: ..
282: .de fM
283: .ie \\n(cR 'br
284: .el \{\
285: . ev 1
286: . pL
287: . if !\\n(cR \{\
288: ' sp \\n(Fmu
289: . tl @\\*(Hs\\*(oS\fP@\\*(Vs\\*(dD\fP@%@
290: ' bp
291: . \}
292: . ev
293: .\}
294: .\" .tm IN 444 fM .k == \\n(.k and nl == \\n(nl
295: ..
296: .de lM
297: .fl
298: .if \\n(cR \{\
299: ' sp
300: . tl @\\*(Hs\\*(oS\fP@\\*(Vs\\*(dD\fP@%@
301: . pl \\n(nlu
302: .\}
303: ..
304: .de Pp
305: .sp \\n(Ppu
306: .ne 2
307: .ns
308: ..
309: .de Lp
310: .Pp
311: ..
312: .de LP
313: .tm Not a \-mdoc command: .LP
314: ..
315: .de PP
316: .tm Not a \-mdoc command: .PP
317: ..
318: .de pp
319: .tm Not a \-mdoc command: .pp
320: ..
321: .de Nd
322: \&\-\& \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
323: ..
324: .de Ss
325: .sp
326: .ne 2
327: .ti -.25i
328: \&\\*(sH\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6 \|\\$7 \|\\$8 \|\\$9
329: \&\fP\s0
330: .ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
331: .if !\\n(cR .ne 2
332: .br
333: ..
334: .de Rd
335: .tm MDOC REGISTER DUMP
336: .tm Db==\\n(Db register DEBUG MODE
337: .tm L[0-9] registers - stack of list types
338: .tm L0==\\n(L0
339: .tm L1==\\n(L1
340: .tm L2==\\n(L2
341: .tm L3==\\n(L3
342: .tm L4==\\n(L4
343: .tm L5==\\n(L5
344: .tm L6==\\n(L6
345: .tm L7==\\n(L7
346: .tm L8==\\n(L8
347: .tm L9==\\n(L9
348: .tm O[0-9] registers - stack of indent
349: .tm O0==\\n(O0
350: .tm O1==\\n(O1
351: .tm O2==\\n(O2
352: .tm O3==\\n(O3
353: .tm O4==\\n(O4
354: .tm O5==\\n(O5
355: .tm O6==\\n(O6
356: .tm O7==\\n(O7
357: .tm O8==\\n(O8
358: .tm O9==\\n(O9
359: .tm aC==\\n(aC register argument counter (aV/fV)
360: .tm aJ==\\n(aJ register (for vR)
361: .tm aN==\\n(aN register
362: .tm aP==\\n(aP register argument pointer (aV)
363: .tm aT==\\n(aT register argument type
364: .tm aa==\\n(aa local register
365: .tm bK==\\n(bK register - Book Name flag
366: .tm cF==\\n(cF register save current font
367: .tm cI==\\n(cI register - column indent width
368: .tm cZ==\\n(cZ register save current font size
369: .tm dK==\\n(dK register - Date flag
370: .tm d[0-9] registers - display-type stack
371: .tm d0==\\n(d0
372: .tm d1==\\n(d1
373: .tm d2==\\n(d2
374: .tm d3==\\n(d3
375: .tm d4==\\n(d4
376: .tm d5==\\n(d5
377: .tm d6==\\n(d6
378: .tm d7==\\n(d7
379: .tm d8==\\n(d8
380: .tm d9==\\n(d9
381: .tm dZ==\\n(dZ register diversion count
382: .tm fD==\\n(fD register subroutine test (in synopsis only)
383: .tm fV==\\n(fV register argument counter (must set to \\n(.$ prior to
384: .tm fY==\\n(fY register - dick with old style function declarations (fortran)
385: .tm fZ==\\n(fZ register also subroutine count (in synopsis only)
386: .tm h[0-9] register horizontal tag stack (continuous if 1, break if
387: .tm h0==\\n(h0
388: .tm h1==\\n(h1
389: .tm h2==\\n(h2
390: .tm h3==\\n(h3
391: .tm h4==\\n(h4
392: .tm h5==\\n(h5
393: .tm h6==\\n(h6
394: .tm h7==\\n(h7
395: .tm h8==\\n(h8
396: .tm h9==\\n(h9
397: .tm iD==\\n(iD local register
398: .tm iI==\\n(iI local register (indent for inline debug mode)
399: .tm iN==\\n(iN register DEBUG MODE (inline if 1, to stderr if
400: .tm iS==\\n(iS register - indent second command line in a synopsis
401: .tm jK==\\n(jK register - [reference] Journal Name flag
402: .tm jM==\\n(jM local register
403: .tm jN==\\n(jN local register
404: .tm lC==\\n(lC register - list type stack counter
405: .tm lK==\\n(lK register count of lines read from input file
406: .tm nK==\\n(nK register - [reference] issue number flag
407: .tm nU==\\n(nU register count
408: .tm oK==\\n(oK register - [reference] optional information flag
409: .tm oM==\\n(oM register (extension possible)
410: .tm o[0-9] register offset stack (nested tags)
411: .tm o0==\\n(o0
412: .tm o1==\\n(o1
413: .tm o2==\\n(o2
414: .tm o3==\\n(o3
415: .tm o4==\\n(o4
416: .tm o5==\\n(o5
417: .tm o6==\\n(o6
418: .tm o7==\\n(o7
419: .tm o8==\\n(o8
420: .tm o9==\\n(o9
421: .tm oM==\\n(oM register open ended line flag
422: .tm pK==\\n(pK register - [reference] page number flag
423: .tm qK==\\n(qK register - Corporate or Foreign Author flag
424: .tm rK==\\n(rK register - [reference] report flag
425: .tm rS==\\n(rS register - Reference Start flag
426: .tm sM==\\n(sM register - default is one (space mode on)
427: .tm tK==\\n(tK register - reference title flag
428: .tm tP==\\n(tP register tag flag (for diversions)
429: .tm tX==\\n(tX register (initial class)
430: .tm tY==\\n(tY register (next possible lC value)
431: .tm t[0-9] register tag string stack (nested tags)
432: .tm t0==\\n(t0
433: .tm t1==\\n(t1
434: .tm t2==\\n(t2
435: .tm t3==\\n(t3
436: .tm t4==\\n(t4
437: .tm t5==\\n(t5
438: .tm t6==\\n(t6
439: .tm t7==\\n(t7
440: .tm t8==\\n(t8
441: .tm t9==\\n(t9
442: .tm uK==\\n(uK register - reference author(s) counter
443: .tm vK==\\n(vK register - reference volume flag
444: .tm v[0-9] register vertical tag break stack
445: .tm v0==\\n(v0
446: .tm v1==\\n(v1
447: .tm v2==\\n(v2
448: .tm v3==\\n(v3
449: .tm v4==\\n(v4
450: .tm v5==\\n(v5
451: .tm v6==\\n(v6
452: .tm v7==\\n(v7
453: .tm v8==\\n(v8
454: .tm v9==\\n(v9
455: .tm w[0-9] register tag stack (nested tags)
456: .tm w0==\\n(w0
457: .tm w1==\\n(w1
458: .tm w2==\\n(w2
459: .tm w3==\\n(w3
460: .tm w4==\\n(w4
461: .tm w5==\\n(w5
462: .tm w6==\\n(w6
463: .tm w7==\\n(w7
464: .tm w8==\\n(w8
465: .tm w9==\\n(w9
466: .tm xX==\\n(xX local register
467: .tm END OF REGISTER DUMP
468: ..