3 .\" Copyright (C) 1989, 1990, 1991, 1992, 2001 Free Software Foundation, Inc.
4 .\" Written by James Clark (jjc@jclark.com)
6 .\" This file is part of groff.
8 .\" groff is free software; you can redistribute it and/or modify it under
9 .\" the terms of the GNU General Public License as published by the Free
10 .\" Software Foundation; either version 2, or (at your option) any later
13 .\" groff is distributed in the hope that it will be useful, but WITHOUT ANY
14 .\" WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18 .\" You should have received a copy of the GNU General Public License along
19 .\" with groff; see the file COPYING. If not, write to the Free Software
20 .\" Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
22 .\" -rcR=1 => Create a single, very long page instead of multiple pages.
23 .\" Useful for online display. Default in nroff mode.
24 .\" Desactivate with -rcR=0.
25 .\" -rC1 => Number pages continuously, rather than start each at 1.
26 .\" -rD1 => Double-sided printing, ie different odd and even page footers.
27 .\" -rPnnn => Number first page nnn.
28 .\" -rSxx => Use size `xx'pt (either 10, 11, or 12) for document rather
29 .\" than the default size of 10pt.
30 .\" -rXnnn => Number pages after nnn as nnna, nnnb, nnnc, ...
32 .\" The file man.local is loaded at the end. Put local additions there.
33 .\" If you need to add things to TH, use `.am TH'.
36 .if !\n(.g .ab These man macros work only with groff.
41 .if (\n[.x]\n[.y]\n[.Y] < 1171) \
42 . ab You need GNU troff version 1.17.1 or higher to run this version of man!
47 .\" we must use consecutive page numbers when using postscript to generate
48 .\" html images, and we must not reset the page number at the beginning
49 .\" (the `ps4html' register is automatically added to the command line by
50 .\" the pre-html preprocessor)
59 .if '\*[.T]'html' .nr an-html 1
60 .if \n[an-html] .nr C 1
64 . nr an-margin \\n[IN]
67 .\" .TH title section extra1 extra2 extra3
74 . de an-init \" We have to do it like this to get multiple man pages right.
78 . ie (\\n[.$] > 3) .ds an-extra2 "\\$4
79 . el .ds an-extra2 \"Sun Release 4.0
80 . ie (\\n[.$] > 4) .ds an-extra3 "\\$5
81 . el .ds an-extra3 \"System Programmer's Manual
87 . nr PS 10z \" default point size
92 . \" use sizes similar to LaTeX
94 . ie (\\n[S] == 11) \{\
101 . if (\\n[S] == 12) \{\
115 . nr SN 3n \" the indentation of sub-sub-headings relative to sub-headings
118 . nr an-prevailing-indent \\n[IN]
121 . nr an-no-space-flag 0
130 . wh -.5i an-p-footer
132 . if (\\n[nl] > 0) \{\
133 . ie \\n[C] .bp (\\n[%] + 1)
139 .\" BSD compatibility macros: .AT and .UC
142 . ds an-extra2 "7th Edition
143 . if "\\$1"3" .ds an-extra2 "7th Edition
144 . if "\\$1"4" .ds an-extra2 "System III
146 . ie "\\$2"" .ds an-extra2 "System V
147 . el .ds an-extra2 "System V Release \\$2
152 . ds an-extra2 "3rd Berkeley Distribution
153 . if "\\$1"3" .ds an-extra2 "3rd Berkeley Distribution
154 . if "\\$1"4" .ds an-extra2 "4th Berkeley Distribution
155 . if "\\$1"5" .ds an-extra2 "4.2 Berkeley Distribution
156 . if "\\$1"6" .ds an-extra2 "4.3 Berkeley Distribution
157 . if "\\$1"7" .ds an-extra2 "4.4 Berkeley Distribution
161 . ta T .5i \" This sets tabs every .5 inches
165 . ie \\n[.$] .nr PD (v;\\$1)
166 . el .nr PD (.4v >? \n[.V])
179 . tl '\\*[an-title](\\*[an-section])'\\*[an-extra3]'\\*[an-title](\\*[an-section])'
199 . ie \\n[an-html] \{\
206 . if (\\n[%] > \\n[X]) \{\
207 . nr an-page-letter (\\n[%] - \\n[X])
208 . ds an-page-string \\n[X]\\n[an-page-letter]
213 . ds an-page-string "\\*[an-title](\\*[an-section])
215 . ds an-page-string \\n[%]
219 . if o .tl '\\*[an-extra2]'\\*[an-extra1]'\\*[an-page-string]'
220 . if e .tl '\\*[an-page-string]'\\*[an-extra1]'\\*[an-extra2]'
223 . tl '\\*[an-extra2]'\\*[an-extra1]'\\*[an-page-string]'
236 .if \n[cR] .em an-end
242 . nr an-prevailing-indent \\n[IN]
246 . HTML-TAG ".NH \\n[an-level]"
248 . nr an-no-space-flag 1
252 . if !\\n[cR] .ne (2v + 1u)
260 . nr an-prevailing-indent \\n[IN]
265 . nr an-no-space-flag 1
269 . if !\\n[cR] .ne (2v + 1u)
300 . if \\n[.$] .nr an-prevailing-indent (n;\\$1)
302 . if !\\n[an-div?] .di an-div
303 . ie \\n[an-html] .in \\n[an-margin]u
306 . ll -\\n[an-margin]u
315 . if \\n[an-break-flag] \{\
319 . if \\n[an-no-space-flag] \{\
321 . nr an-no-space-flag 0
323 . if \\n[an-div?] .an-do-tag
331 . ie (\\n[dl] + \\n[an-tag-sep] > \\n[an-prevailing-indent]) \{\
333 . if !\\n[cR] .ne (2v + 1u)
336 . in (\\n[an-margin]u + \\n[an-prevailing-indent]u)
339 . in (\\n[an-margin]u + \\n[an-prevailing-indent]u)
340 . ti -\\n[an-prevailing-indent]u
342 . if !\\n[cR] .ne (1v + 1u)
343 \\*[an-div]\\h'|\\n[an-prevailing-indent]u'\c
354 . nr an-prevailing-indent \\n[IN]
366 . if !\\n[cR] .ne (1v + 1u)
367 . in (\\n[an-margin]u + \\n[an-prevailing-indent]u)
370 . ie (\\n[.$] - 1) .TP "\\$2"
381 . if !\\n[cR] .ne (1v + 1u)
382 . if \\n[.$] .nr an-prevailing-indent (n;\\$1)
383 . in (\\n[an-margin]u + \\n[an-prevailing-indent]u)
387 .ds an-empty \" this is referenced to avoid looping on eg .RB ( \\ )
391 . ds an-result \&\\$1
393 . while (\\n[.$] >= 2) \{\
394 . as an-result \,\f[I]\\$1\f[R]\/\\$2\\*[an-empty]
397 . if \\n[.$] .as an-result \,\f[I]\\$1\f[R]
404 . ds an-result \&\f[I]\\$1\f[R]
406 . while (\\n[.$] >= 2) \{\
407 . as an-result \/\\$1\f[I]\,\\$2\f[R]
410 . if \\n[.$] .as an-result \/\\$1
417 . ds an-result \&\f[I]\\$1
419 . while (\\n[.$] >= 2) \{\
420 . as an-result \/\f[B]\\$1\f[I]\,\\$2\\*[an-empty]
423 . if \\n[.$] .as an-result \/\f[B]\\$1
431 . ds an-result \&\f[B]\\$1
433 . while (\\n[.$] >= 2) \{\
434 . as an-result \,\f[I]\\$1\f[B]\/\\$2\\*[an-empty]
437 . if \\n[.$] .as an-result \,\f[I]\\$1
445 . while (\\n[.$] >= 2) \{\
446 . as an-result \f[R]\\$1\f[B]\\$2\\*[an-empty]
449 . if \\n[.$] .as an-result \f[R]\\$1
456 . while (\\n[.$] >= 2) \{\
457 . as an-result \f[B]\\$1\f[R]\\$2\\*[an-empty]
460 . if \\n[.$] .as an-result \f[B]\\$1
467 . nr an-saved-margin\\n[an-level] \\n[an-margin]
468 . nr an-saved-prevailing-indent\\n[an-level] \\n[an-prevailing-indent]
469 . ie \\n[.$] .nr an-margin +(n;\\$1)
470 . el .nr an-margin +\\n[an-prevailing-indent]
472 . nr an-prevailing-indent \\n[IN]
478 . ie \\n[.$] .nr an-level ((;\\$1) <? \\n[an-level])
480 . nr an-level (1 >? \\n[an-level])
481 . nr an-margin \\n[an-saved-margin\\n[an-level]]
482 . nr an-prevailing-indent \\n[an-saved-prevailing-indent\\n[an-level]]
486 .\" these strings must work in compatibility mode also
489 .ie c\[rg] .ds R \(rg
491 .ie c\[tm] .ds Tm \(tm
496 .if !\n[an-html] .hy 14
498 .\" Load local modifications.
503 .\" end of an-old.tmac