1.\" Copyright (c) 1991, 1993
2.\" The Regents of the University of California. 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-nroff 8.1 (Berkeley) 06/08/93
33.\" $FreeBSD: head/contrib/groff/tmac/doc-nroff 75589 2001-04-17 12:28:00Z ru $
34.\"
35.\" %beginstrip%
36.
37.
38.eo
39.
40.\" use -rD=1 for double-sided printing
41.
42.if !r D .nr D 0
43.
44.\" use -rcR=0 to have multiple pages instead of a single, very long page
45.
46.if !r cR .nr cR 1
47.
48.\" the following switches are ignored in nroff mode
49.
50.nr S 10
51.nr C 0
52.
53.\" the `doc-xx-font' strings must not be empty!
54.
55.ds doc-caption-font \f[R]
56.ds doc-caption-font2 \f[R]
57.ds doc-Ad-font \f[I]
58.ds doc-Ar-font \f[I]
59.ds doc-Cm-font \f[B]
60.ds doc-Em-font \f[I]
61.ds doc-Er-font \f[R]
62.ds doc-Ev-font \f[R]
63.ds doc-Fa-font \f[I]
64.ds doc-Fd-font \f[B]
65.ds doc-Fl-font \f[B]
66.ds doc-Fn-font \f[B]
67.ds doc-Ft-font \f[I]
68.ds doc-Ic-font \f[B]
69.ds doc-Li-font \f[R]
70.ds doc-Me-font \f[B]
71.ds doc-Nm-font \f[B]
72.ds doc-No-font \f[R]
73.ds doc-Pa-font \f[I]
74.ds doc-Sh-font \f[B]
75.ds doc-Sy-font \f[B]
76.ds doc-Sx-font \f[I]
77.ds doc-Tn-font-shape \f[R]
78.ds doc-Tn-font-size
79.ds doc-Va-font \f[I]
80.ds doc-Xr-font \f[R]
81.
82.ds doc-left-parenthesis \f[R](\f[P]
83.ds doc-right-parenthesis \f[R])\f[P]
84.ds lp \f[R](\f[P]
85.ds rp \f[R])\f[P]
86.ds doc-left-bracket \f[R][\f[P]
87.ds doc-right-bracket \f[R]]\f[P]
88.
89.\" miscellaneous
90.nr doc-subheader-indent .5i
91.nr doc-paragraph-space 1v
92.
93.ec
94.nr doc-digit-width \w'\0\0'u
95.nr doc-fixed-width \w'0'
96.eo
97.
98.
99.\" NS doc-header-space global register
100.\" NS the space between header and body
101.
102.nr doc-header-space 0
103.
104.
105.\" NS doc-footer-space global register
106.\" NS the space between body and footer
107.
108.nr doc-footer-space 0
109.
110.
111.\" NS doc-display-vertical global register
112.\" NS vertical space between list elements etc.
113.
114.nr doc-display-vertical 0
115.
116.
117.\" NS doc-setup-page-layout macro
118.\" NS set up page layout
119.\" NS
120.\" NS modifies:
121.\" NS doc-display-vertical
122.\" NS doc-footer-space
123.\" NS doc-header-space
124.
125.de doc-setup-page-layout
126. ie \n[cR] \
127. nr doc-header-space 0
128. el \
129. nr doc-header-space .5i
130. nr doc-footer-space .5i
131.
132. ll 78n
133. lt 78n
134. po 0i
135.
136. nr doc-display-vertical 1v
137. ad l
138. na
139..
140.
141.
142.ec
143.
144.ds doc-left-singlequote \[oq]
145.ds doc-right-singlequote \[cq]
146.
147.\" the following strings are `official'
148.ds <= \[<=]
149.ds >= \[>=]
150.ds aa \[aa]
151.ds ga \[ga]
152.ds q \[dq]
153.ds Ne \[!=]
154.ds Le \[<=]
155.ds Ge \[>=]
156.ds Lt <
157.ds Gt >
158.ds Pm \[+-]
159.ds Na \f[I]NaN\f[P]
160.ds Ba \f[R]|\f[P]
161.
162.\" Unicode TTYs have all glyph forms; for other TTY character sets we need
163.\" character representations which are different from GNU troff's standard
164.\" forms.
165.ie '\*[.T]'utf8' \{\
166. ds Rq \[rq]
167. ds Lq \[lq]
168. ds ua \[ua]
169. ds Pi \[*p]
170. ds If \[if]
171.\}
172.el \{\
173. ds Rq ''
174. ds Lq ``
175. ds ua ^
176. ds Pi pi
177. ds If infinity
178.\}
179.
180.eo
181.
182.
183.\" NS doc-header-string global string
184.\" NS the final string used for the manual page header
185.
186.ds doc-header-string
187.
188.
189.\" NS doc-setup-header macro
190.\" NS install and initialize header and footer support
191.\" NS
192.\" NS modifies:
193.\" NS doc-header-string
194.
195.de doc-setup-header
196. nr % 1
197. ds doc-header-string "\*[doc-document-title]
198. if !"\*[doc-section]"Null" \
199. as doc-header-string (\*[doc-section])
200.
201. ie \n[cR] \
202. doc-header
203. el \{\
204. wh 0 doc-header
205. wh -1.167i doc-footer
206. \}
207.
208. if ((\n[nl] == 0) : (\n[nl] == -1)) \
209' bp
210.
211. e@ doc-end-macro
212..
213.
214.
215.\" NS doc-get-width macro
216.\" NS computes the width of a string as a multiple of `doc-fixed-width':
217.\" NS `.doc-get-width string'
218.\" NS
219.\" NS modifies:
220.\" NS doc-width
221.
222.de doc-get-width
223. nr doc-width \w\$1
224. ie (\n[doc-width] >= \n[doc-fixed-width]) \{\
225. ie (\n[doc-width] % \n[doc-fixed-width]) \
226. nr doc-width ((\n[doc-width] / \n[doc-fixed-width]) + 1)
227. el \
228. nr doc-width (\n[doc-width] / \n[doc-fixed-width])
229. \}
230. el \
231. nr doc-width 0
232..
233.
234.
235.\" NS doc-get-arg-width macro
236.\" NS computes the width of an argument as a multiple of
237.\" NS `doc-fixed-width': `.doc-get-arg-width arg-index'
238.\" NS
239.\" NS modifies:
240.\" NS doc-width
241.
242.de doc-get-arg-width
243. nr doc-width \w\*[doc-arg\$1]
244. ie (\n[doc-width] >= \n[doc-fixed-width]) \{\
245. ie (\n[doc-width] % \n[doc-fixed-width]) \
246. nr doc-width ((\n[doc-width] / \n[doc-fixed-width]) + 1)
247. el \
248. nr doc-width (\n[doc-width] / \n[doc-fixed-width])
249. \}
250. el \
251. nr doc-width 0
252..
253.
254.
255.\" NS Ql user macro
256.\" NS quoted literal define
257.\" NS
258.\" NS modifies:
259.\" NS doc-macro-name
260.\" NS doc-quote-left
261.\" NS doc-quote-right
262.\" NS
263.\" NS width register `Ql' set in doc-common
264.
265.de Ql
266. if !\n[doc-arg-limit] \{\
267. ie \n[.$] \
268. ds doc-macro-name Ql
269. el \
270. tm Usage: .Ql argument ... (#\n[.c])
271. \}
272.
273. ds doc-quote-left "\*[doc-left-singlequote]
274. ds doc-quote-right "\*[doc-right-singlequote]
275.
276. doc-enclose-string \$@
277..
278.
279.
280.ec
281.
282.\" EOF
2.\" The Regents of the University of California. 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-nroff 8.1 (Berkeley) 06/08/93
33.\" $FreeBSD: head/contrib/groff/tmac/doc-nroff 75589 2001-04-17 12:28:00Z ru $
34.\"
35.\" %beginstrip%
36.
37.
38.eo
39.
40.\" use -rD=1 for double-sided printing
41.
42.if !r D .nr D 0
43.
44.\" use -rcR=0 to have multiple pages instead of a single, very long page
45.
46.if !r cR .nr cR 1
47.
48.\" the following switches are ignored in nroff mode
49.
50.nr S 10
51.nr C 0
52.
53.\" the `doc-xx-font' strings must not be empty!
54.
55.ds doc-caption-font \f[R]
56.ds doc-caption-font2 \f[R]
57.ds doc-Ad-font \f[I]
58.ds doc-Ar-font \f[I]
59.ds doc-Cm-font \f[B]
60.ds doc-Em-font \f[I]
61.ds doc-Er-font \f[R]
62.ds doc-Ev-font \f[R]
63.ds doc-Fa-font \f[I]
64.ds doc-Fd-font \f[B]
65.ds doc-Fl-font \f[B]
66.ds doc-Fn-font \f[B]
67.ds doc-Ft-font \f[I]
68.ds doc-Ic-font \f[B]
69.ds doc-Li-font \f[R]
70.ds doc-Me-font \f[B]
71.ds doc-Nm-font \f[B]
72.ds doc-No-font \f[R]
73.ds doc-Pa-font \f[I]
74.ds doc-Sh-font \f[B]
75.ds doc-Sy-font \f[B]
76.ds doc-Sx-font \f[I]
77.ds doc-Tn-font-shape \f[R]
78.ds doc-Tn-font-size
79.ds doc-Va-font \f[I]
80.ds doc-Xr-font \f[R]
81.
82.ds doc-left-parenthesis \f[R](\f[P]
83.ds doc-right-parenthesis \f[R])\f[P]
84.ds lp \f[R](\f[P]
85.ds rp \f[R])\f[P]
86.ds doc-left-bracket \f[R][\f[P]
87.ds doc-right-bracket \f[R]]\f[P]
88.
89.\" miscellaneous
90.nr doc-subheader-indent .5i
91.nr doc-paragraph-space 1v
92.
93.ec
94.nr doc-digit-width \w'\0\0'u
95.nr doc-fixed-width \w'0'
96.eo
97.
98.
99.\" NS doc-header-space global register
100.\" NS the space between header and body
101.
102.nr doc-header-space 0
103.
104.
105.\" NS doc-footer-space global register
106.\" NS the space between body and footer
107.
108.nr doc-footer-space 0
109.
110.
111.\" NS doc-display-vertical global register
112.\" NS vertical space between list elements etc.
113.
114.nr doc-display-vertical 0
115.
116.
117.\" NS doc-setup-page-layout macro
118.\" NS set up page layout
119.\" NS
120.\" NS modifies:
121.\" NS doc-display-vertical
122.\" NS doc-footer-space
123.\" NS doc-header-space
124.
125.de doc-setup-page-layout
126. ie \n[cR] \
127. nr doc-header-space 0
128. el \
129. nr doc-header-space .5i
130. nr doc-footer-space .5i
131.
132. ll 78n
133. lt 78n
134. po 0i
135.
136. nr doc-display-vertical 1v
137. ad l
138. na
139..
140.
141.
142.ec
143.
144.ds doc-left-singlequote \[oq]
145.ds doc-right-singlequote \[cq]
146.
147.\" the following strings are `official'
148.ds <= \[<=]
149.ds >= \[>=]
150.ds aa \[aa]
151.ds ga \[ga]
152.ds q \[dq]
153.ds Ne \[!=]
154.ds Le \[<=]
155.ds Ge \[>=]
156.ds Lt <
157.ds Gt >
158.ds Pm \[+-]
159.ds Na \f[I]NaN\f[P]
160.ds Ba \f[R]|\f[P]
161.
162.\" Unicode TTYs have all glyph forms; for other TTY character sets we need
163.\" character representations which are different from GNU troff's standard
164.\" forms.
165.ie '\*[.T]'utf8' \{\
166. ds Rq \[rq]
167. ds Lq \[lq]
168. ds ua \[ua]
169. ds Pi \[*p]
170. ds If \[if]
171.\}
172.el \{\
173. ds Rq ''
174. ds Lq ``
175. ds ua ^
176. ds Pi pi
177. ds If infinity
178.\}
179.
180.eo
181.
182.
183.\" NS doc-header-string global string
184.\" NS the final string used for the manual page header
185.
186.ds doc-header-string
187.
188.
189.\" NS doc-setup-header macro
190.\" NS install and initialize header and footer support
191.\" NS
192.\" NS modifies:
193.\" NS doc-header-string
194.
195.de doc-setup-header
196. nr % 1
197. ds doc-header-string "\*[doc-document-title]
198. if !"\*[doc-section]"Null" \
199. as doc-header-string (\*[doc-section])
200.
201. ie \n[cR] \
202. doc-header
203. el \{\
204. wh 0 doc-header
205. wh -1.167i doc-footer
206. \}
207.
208. if ((\n[nl] == 0) : (\n[nl] == -1)) \
209' bp
210.
211. e@ doc-end-macro
212..
213.
214.
215.\" NS doc-get-width macro
216.\" NS computes the width of a string as a multiple of `doc-fixed-width':
217.\" NS `.doc-get-width string'
218.\" NS
219.\" NS modifies:
220.\" NS doc-width
221.
222.de doc-get-width
223. nr doc-width \w\$1
224. ie (\n[doc-width] >= \n[doc-fixed-width]) \{\
225. ie (\n[doc-width] % \n[doc-fixed-width]) \
226. nr doc-width ((\n[doc-width] / \n[doc-fixed-width]) + 1)
227. el \
228. nr doc-width (\n[doc-width] / \n[doc-fixed-width])
229. \}
230. el \
231. nr doc-width 0
232..
233.
234.
235.\" NS doc-get-arg-width macro
236.\" NS computes the width of an argument as a multiple of
237.\" NS `doc-fixed-width': `.doc-get-arg-width arg-index'
238.\" NS
239.\" NS modifies:
240.\" NS doc-width
241.
242.de doc-get-arg-width
243. nr doc-width \w\*[doc-arg\$1]
244. ie (\n[doc-width] >= \n[doc-fixed-width]) \{\
245. ie (\n[doc-width] % \n[doc-fixed-width]) \
246. nr doc-width ((\n[doc-width] / \n[doc-fixed-width]) + 1)
247. el \
248. nr doc-width (\n[doc-width] / \n[doc-fixed-width])
249. \}
250. el \
251. nr doc-width 0
252..
253.
254.
255.\" NS Ql user macro
256.\" NS quoted literal define
257.\" NS
258.\" NS modifies:
259.\" NS doc-macro-name
260.\" NS doc-quote-left
261.\" NS doc-quote-right
262.\" NS
263.\" NS width register `Ql' set in doc-common
264.
265.de Ql
266. if !\n[doc-arg-limit] \{\
267. ie \n[.$] \
268. ds doc-macro-name Ql
269. el \
270. tm Usage: .Ql argument ... (#\n[.c])
271. \}
272.
273. ds doc-quote-left "\*[doc-left-singlequote]
274. ds doc-quote-right "\*[doc-right-singlequote]
275.
276. doc-enclose-string \$@
277..
278.
279.
280.ec
281.
282.\" EOF