internal update
[s-roff.git] / tmac / doc-ditroff
blob039db7dd06e5e99f703d5758658c40c23ea7c9ac
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-ditroff 5.8 (Berkeley) 8/5/91
33 .\"
34 .\" tmac.mdoc-ditroff
35 .\"     %beginstrip%
36 .\"
37 .\" -rC1 numbers pages continuously; initialize to avoid warnings
38 .if \n(.g .if !rC .nr C 0
39 .ds aD \fI\s10
40 .ds aR \f(CO\s10
41 .ds cM \f(CB\s10
42 .ds dF \fR\s10
43 .ds eM \fI\s10
44 .ds eR \fC\s10
45 .ds eV \fC\s10
46 .ds fA \f(CO\s10
47 .ds fD \f(CB\s10
48 .ds fL \f(CB\s10
49 .ds fN \f(CB\s10
50 .ds fP \fP\s0
51 .ds fS \s0
52 .ds fT \f(CO\s10
53 .ds Hs \fR\s10
54 .ds iC \f(CB\s10
55 .ds lI \fC
56 .ds lP \fR\|(\|\fP\s10
57 .ds lp \fR(\fP\s10
58 .ds rP \fR\|)\|\fP\s10
59 .ds rp \fR)\fP\s10
60 .ds lB \fR\^[\^\fP\s10
61 .ds rB \fR\^]\fP\s10
62 .ds mL \fB\s10
63 .ds nM \f(CB\s10
64 .ds nO \fR\s10
65 .ds nT \s0
66 .ds pA \fC\s10
67 .ds Pu \fR{\ .\ ,\ :\ ;\ (\ )\ [\ ]\ \fR}
68 .ds rA \fR\s10
69 .ds rT \f(CO\s10
70 .ds sH \fB\s10
71 .ds sP \s0
72 .ds sY \fB\s10
73 .ds sX \fR\s10
74 .ds tF \fR
75 .ds tN \s9
76 .ds vA \fI\s10
77 .ds Vs \fR\s10
78 .ds vT \f(CB\s10
79 .ds xR \fC\s10
80 .tr *\(**
81 .nr sI \w\a\fC,\au*5
82 .nr Ti \n(sIu
83 .nr Pp .5v
84 .ds lS \0
85 .nr lS \w'\0'u
86 .nr dI 6n
87 .de pL
88 .nr Hm .5i
89 .nr Fm .5i
90 .nr ll 6.5i
91 .ll 6.5i
92 .nr lt 6.5i
93 .lt 6.5i
94 .nr po 1i
95 .po 1.i
96 .nr dV .5v
98 .ds <= \(<=
99 .ds >= \(>=
100 .ie \n(.g \{\
101 .       ds Lq \(lq
102 .       ds Rq \(rq
104 .el \{\
105 .       ds Lq \&``
106 .       ds Rq \&''
108 .ds ua \(ua
109 .ds aa \(aa
110 .ds ga \(ga
111 .ds sR \&'
112 .ds sL \&`
113 .ds q \&"
114 .\" Math stuff
115 .ds Pi \(*p
116 .ds Ne \(!=
117 .ds Le \(<=
118 .ds Ge \(>=
119 .ds Lt <
120 .ds Gt >
121 .ds Pm \(+-
122 .ds If \(if
123 .ds Na \fINaN\fP
124 .ds Ba \fR\&|\fP
126 .nr gX 0
127 .de hK
128 .ds hT \\*(dT
129 .if !"\\*(cH"Null" \{\
130 .       ie !"\\*(gP"Null" .as hT \|(\|\\*(cH\\*(gP\|)
131 .       el .as hT \\|(\\|\\*(cH\\|)
133 .if "\\*(cH"Null" \{\
134 .       if !"\\*(gP"Null" .as hT \&\|(\|\\*(gP\|)
136 .wh 0 hM
137 .wh -1.25i fM
138 .nr nL \\n(nl
139 .ie \\n(gX==1 \{\
140 .       rm n1
141 .       bp
143 .el \{\
144 '       bp
146 .\" Don't set the page number if this is the first page,
147 .\" in case the user has used -n.
148 .if \\n(nL>0 \{\
149 .       if !\\nC \{\
150 .               nr % 1
151 .       \}
153 .nr gX 0
154 .em lM
157 .nr fW \w\a\fC0\a
158 .de sW
159 .nr sW \w\a\fC\\$1\a
160 .ie \\n(sW>=\\n(fW \{\
161 .       ie \\n(sW%\\n(fW .nr sW (\\n(sW/\\n(fW)+1
162 .       el .nr sW \\n(sW/\\n(fW
164 .el \{\
165 .       ie \\n(sW>0 .nr sW 1
166 .       el .nr sW 0
170 .de aW
171 .nr sW \w\a\fC\\*(A\\$1\a
172 .ie \\n(sW>=\\n(fW \{\
173 .       ie \\n(sW%\\n(fW .nr sW (\\n(sW/\\n(fW)+1
174 .       el .nr sW \\n(sW/\\n(fW
176 .el \{\
177 .       ie \\n(sW>0 .nr sW 1
178 .       el .nr sW 0
181 .\" NS Ql macro - Quoted literal define
182 .de Ql
183 .if \\n(aC==0  \{\
184 .       ds mN Ql
185 .       ds A1 \\$1
186 .       ds A2 \\$2
187 .       ds A3 \\$3
188 .       ds A4 \\$4
189 .       ds A5 \\$5
190 .       ds A6 \\$6
191 .       ds A7 \\$7
192 .       ds A8 \\$8
193 .       nr fV \\n(.$
194 .       fV
196 .nr aP \\n(aP+1
197 .aW \\n(aP
198 .nr aP \\n(aP-1
199 .if \\n(sW>2 .Li
200 .if \\n(sW<=2 \{\
201 .\" Db on
202 .       if (\\n(aP>0) \{\
203 .               ds A\\n(aP Li
204 .               nr aP \\n(aP -1
205 .       \}              
206 .       if (\\n(aP==0) \{\
207 .               rm C0 C1 C2 C3 C4 C5 C6 C7 C8 C9
208 .               rm S1 S2 S3 S4 S5 S6 S7 S8 S9
209 .               rn A8 A9
210 .               rn A7 A8
211 .               rn A6 A7
212 .               rn A5 A6
213 .               rn A4 A5
214 .               rn A3 A4
215 .               rn A2 A3
216 .               rn A1 A2
217 .               ds A1 Li
218 .               nr fV \\n(aC+1
219 .               nr aC 0
220 .               fV
221 .       \}
222 .       ds qL \&\\*(sL
223 .       ds qR \&\\*(sR
224 .       En
225 .\" Db off
228 .\" NS Sh macro - Section Headers
229 .\" NS nS register - Section Header SYNOPSIS flag
230 .\" NS nF register - Section Header FILES flag
231 .\" NS nA register - Section Header SEE ALSO flag
232 .\" NS nT register - Section Header STANDARDS flag
233 .de Sh
234 .nr nS 0
235 .nr sE 0
236 .nr iS 0
238 .ie "\\$1"NAME" \{\
239 .       hK
240 '       in 0
242 .el \{\
243 .       nr nS 0
244 .       nr nA 0
245 .       nr nF 0
246 .       nr nT 0
247 .       nr nY 0
248 .       nr oT 0
249 .       if "\\$1"SYNOPSIS" \{\
250 .               na
251 .               nr nS 1
252 .       \}
253 .       if "\\$1"DESCRIPTION" \{\
254 .               nr fY 0
255 .               nr fZ 0
256 .               nr fB 0
257 .               nr Fb 0
258 .               ds Fb
259 .       \}
260 .       if "\\$1"SEE" \{\
261 .               nr nA 1
262 .               na
263 .       \}
264 .       if "\\$1"FILES" .nr nF 1
265 .       if "\\$1"STANDARDS" .nr nT 1
266 .       if "\\$1"AUTHORS" .nr nY 1
267 .       if "\\$1"SEE" .nr sE 1
268 .       in 0
269 .       nr aN 0
274 .ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
275 .if !\\n(cR .ne 3
277 \&\\*(sH\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6 \|\\$7 \|\\$8 \|\\$9
278 \&\fP\s0\&
279 .in \\n(.iu+\\n(Tiu