contrib/groff/tmac/doc-common

   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. [Deleted.  See
  13 .\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change]
  14 .\" 4. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\"     @(#)doc-common  8.1 (Berkeley) 06/08/93
  31 .\"
  32 .\"     %beginstrip%
  33 .
  34 .
  35 .\" Macro Identifiers.  For each user macro a corresponding register with
  36 .\" the same name must exist.  Its value must not be zero.
  37 .
  38 .nr %A 1
  39 .nr %B 1
  40 .nr %C 1
  41 .nr %D 1
  42 .nr %I 1
  43 .nr %J 1
  44 .nr %N 1
  45 .nr %O 1
  46 .nr %P 1
  47 .nr %Q 1
  48 .nr %R 1
  49 .nr %T 1
  50 .nr %U 1
  51 .nr %V 1
  52 .nr Ac 3
  53 .nr Ad 12n
  54 .nr An 12n
  55 .nr Ao 12n
  56 .nr Ap 2
  57 .nr Aq 12n
  58 .nr Ar 12n
  59 .nr At 1
  60 .nr Bc 3
  61 .nr Bf 8n\" ?
  62 .nr Bk 8n\" ?
  63 .nr Bl 1
  64 .nr Bo 12n
  65 .nr Bq 12n
  66 .nr Brc 3
  67 .nr Bro 12n
  68 .nr Brq 12n
  69 .nr Bsx 1
  70 .nr Bt 8n\" ?
  71 .nr Bx 1
  72 .nr Cd 12n
  73 .nr Cm 10n
  74 .nr D1 8n\" ?
  75 .nr Dc 3
  76 .nr Dl 8n\" ?
  77 .nr Dt 8n\" ?
  78 .nr Do 12n
  79 .nr Dq 12n
  80 .nr Ds 6n\" many manpages still use this as a -width value
  81 .nr Dv 12n
  82 .nr Dx 1
  83 .nr Ec 3
  84 .nr Ef 8n\" ?
  85 .nr Ek 8n\" ?
  86 .nr El 1
  87 .nr Em 10n
  88 .nr En 12n
  89 .nr Eo 12n
  90 .nr Eq 12n
  91 .nr Er 17n
  92 .nr Es 12n
  93 .nr Ev 15n
  94 .nr Ex 1
  95 .nr Fa 12n
  96 .nr Fc 3
  97 .nr Fd 12n\" ?
  98 .nr Fl 10n
  99 .nr Fn 16n
 100 .nr Fo 16n
 101 .nr Fr 12n\" ?
 102 .nr Ft 8n\" ?
 103 .nr Fx 1
 104 .nr Ic 10n
 105 .nr In 12n
 106 .nr It 8n\" ?
 107 .nr Lb 11n
 108 .nr Li 16n
 109 .nr Lk 6n\" ?
 110 .nr Lp 8n\" ?
 111 .nr Me 6n
 112 .nr Ms 6n
 113 .nr Mt 6n\" ?
 114 .nr Nd 8n\" ?
 115 .nr Nm 10n
 116 .nr No 12n
 117 .nr Ns 2
 118 .nr Nx 1
 119 .nr Oc 3
 120 .nr Oo 10n
 121 .nr Op 14n
 122 .nr Os 6n\" ?
 123 .nr Ox 1
 124 .nr Pa 32n
 125 .nr Pc 3
 126 .nr Pf 12n
 127 .nr Po 12n
 128 .nr Pp 8n\" ?
 129 .nr Pq 12n
 130 .nr Qc 3
 131 .nr Ql 16n
 132 .nr Qo 12n
 133 .nr Qq 12n
 134 .nr Rv 1
 135 .nr Sc 3
 136 .nr Sh 8n
 137 .nr Sm 8n\" ?
 138 .nr So 12n
 139 .nr Sq 12n
 140 .nr Ss 8n
 141 .nr St 8n\" ?
 142 .nr Sx 16n
 143 .nr Sy 6n
 144 .nr Ta 2
 145 .nr Tn 10n
 146 .nr Ud 8n\" ?
 147 .nr Ux 1
 148 .nr Va 12n
 149 .nr Vt 8n\" ?
 150 .nr Xc 3
 151 .nr Xo 1
 152 .nr Xr 10n
 153 .
 154 .
 155 .\" macros which must be processed after the closing delimiter of `Op'
 156 .\" and friends
 157 .ds doc-after-Ao
 158 .ds doc-after-Bo
 159 .ds doc-after-Bro
 160 .ds doc-after-Do
 161 .ds doc-after-Eo
 162 .ds doc-after-Fo
 163 .ds doc-after-Ns
 164 .ds doc-after-Oo
 165 .ds doc-after-Po
 166 .ds doc-after-Qo
 167 .ds doc-after-So
 168 .ds doc-after-Xo
 169 .
 170 .
 171 .nr doc-display-indent 6n
 172 .
 173 .
 174 .\" space strings
 175 .
 176 .ds doc-soft-space " \"
 177 .ds doc-hard-space \~
 178 .ds doc-tab \t
 179 .
 180 .
 181 .eo
 182 .
 183 .
 184 .\" punctuation values (suffix=3, prefix=4)
 185 .
 186 .nr doc-punct. 3
 187 .nr doc-punct, 3
 188 .nr doc-punct: 3
 189 .nr doc-punct; 3
 190 .nr doc-punct( 4
 191 .nr doc-punct) 3
 192 .nr doc-punct[ 4
 193 .nr doc-punct] 3
 194 .nr doc-punct? 3
 195 .nr doc-punct! 3
 196 .
 197 .
 198 .\" header assembly macros
 199 .
 200 .\" NS doc-document-title global string
 201 .\" NS   the title of the manual page
 202 .
 203 .ds doc-document-title UNTITLED
 204 .
 205 .
 206 .\" NS doc-volume global string
 207 .\" NS   the volume where the manual page belongs to
 208 .
 209 .ds doc-volume LOCAL
 210 .
 211 .
 212 .\" NS doc-section global string
 213 .\" NS   the manual section
 214 .
 215 .ds doc-section Null
 216 .
 217 .
 218 .\" NS Dt user macro (not parsed, not callable)
 219 .\" NS   document title
 220 .\" NS
 221 .\" NS modifies:
 222 .\" NS   doc-document-title
 223 .\" NS   doc-section
 224 .\" NS   doc-volume
 225 .\" NS   doc-command-name
 226 .\" NS
 227 .\" NS local variables:
 228 .\" NS   doc-volume-as-XXX
 229 .\" NS   doc-volume-ds-XXX
 230 .\" NS
 231 .\" NS width register `Dt' set above
 232 .
 233 .\" an alternative, more detailed scheme for naming the manual sections
 234 .\"
 235 .ds doc-volume-operating-system BSD
 236 .nr doc-volume-operating-system-ateol 0
 237 .ds doc-volume-ds-1 General Commands Manual
 238 .ds doc-volume-ds-2 System Calls Manual
 239 .ds doc-volume-ds-3 Library Functions Manual
 240 .ds doc-volume-ds-4 Kernel Interfaces Manual
 241 .ds doc-volume-ds-5 File Formats Manual
 242 .ds doc-volume-ds-6 Games Manual
 243 .ds doc-volume-ds-7 Miscellaneous Information Manual
 244 .ds doc-volume-ds-8 System Manager's Manual
 245 .ds doc-volume-ds-9 Kernel Developer's Manual
 246 .
 247 .ds doc-volume-ds-USD   User's Supplementary Documents
 248 .ds doc-volume-ds-PS1   Programmer's Supplementary Documents
 249 .ds doc-volume-ds-AMD   Ancestral Manual Documents
 250 .ds doc-volume-ds-SMM   System Manager's Manual
 251 .ds doc-volume-ds-URM   User's Reference Manual
 252 .ds doc-volume-ds-PRM   Programmer's Manual
 253 .ds doc-volume-ds-KM    Kernel Manual
 254 .ds doc-volume-ds-IND   Manual Master Index
 255 .ds doc-volume-ds-LOCAL Local Manual
 256 .ds doc-volume-ds-CON   Contributed Software Manual
 257 .
 258 .als doc-volume-ds-MMI doc-volume-ds-IND
 259 .als doc-volume-ds-LOC doc-volume-ds-LOCAL
 260 .
 261 .ds doc-volume-as-alpha        alpha
 262 .als doc-volume-as-Alpha doc-volume-as-alpha
 263 .ds doc-volume-as-acorn26      acorn26
 264 .ds doc-volume-as-acorn32      acorn32
 265 .ds doc-volume-as-algor        algor
 266 .ds doc-volume-as-amd64        amd64
 267 .ds doc-volume-as-amiga        amiga
 268 .ds doc-volume-as-amigappc     amigappc
 269 .ds doc-volume-as-arc          arc
 270 .ds doc-volume-as-arm          arm
 271 .ds doc-volume-as-arm26        arm26
 272 .ds doc-volume-as-arm32        arm32
 273 .ds doc-volume-as-armish       armish
 274 .ds doc-volume-as-atari        atari
 275 .ds doc-volume-as-aviion       aviion
 276 .ds doc-volume-as-beagle       beagle
 277 .ds doc-volume-as-bebox        bebox
 278 .ds doc-volume-as-cats         cats
 279 .ds doc-volume-as-cesfic       cesfic
 280 .ds doc-volume-as-cobalt       cobalt
 281 .ds doc-volume-as-dreamcast    dreamcast
 282 .ds doc-volume-as-emips        emips
 283 .ds doc-volume-as-evbarm       evbarm
 284 .ds doc-volume-as-evbmips      evbmips
 285 .ds doc-volume-as-evbppc       evbppc
 286 .ds doc-volume-as-evbsh3       evbsh3
 287 .ds doc-volume-as-ews4800mips  ews4800mips
 288 .ds doc-volume-as-hp300        hp300
 289 .ds doc-volume-as-hp700        hp700
 290 .ds doc-volume-as-hpcarm       hpcarm
 291 .ds doc-volume-as-hpcmips      hpcmips
 292 .ds doc-volume-as-hpcsh        hpcsh
 293 .ds doc-volume-as-hppa         hppa
 294 .ds doc-volume-as-hppa64       hppa64
 295 .ds doc-volume-as-i386         i386
 296 .ds doc-volume-as-ia64         ia64
 297 .ds doc-volume-as-ibmnws       ibmnws
 298 .ds doc-volume-as-iyonix       iyonix
 299 .ds doc-volume-as-landisk      landisk
 300 .ds doc-volume-as-loongson     loongson
 301 .ds doc-volume-as-luna68k      luna68k
 302 .ds doc-volume-as-luna88k      luna88k
 303 .ds doc-volume-as-m68k         m68k
 304 .ds doc-volume-as-mac68k       mac68k
 305 .ds doc-volume-as-macppc       macppc
 306 .ds doc-volume-as-mips         mips
 307 .ds doc-volume-as-mips64       mips64
 308 .ds doc-volume-as-mipsco       mipsco
 309 .ds doc-volume-as-mmeye        mmeye
 310 .ds doc-volume-as-mvme68k      mvme68k
 311 .ds doc-volume-as-mvme88k      mvme88k
 312 .ds doc-volume-as-mvmeppc      mvmeppc
 313 .ds doc-volume-as-netwinder    netwinder
 314 .ds doc-volume-as-news68k      news68k
 315 .ds doc-volume-as-newsmips     newsmips
 316 .ds doc-volume-as-next68k      next68k
 317 .ds doc-volume-as-ofppc        ofppc
 318 .ds doc-volume-as-palm         palm
 319 .ds doc-volume-as-pc532        pc532
 320 .ds doc-volume-as-playstation2 playstation2
 321 .ds doc-volume-as-pmax         pmax
 322 .ds doc-volume-as-pmppc        pmppc
 323 .ds doc-volume-as-powerpc      powerpc
 324 .ds doc-volume-as-prep         prep
 325 .ds doc-volume-as-rs6000       rs6000
 326 .ds doc-volume-as-sandpoint    sandpoint
 327 .ds doc-volume-as-sbmips       sbmips
 328 .ds doc-volume-as-sgi          sgi
 329 .ds doc-volume-as-sgimips      sgimips
 330 .ds doc-volume-as-sh3          sh3
 331 .ds doc-volume-as-shark        shark
 332 .ds doc-volume-as-socppc       socppc
 333 .ds doc-volume-as-solbourne    solbourne
 334 .ds doc-volume-as-sparc        sparc
 335 .ds doc-volume-as-sparc64      sparc64
 336 .ds doc-volume-as-sun2         sun2
 337 .ds doc-volume-as-sun3         sun3
 338 .ds doc-volume-as-tahoe        tahoe
 339 .ds doc-volume-as-vax          vax
 340 .ds doc-volume-as-x68k         x68k
 341 .ds doc-volume-as-x86_64       x86_64
 342 .ds doc-volume-as-xen          xen
 343 .ds doc-volume-as-zaurus       zaurus
 344 .
 345 .de Dt
 346 .  \" reset default arguments
 347 .  ds doc-document-title UNTITLED
 348 .  ds doc-volume LOCAL
 349 .  ds doc-section Null
 350 .  ds doc-command-name
 351 .
 352 .  if !"\$1"" \
 353 .    ds doc-document-title "\$1
 354 .
 355 .  if !"\$2"" \{\
 356 .    ds doc-section \$2
 357 .    ie \B\a\$2\a \{\
 358 .      if ((\$2 >= 1) & (\$2 <= 9)) \{\
 359 .        ie \n[doc-volume-operating-system-ateol] \{\
 360 .          ds doc-volume "\*[doc-volume-ds-\$2] \*[doc-volume-operating-system]
 361 .          if \A\a\$3\a \{\
 362 .            if d doc-volume-as-\$3 \
 363 .              as doc-volume "/\*[doc-volume-as-\$3]
 364 .        \}\}
 365 .        el \{\
 366 .          ds doc-volume "\*[doc-volume-operating-system]
 367 .          if \A\a\$3\a \{\
 368 .            if d doc-volume-as-\$3 \
 369 .              as doc-volume "/\*[doc-volume-as-\$3]
 370 .          \}
 371 .          as doc-volume " \*[doc-volume-ds-\$2]
 372 .    \}\}\}
 373 .    el \{\
 374 .      ie "\$2"unass" \
 375 .        ds doc-volume DRAFT
 376 .      el \{ .ie "\$2"draft" \
 377 .        ds doc-volume DRAFT
 378 .      el .if "\$2"paper" \
 379 .        ds doc-volume UNTITLED
 380 .      \}\}
 381 .      if \A\a\$3\a \{\
 382 .        if d doc-volume-ds-\$3 \
 383 .          ds doc-volume "\*[doc-volume-ds-\$3]
 384 .  \}\}\}
 385 .
 386 .  if !"\$3"" \
 387 .    if "\*[doc-volume]"LOCAL" \
 388 .      ds doc-volume \$3
 389 .
 390 .  if !\n[cR] \
 391 .    if \n[nl] \{\
 392   .    doc-setup-header
 393 .      bp
 394 .    \}
 395 ..
 396 .
 397 .
 398 .\" NS doc-default-operating-system global string
 399 .\" NS   the exact (default) version of the operating system
 400 .\" NS
 401 .\" NS override this in `mdoc.local', if necessary
 402 .
 403 .ds doc-default-operating-system BSD
 404 .
 405 .
 406 .\" NS doc-operating-system global string
 407 .\" NS   the exact version of the operating system
 408 .
 409 .ds doc-operating-system
 410 .
 411 .
 412 .\" NS Os user macro (not parsed, not callable)
 413 .\" NS   operating system
 414 .\" NS
 415 .\" NS modifies:
 416 .\" NS   doc-operating-system
 417 .\" NS   doc-command-name
 418 .\" NS
 419 .\" NS local variables:
 420 .\" NS   doc-operating-system-XXX-XXX
 421 .\" NS
 422 .\" NS width register `Os' set above
 423 .
 424 .ds doc-operating-system-ATT-7   7th\~Edition
 425 .als doc-operating-system-ATT-7th doc-operating-system-ATT-7
 426 .ds doc-operating-system-ATT-3   System\~III
 427 .als doc-operating-system-ATT-III doc-operating-system-ATT-3
 428 .ds doc-operating-system-ATT-V   System\~V
 429 .ds doc-operating-system-ATT-V.2 System\~V Release\~2
 430 .ds doc-operating-system-ATT-V.3 System\~V Release\~3
 431 .ds doc-operating-system-ATT-V.4 System\~V Release\~4
 432 .
 433 .ds doc-operating-system-BSD-3    3rd\~Berkeley Distribution
 434 .ds doc-operating-system-BSD-4    4th\~Berkeley Distribution
 435 .ds doc-operating-system-BSD-4.1  4.1\~Berkeley Distribution
 436 .ds doc-operating-system-BSD-4.2  4.2\~Berkeley Distribution
 437 .ds doc-operating-system-BSD-4.3  4.3\~Berkeley Distribution
 438 .ds doc-operating-system-BSD-4.3T 4.3-Tahoe Berkeley Distribution
 439 .ds doc-operating-system-BSD-4.3R 4.3-Reno Berkeley Distribution
 440 .als doc-operating-system-BSD-4.3t doc-operating-system-BSD-4.3T
 441 .als doc-operating-system-BSD-4.3r doc-operating-system-BSD-4.3R
 442 .ds doc-operating-system-BSD-4.4  4.4BSD
 443 .
 444 .ds doc-operating-system-NetBSD-0.8   0.8
 445 .ds doc-operating-system-NetBSD-0.8a  0.8A
 446 .ds doc-operating-system-NetBSD-0.9   0.9
 447 .ds doc-operating-system-NetBSD-0.9a  0.9A
 448 .ds doc-operating-system-NetBSD-1.0   1.0
 449 .ds doc-operating-system-NetBSD-1.0a  1.0A
 450 .ds doc-operating-system-NetBSD-1.1   1.1
 451 .ds doc-operating-system-NetBSD-1.2   1.2
 452 .ds doc-operating-system-NetBSD-1.2a  1.2A
 453 .ds doc-operating-system-NetBSD-1.2b  1.2B
 454 .ds doc-operating-system-NetBSD-1.2c  1.2C
 455 .ds doc-operating-system-NetBSD-1.2d  1.2D
 456 .ds doc-operating-system-NetBSD-1.2e  1.2E
 457 .ds doc-operating-system-NetBSD-1.3   1.3
 458 .ds doc-operating-system-NetBSD-1.3a  1.3A
 459 .ds doc-operating-system-NetBSD-1.4   1.4
 460 .ds doc-operating-system-NetBSD-1.4.1 1.4.1
 461 .ds doc-operating-system-NetBSD-1.4.2 1.4.2
 462 .ds doc-operating-system-NetBSD-1.4.3 1.4.3
 463 .ds doc-operating-system-NetBSD-1.5   1.5
 464 .ds doc-operating-system-NetBSD-1.5.1 1.5.1
 465 .ds doc-operating-system-NetBSD-1.5.2 1.5.2
 466 .ds doc-operating-system-NetBSD-1.5.3 1.5.3
 467 .ds doc-operating-system-NetBSD-1.6   1.6
 468 .ds doc-operating-system-NetBSD-1.6.1 1.6.1
 469 .ds doc-operating-system-NetBSD-1.6.2 1.6.2
 470 .ds doc-operating-system-NetBSD-1.6.3 1.6.3
 471 .ds doc-operating-system-NetBSD-2.0   2.0
 472 .ds doc-operating-system-NetBSD-2.0.1 2.0.1
 473 .ds doc-operating-system-NetBSD-2.0.2 2.0.2
 474 .ds doc-operating-system-NetBSD-2.0.3 2.0.3
 475 .ds doc-operating-system-NetBSD-2.1   2.1
 476 .ds doc-operating-system-NetBSD-3.0   3.0
 477 .ds doc-operating-system-NetBSD-3.0.1 3.0.1
 478 .ds doc-operating-system-NetBSD-3.0.2 3.0.2
 479 .ds doc-operating-system-NetBSD-3.0.3 3.0.3
 480 .ds doc-operating-system-NetBSD-3.1   3.1
 481 .ds doc-operating-system-NetBSD-3.1.1 3.1.1
 482 .ds doc-operating-system-NetBSD-4.0   4.0
 483 .ds doc-operating-system-NetBSD-4.0.1 4.0.1
 484 .ds doc-operating-system-NetBSD-5.0   5.0
 485 .ds doc-operating-system-NetBSD-5.0.1 5.0.1
 486 .ds doc-operating-system-NetBSD-5.0.2 5.0.2
 487 .ds doc-operating-system-NetBSD-5.1   5.1
 488 .ds doc-operating-system-NetBSD-5.1.2 5.1.2
 489 .ds doc-operating-system-NetBSD-5.1.3 5.1.3
 490 .ds doc-operating-system-NetBSD-5.2   5.2
 491 .ds doc-operating-system-NetBSD-5.2.1 5.2.1
 492 .ds doc-operating-system-NetBSD-6.0   6.0
 493 .ds doc-operating-system-NetBSD-6.0.1 6.0.1
 494 .ds doc-operating-system-NetBSD-6.0.2 6.0.2
 495 .ds doc-operating-system-NetBSD-6.0.3 6.0.3
 496 .ds doc-operating-system-NetBSD-6.1   6.1
 497 .
 498 .ds doc-operating-system-OpenBSD-2.0  2.0
 499 .ds doc-operating-system-OpenBSD-2.1  2.1
 500 .ds doc-operating-system-OpenBSD-2.2  2.2
 501 .ds doc-operating-system-OpenBSD-2.3  2.3
 502 .ds doc-operating-system-OpenBSD-2.4  2.4
 503 .ds doc-operating-system-OpenBSD-2.5  2.5
 504 .ds doc-operating-system-OpenBSD-2.6  2.6
 505 .ds doc-operating-system-OpenBSD-2.7  2.7
 506 .ds doc-operating-system-OpenBSD-2.8  2.8
 507 .ds doc-operating-system-OpenBSD-2.9  2.9
 508 .ds doc-operating-system-OpenBSD-3.0  3.0
 509 .ds doc-operating-system-OpenBSD-3.1  3.1
 510 .ds doc-operating-system-OpenBSD-3.2  3.2
 511 .ds doc-operating-system-OpenBSD-3.3  3.3
 512 .ds doc-operating-system-OpenBSD-3.4  3.4
 513 .ds doc-operating-system-OpenBSD-3.5  3.5
 514 .ds doc-operating-system-OpenBSD-3.6  3.6
 515 .ds doc-operating-system-OpenBSD-3.7  3.7
 516 .ds doc-operating-system-OpenBSD-3.8  3.8
 517 .ds doc-operating-system-OpenBSD-3.9  3.9
 518 .ds doc-operating-system-OpenBSD-4.0  4.0
 519 .ds doc-operating-system-OpenBSD-4.1  4.1
 520 .ds doc-operating-system-OpenBSD-4.2  4.2
 521 .ds doc-operating-system-OpenBSD-4.3  4.3
 522 .ds doc-operating-system-OpenBSD-4.4  4.4
 523 .ds doc-operating-system-OpenBSD-4.5  4.5
 524 .ds doc-operating-system-OpenBSD-4.6  4.6
 525 .ds doc-operating-system-OpenBSD-4.7  4.7
 526 .ds doc-operating-system-OpenBSD-4.8  4.8
 527 .ds doc-operating-system-OpenBSD-4.9  4.9
 528 .ds doc-operating-system-OpenBSD-5.0  5.0
 529 .ds doc-operating-system-OpenBSD-5.1  5.1
 530 .ds doc-operating-system-OpenBSD-5.2  5.2
 531 .ds doc-operating-system-OpenBSD-5.3  5.3
 532 .ds doc-operating-system-OpenBSD-5.4  5.4
 533 .
 534 .ds doc-operating-system-FreeBSD-1.0     1.0
 535 .ds doc-operating-system-FreeBSD-1.1     1.1
 536 .ds doc-operating-system-FreeBSD-1.1.5   1.1.5
 537 .ds doc-operating-system-FreeBSD-1.1.5.1 1.1.5.1
 538 .ds doc-operating-system-FreeBSD-2.0     2.0
 539 .ds doc-operating-system-FreeBSD-2.0.5   2.0.5
 540 .ds doc-operating-system-FreeBSD-2.1     2.1
 541 .ds doc-operating-system-FreeBSD-2.1.5   2.1.5
 542 .ds doc-operating-system-FreeBSD-2.1.6   2.1.6
 543 .ds doc-operating-system-FreeBSD-2.1.7   2.1.7
 544 .ds doc-operating-system-FreeBSD-2.2     2.2
 545 .ds doc-operating-system-FreeBSD-2.2.1   2.2.1
 546 .ds doc-operating-system-FreeBSD-2.2.2   2.2.2
 547 .ds doc-operating-system-FreeBSD-2.2.5   2.2.5
 548 .ds doc-operating-system-FreeBSD-2.2.6   2.2.6
 549 .ds doc-operating-system-FreeBSD-2.2.7   2.2.7
 550 .ds doc-operating-system-FreeBSD-2.2.8   2.2.8
 551 .ds doc-operating-system-FreeBSD-2.2.9   2.2.9
 552 .ds doc-operating-system-FreeBSD-3.0     3.0
 553 .ds doc-operating-system-FreeBSD-3.1     3.1
 554 .ds doc-operating-system-FreeBSD-3.2     3.2
 555 .ds doc-operating-system-FreeBSD-3.3     3.3
 556 .ds doc-operating-system-FreeBSD-3.4     3.4
 557 .ds doc-operating-system-FreeBSD-3.5     3.5
 558 .ds doc-operating-system-FreeBSD-4.0     4.0
 559 .ds doc-operating-system-FreeBSD-4.1     4.1
 560 .ds doc-operating-system-FreeBSD-4.1.1   4.1.1
 561 .ds doc-operating-system-FreeBSD-4.2     4.2
 562 .ds doc-operating-system-FreeBSD-4.3     4.3
 563 .ds doc-operating-system-FreeBSD-4.4     4.4
 564 .ds doc-operating-system-FreeBSD-4.5     4.5
 565 .ds doc-operating-system-FreeBSD-4.6     4.6
 566 .ds doc-operating-system-FreeBSD-4.6.2   4.6.2
 567 .ds doc-operating-system-FreeBSD-4.7     4.7
 568 .ds doc-operating-system-FreeBSD-4.8     4.8
 569 .ds doc-operating-system-FreeBSD-4.9     4.9
 570 .ds doc-operating-system-FreeBSD-4.10    4.10
 571 .ds doc-operating-system-FreeBSD-4.11    4.11
 572 .ds doc-operating-system-FreeBSD-5.0     5.0
 573 .ds doc-operating-system-FreeBSD-5.1     5.1
 574 .ds doc-operating-system-FreeBSD-5.2     5.2
 575 .ds doc-operating-system-FreeBSD-5.2.1   5.2.1
 576 .ds doc-operating-system-FreeBSD-5.3     5.3
 577 .ds doc-operating-system-FreeBSD-5.4     5.4
 578 .ds doc-operating-system-FreeBSD-5.5     5.5
 579 .ds doc-operating-system-FreeBSD-6.0     6.0
 580 .ds doc-operating-system-FreeBSD-6.1     6.1
 581 .ds doc-operating-system-FreeBSD-6.2     6.2
 582 .ds doc-operating-system-FreeBSD-6.3     6.3
 583 .ds doc-operating-system-FreeBSD-6.4     6.4
 584 .ds doc-operating-system-FreeBSD-7.0     7.0
 585 .ds doc-operating-system-FreeBSD-7.1     7.1
 586 .ds doc-operating-system-FreeBSD-7.2     7.2
 587 .ds doc-operating-system-FreeBSD-7.3     7.3
 588 .ds doc-operating-system-FreeBSD-8.0     8.0
 589 .ds doc-operating-system-FreeBSD-8.1     8.1
 590 .ds doc-operating-system-FreeBSD-8.2     8.2
 591 .ds doc-operating-system-FreeBSD-9.0     9.0
 592 .ds doc-operating-system-FreeBSD-10.0    10.0
 593 .
 594 .ds doc-operating-system-Darwin-8.0.0  8.0.0
 595 .ds doc-operating-system-Darwin-8.1.0  8.1.0
 596 .ds doc-operating-system-Darwin-8.2.0  8.2.0
 597 .ds doc-operating-system-Darwin-8.3.0  8.3.0
 598 .ds doc-operating-system-Darwin-8.4.0  8.4.0
 599 .ds doc-operating-system-Darwin-8.5.0  8.5.0
 600 .ds doc-operating-system-Darwin-8.6.0  8.6.0
 601 .ds doc-operating-system-Darwin-8.7.0  8.7.0
 602 .ds doc-operating-system-Darwin-8.8.0  8.8.0
 603 .ds doc-operating-system-Darwin-8.9.0  8.9.0
 604 .ds doc-operating-system-Darwin-8.10.0 8.10.0
 605 .ds doc-operating-system-Darwin-8.11.0 8.11.0
 606 .ds doc-operating-system-Darwin-9.0.0  9.0.0
 607 .ds doc-operating-system-Darwin-9.1.0  9.1.0
 608 .ds doc-operating-system-Darwin-9.2.0  9.2.0
 609 .ds doc-operating-system-Darwin-9.3.0  9.3.0
 610 .ds doc-operating-system-Darwin-9.4.0  9.4.0
 611 .ds doc-operating-system-Darwin-9.5.0  9.5.0
 612 .ds doc-operating-system-Darwin-9.6.0  9.6.0
 613 .ds doc-operating-system-Darwin-9.7.0  9.7.0
 614 .ds doc-operating-system-Darwin-9.8.0  9.8.0
 615 .ds doc-operating-system-Darwin-10.1.0 10.1.0
 616 .ds doc-operating-system-Darwin-10.2.0 10.2.0
 617 .ds doc-operating-system-Darwin-10.3.0 10.3.0
 618 .ds doc-operating-system-Darwin-10.4.0 10.4.0
 619 .ds doc-operating-system-Darwin-10.5.0 10.5.0
 620 .ds doc-operating-system-Darwin-10.6.0 10.6.0
 621 .ds doc-operating-system-Darwin-10.7.0 10.7.0
 622 .ds doc-operating-system-Darwin-11.0.0 11.0.0
 623 .
 624 .ds doc-operating-system-DragonFly-1.0    1.0
 625 .ds doc-operating-system-DragonFly-1.1    1.1
 626 .ds doc-operating-system-DragonFly-1.2    1.2
 627 .ds doc-operating-system-DragonFly-1.3    1.3
 628 .ds doc-operating-system-DragonFly-1.4    1.4
 629 .ds doc-operating-system-DragonFly-1.5    1.5
 630 .ds doc-operating-system-DragonFly-1.6    1.6
 631 .ds doc-operating-system-DragonFly-1.7    1.7
 632 .ds doc-operating-system-DragonFly-1.8    1.8
 633 .ds doc-operating-system-DragonFly-1.8.1  1.8.1
 634 .ds doc-operating-system-DragonFly-1.9    1.9
 635 .ds doc-operating-system-DragonFly-1.10   1.10
 636 .ds doc-operating-system-DragonFly-1.11   1.11
 637 .ds doc-operating-system-DragonFly-1.12   1.12
 638 .ds doc-operating-system-DragonFly-1.12.2 1.12.2
 639 .ds doc-operating-system-DragonFly-1.13   1.13
 640 .ds doc-operating-system-DragonFly-2.0    2.0
 641 .ds doc-operating-system-DragonFly-2.1    2.1
 642 .ds doc-operating-system-DragonFly-2.2    2.2
 643 .ds doc-operating-system-DragonFly-2.3    2.3
 644 .ds doc-operating-system-DragonFly-2.4    2.4
 645 .ds doc-operating-system-DragonFly-2.5    2.5
 646 .ds doc-operating-system-DragonFly-2.6    2.6
 647 .ds doc-operating-system-DragonFly-2.7    2.7
 648 .ds doc-operating-system-DragonFly-2.8    2.8
 649 .ds doc-operating-system-DragonFly-2.9    2.9
 650 .ds doc-operating-system-DragonFly-2.9.1  2.9.1
 651 .ds doc-operating-system-DragonFly-2.10   2.10
 652 .ds doc-operating-system-DragonFly-2.10.1 2.10.1
 653 .ds doc-operating-system-DragonFly-2.11   2.11
 654 .ds doc-operating-system-DragonFly-3.0    3.0
 655 .ds doc-operating-system-DragonFly-3.1    3.1
 656 .ds doc-operating-system-DragonFly-3.2    3.2
 657 .ds doc-operating-system-DragonFly-3.3    3.3
 658 .ds doc-operating-system-DragonFly-3.4    3.4
 659 .ds doc-operating-system-DragonFly-3.5    3.5
 660 .ds doc-operating-system-DragonFly-3.6    3.6
 661 .ds doc-operating-system-DragonFly-3.7    3.7
 662 .
 663 .de Os
 664 .  ds doc-command-name
 665 .
 666 .  ie "\$1"" \
 667 .    ds doc-operating-system "\*[doc-default-operating-system]
 668 .  el \{ .ie "\$1"ATT" \{\
 669 .    ds doc-operating-system AT&T
 670 .    if \A\a\$2\a \{\
 671 .      ie d doc-operating-system-ATT-\$2 \
 672 .        as doc-operating-system " \*[doc-operating-system-ATT-\$2]
 673 .      el \
 674 .        as doc-operating-system " UNIX
 675 .  \}\}
 676 .  el \{ .ie "\$1"BSD" \{\
 677 .    if \A\a\$2\a \{\
 678 .      ie d doc-operating-system-BSD-\$2 \
 679 .        ds doc-operating-system "\*[doc-operating-system-BSD-\$2]
 680 .      el \
 681 .        tm mdoc warning: .Os: Unknown BSD version `\$2' (#\n[.c])
 682 .  \}\}
 683 .  el \{ .ie "\$1"FreeBSD" \{\
 684 .    ds doc-operating-system FreeBSD
 685 .    if \A\a\$2\a \{\
 686 .      ie d doc-operating-system-FreeBSD-\$2 \
 687 .        as doc-operating-system \~\*[doc-operating-system-FreeBSD-\$2]
 688 .      el \
 689 .        tm mdoc warning: .Os: Unknown FreeBSD version `\$2' (#\n[.c])
 690 .  \}\}
 691 .  el \{ .ie "\$1"DragonFly" \{\
 692 .    ds doc-operating-system DragonFly
 693 .    if \A\a\$2\a \{\
 694 .      ie d doc-operating-system-DragonFly-\$2 \
 695 .        as doc-operating-system \~\*[doc-operating-system-DragonFly-\$2]
 696 .      el \
 697 .        tm mdoc warning: .Os: Unknown DragonFly version `\$2' (#\n[.c])
 698 .  \}\}
 699 .  el \{ .ie "\$1"NetBSD" \{\
 700 .    ds doc-operating-system NetBSD
 701 .    if \A\a\$2\a \{\
 702 .      ie d doc-operating-system-NetBSD-\$2 \
 703 .        as doc-operating-system \~\*[doc-operating-system-NetBSD-\$2]
 704 .      el \
 705 .        tm mdoc warning: .Os: Unknown NetBSD version `\$2' (#\n[.c])
 706 .  \}\}
 707 .  el \{ .ie "\$1"OpenBSD" \{\
 708 .    ds doc-operating-system OpenBSD
 709 .    if \A\a\$2\a \{\
 710 .      ie d doc-operating-system-OpenBSD-\$2 \
 711 .        as doc-operating-system \~\*[doc-operating-system-OpenBSD-\$2]
 712 .      el \
 713 .        tm mdoc warning: .Os: Unknown OpenBSD version `\$2' (#\n[.c])
 714 .  \}\}
 715 .  el \{ .ie "\$1"Darwin" \{\
 716 .    ds doc-operating-system Darwin
 717 .    if \A\a\$2\a \{\
 718 .      ie d doc-operating-system-Darwin-\$2 \
 719 .        as doc-operating-system \~\*[doc-operating-system-Darwin-\$2]
 720 .      el \
 721 .        tm mdoc warning: .Os: Unknown Darwin version `\$2' (#\n[.c])
 722 .  \}\}
 723 .  el \{\
 724 .    ds doc-operating-system \$1
 725 .    if !"\$2"" \
 726 .      as doc-operating-system " \$2
 727 .  \}\}\}\}\}\}\}\}
 728 ..
 729 .
 730 .
 731 .\" NS doc-date-string global string
 732 .\" NS   the manual page date as set by `Dd'
 733 .
 734 .ds doc-date-string
 735 .
 736 .
 737 .\" NS Dd user macro (not parsed, not callable)
 738 .\" NS   set document date
 739 .\" NS
 740 .\" NS modifies:
 741 .\" NS   doc-date-string
 742 .\" NS   doc-command-name
 743 .\" NS
 744 .\" NS local variables:
 745 .\" NS   doc-date-XXX
 746 .\" NS
 747 .\" NS width register `Dd' set above
 748 .
 749 .ds doc-date-1  January
 750 .ds doc-date-2  February
 751 .ds doc-date-3  March
 752 .ds doc-date-4  April
 753 .ds doc-date-5  May
 754 .ds doc-date-6  June
 755 .ds doc-date-7  July
 756 .ds doc-date-8  August
 757 .ds doc-date-9  September
 758 .ds doc-date-10 October
 759 .ds doc-date-11 November
 760 .ds doc-date-12 December
 761 .
 762 .de Dd
 763 .  ds doc-command-name
 764 .
 765 .  ie \n[.$] \{\
 766 .    ie (\n[.$] == 3) \
 767 .      ds doc-date-string \$1\~\$2 \$3
 768 .    el \{\
 769 .      ds doc-date-string "\*[doc-date-\n[mo]]
 770 .      as doc-date-string \~\n[dy], \n[year]
 771 .    \}
 772 .  \}
 773 .  el \
 774 .    ds doc-date-string Epoch
 775 ..
 776 .
 777 .
 778 .\" NS doc-hyphen-flags global register
 779 .\" NS   the parameter for the `.hy' request
 780 .\" NS
 781 .\" NS override this in `mdoc.local', if necessary.
 782 .
 783 .nr doc-hyphen-flags 12
 784 .
 785 .
 786 .\" NS doc-header macro
 787 .\" NS   print page header
 788 .\" NS
 789 .\" NS local variables:
 790 .\" NS   doc-reg-dh
 791 .\" NS   doc-reg-dh1
 792 .
 793 .de doc-header
 794 .  ev doc-env-dh
 795 .  doc-setup-page-layout
 796 .  if !\n[cR] \
 797 .    sp \n[doc-header-space]u
 798 .  nr doc-reg-dh \w'\*[doc-caption-font]\*[doc-header-string]\f[]'
 799 .  nr doc-reg-dh1 \w'\*[doc-caption-font2]\*[doc-volume]\f[]'
 800 .  if (\n[doc-reg-dh] + \n[doc-reg-dh1] + \n[doc-reg-dh] >= \n[.lt]) \{\
 801 .    while (\n[doc-reg-dh] + \n[doc-reg-dh1] + \n[doc-reg-dh] >= \n[.lt]) \{\
 802 .      substring doc-header-string 0 -2
 803 .      nr doc-reg-dh \w'\*[doc-caption-font]\*[doc-header-string]\|.\|.\|.\f[]'
 804 .    \}
 805 .    as doc-header-string "\|.\|.\|.
 806 .  \}
 807 .  tl \a\*[doc-caption-font]\*[doc-header-string]\f[]\a\*[doc-caption-font2]\*[doc-volume]\f[]\a\*[doc-caption-font]\*[doc-header-string]\f[]\a
 808 .  ie !\n[cR] \
 809 .    sp \n[doc-header-space]u
 810 .  el \
 811 .    sp 1v
 812 .  ev
 813 .  ns
 814 ..
 815 .
 816 .
 817 .\" NS doc-footer macro
 818 .\" NS   print page footer
 819 .
 820 .de doc-footer
 821 .  ie \n[cR] \
 822 .    br
 823 .  el \{\
 824 .    ev doc-caption-enviroment
 825 .    doc-setup-page-layout
 826 .    sp \n[doc-footer-space]u
 827 .    ie \n[D] \{\
 828 .      ie o \
 829 .        tl \a%\a\*[doc-caption-font2]\*[doc-date-string]\f[]\a\*[doc-caption-font]\*[doc-operating-system]\f[]\a
 830 .      el \
 831 .        tl \a\*[doc-caption-font]\*[doc-operating-system]\f[]\a\*[doc-caption-font2]\*[doc-date-string]\f[]\a%\a
 832 .    \}
 833 .    el \
 834 .      tl \a\*[doc-caption-font]\*[doc-operating-system]\f[]\a\*[doc-caption-font2]\*[doc-date-string]\f[]\a%\a
 835 .    bp
 836 .    ev
 837 .  \}
 838 ..
 839 .
 840 .
 841 .\" NS doc-check-depth macro
 842 .\" NS   check paired macros
 843 .
 844 .de doc-check-depth
 845 .  if \n[doc-list-depth] \{\
 846 .    tm mdoc warning: A .Bl directive has no matching .El (#\n[.c])
 847 .    nr doc-list-depth 0
 848 .  \}
 849 .  if \n[doc-display-depth] \{\
 850 .    tm mdoc warning: A .Bd directive has no matching .Ed (#\n[.c])
 851 .    nr doc-display-depth 0
 852 .  \}
 853 .  if \n[doc-fontmode-depth] \{\
 854 .    tm mdoc warning: A .Bf directive has no matching .Ef (#\n[.c])
 855 .    nr doc-fontmode-depth 0
 856 .  \}
 857 ..
 858 .
 859 .
 860 .\" NS doc-end-macro macro
 861 .\" NS   finish output
 862 .
 863 .de doc-end-macro
 864 .  \" We may still have a partial line in the environment.  If this is the
 865 .  \" case, and we happen to be on the last line of the page, the `.fl'
 866 .  \" request will cause the page to be ejected and troff will immediately
 867 .  \" exit.  If we are in nroff mode, this would be unfortunate, since we
 868 .  \" would never get a chance to output the footer.  So we fudge the page
 869 .  \" length to make sure that the last page is never ejected until we want
 870 .  \" it to be.
 871 .
 872 .  if \n[cR] \
 873 .    pl +3v
 874 .  fl
 875 .
 876 .  doc-check-depth
 877 .
 878 .  if \n[cR] \{\
 879 .    sp
 880 .    tl \a\*[doc-caption-font]\*[doc-operating-system]\f[]\a\*[doc-caption-font2]\*[doc-date-string]\f[]\a\*[doc-caption-font]\*[doc-operating-system]\f[]\a
 881 .    \" suppress empty lines after the footer
 882 .    pl \n[nl]u
 883 .  \}
 884 ..
 885 .
 886 .
 887 .\" NS doc-paragraph macro
 888 .\" NS   insert a paragraph
 889 .
 890 .de doc-paragraph
 891 .  sp \n[doc-paragraph-space]u
 892 .  if !\n[cR] \
 893 .    ne 2
 894 .  ns
 895 ..
 896 .
 897 .
 898 .\" NS Pp user macro (not parsed, not callable)
 899 .\" NS   new paragraph
 900 .\" NS
 901 .\" NS width register `Pp' set above
 902 .
 903 .als Pp doc-paragraph
 904 .
 905 .
 906 .\" NS Lp user macro (not parsed, not callable)
 907 .\" NS   same as .Pp
 908 .\" NS
 909 .\" NS width register `Lp' set above
 910 .
 911 .als Lp doc-paragraph
 912 .
 913 .
 914 .de LP
 915 .  tm Not a \-mdoc command: .LP (#\n[.c])
 916 ..
 917 .
 918 .
 919 .de PP
 920 .  tm Not a \-mdoc command: .PP (#\n[.c])
 921 ..
 922 .
 923 .
 924 .de pp
 925 .  tm Not a \-mdoc command: .pp (#\n[.c])
 926 ..
 927 .
 928 .
 929 .de SH
 930 .  tm Not a \-mdoc command: .SH (#\n[.c])
 931 ..
 932 .
 933 .
 934 .\" NS Nd user macro (not parsed, not callable)
 935 .\" NS   print name description
 936 .\" NS
 937 .\" NS width register `Nd' set above
 938 .
 939 .de Nd
 940 .  nop \[em] \$*
 941 ..
 942 .
 943 .
 944 .\" NS doc-in-synopsis-section global register (bool)
 945 .\" NS   whether we are in the `synopsis' section
 946 .
 947 .nr doc-in-synopsis-section 0
 948 .
 949 .
 950 .\" NS doc-in-library-section global register (bool)
 951 .\" NS   whether we are in the `library' section
 952 .
 953 .nr doc-in-library-section 0
 954 .
 955 .
 956 .\" NS doc-in-see-also-section global register (bool)
 957 .\" NS   whether we are in the `see also' section
 958 .
 959 .nr doc-in-see-also-section 0
 960 .
 961 .
 962 .\" NS doc-in-files-section global register (bool)
 963 .\" NS   whether we are in the `files' section
 964 .
 965 .nr doc-in-files-section 0
 966 .
 967 .
 968 .\" NS doc-in-authors-section global register (bool)
 969 .\" NS   whether we are in the `authors' section
 970 .
 971 .nr doc-in-authors-section 0
 972 .
 973 .
 974 .\" NS doc-first-parameter macro
 975 .\" NS   return first parameter
 976 .\" NS
 977 .\" NS local variables:
 978 .\" NS   doc-str-dfp
 979 .
 980 .de doc-first-parameter
 981 .  ds doc-str-dfp "\$1
 982 ..
 983 .
 984 .
 985 .\" NS Sh user macro (not callable)
 986 .\" NS   section headers
 987 .\" NS
 988 .\" NS modifies:
 989 .\" NS   doc-func-args-processed
 990 .\" NS   doc-func-count
 991 .\" NS   doc-in-authors-section
 992 .\" NS   doc-in-files-section
 993 .\" NS   doc-in-library-section
 994 .\" NS   doc-in-see-also-section
 995 .\" NS   doc-in-synopsis-section
 996 .\" NS   doc-indent-synopsis
 997 .\" NS   doc-indent-synopsis-active
 998 .\" NS   doc-is-func
 999 .\" NS   doc-num-func-args
1000 .\" NS
1001 .\" NS local variables:
1002 .\" NS   doc-reg-Sh
1003 .\" NS   doc-reg-Sh1
1004 .\" NS   doc-section-XXX
1005 .\" NS
1006 .\" NS width register `Sh' set in doc-common
1007 .
1008 .ds doc-section-name        NAME
1009 .ds doc-section-synopsis    SYNOPSIS
1010 .ds doc-section-library     LIBRARY
1011 .ds doc-section-description DESCRIPTION
1012 .ds doc-section-see-also    SEE
1013 .ds doc-section-files       FILES
1014 .ds doc-section-authors     AUTHORS
1015 .
1016 .de Sh
1017 .  ie \n[doc-arg-limit] \{\
1018 .    \" we only allow `Sh' within `Sh'; it will change the font back to
1019 .    \" `doc-Sh-font'
1020 .    ie "\*[doc-macro-name]"Sh" \{\
1021 .      nr doc-arg-ptr +1
1022 .      ie (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \{\
1023 .        nr doc-curr-font \n[.f]
1024 .        nr doc-curr-size \n[.ps]
1025 .        nop \*[doc-Sh-font]\c
1026 .        doc-print-recursive
1027 .      \}
1028 .      el \{\
1029 .        tm Usage: .Sh section_name ... (#\n[.c])
1030 .        doc-reset-args
1031 .    \}\}
1032 .    el \{\
1033 .      tm Usage: .Sh not callable by other macros (#\n[.c])
1034 .      doc-reset-args
1035 .  \}\}
1036 .  el \{\
1037 .    if !\n[.$] \{\
1038 .      tm Usage: .Sh section_name ... (#\n[.c])
1039 .      return
1040 .    \}
1041 .
1042 .    ds doc-macro-name Sh
1043 .    doc-parse-args \$@
1044 .
1045 .    if t \
1046 .      ad
1047 .
1048 .    \" this resolves e.g. `.Sh "SEE ALSO"'
1049 .    doc-first-parameter \$*
1050 .
1051 .    ie "\*[doc-str-dfp]"\*[doc-section-name]" \{\
1052 .      doc-setup-header
1053 .      in 0
1054 .    \}
1055 .    el \{\
1056 .      nr doc-in-synopsis-section 0
1057 .      nr doc-in-library-section 0
1058 .      nr doc-in-see-also-section 0
1059 .      nr doc-in-files-section 0
1060 .      nr doc-in-authors-section 0
1061 .
1062 .      ie        "\*[doc-str-dfp]"\*[doc-section-synopsis]" \{\
1063 .        if t \
1064 .          na
1065 .        nr doc-in-synopsis-section 1
1066 .        nr doc-indent-synopsis 0
1067 .        nr doc-indent-synopsis-active 0
1068 .      \}
1069 .      el \{ .ie "\*[doc-str-dfp]"\*[doc-section-library]" \{\
1070 .        nr doc-in-library-section 1
1071 .      \}
1072 .      el \{ .ie "\*[doc-str-dfp]"\*[doc-section-description]" \{\
1073 .        nr doc-is-func 0
1074 .        nr doc-func-count 0
1075 .        nr doc-func-args-processed 0
1076 .        nr doc-num-func-args 0
1077 .      \}
1078 .      el \{ .ie "\*[doc-str-dfp]"\*[doc-section-see-also]" \{\
1079 .        if t \
1080 .          na
1081 .        nr doc-in-see-also-section 1
1082 .      \}
1083 .      el \{ .ie "\*[doc-str-dfp]"\*[doc-section-files]" \
1084 .        nr doc-in-files-section 1
1085 .      el .if    "\*[doc-str-dfp]"\*[doc-section-authors]" \
1086 .        nr doc-in-authors-section 1
1087 .      \}\}\}\}
1088 .
1089 .      in 0
1090 .      nr doc-have-author 0
1091 .    \}
1092 .
1093 .    doc-setup-page-layout
1094 .    sp
1095 .    ns
1096 .    ta T .5i
1097 .    if !\n[cR] \
1098 .      ne 3
1099 .    fi
1100 .
1101 .    if t \{\
1102 .      nr doc-reg-Sh \n[.ss]
1103 .      nr doc-reg-Sh1 \n[.sss]
1104 .      ss (\n[.ss] * 5 / 3) (\n[.sss] * 5 / 3)
1105 .    \}
1106 .
1107 .    nr doc-arg-ptr +1
1108 .    nr doc-curr-font \n[.f]
1109 .    nr doc-curr-size \n[.ps]
1110 .    nop \*[doc-Sh-font]\c
1111 .    doc-print-recursive
1112 .
1113 .    if t \
1114 .      ss \n[doc-reg-Sh] \n[doc-reg-Sh1]
1115 .
1116 .    in +\n[doc-subheader-indent]u
1117 .    ns
1118 .
1119 .    doc-check-depth
1120 .  \}
1121 ..
1122 .
1123 .
1124 .\" NS Ss user macro (not callable)
1125 .\" NS   subsection
1126 .\" NS
1127 .\" NS local variable:
1128 .\" NS   doc-reg-Ss
1129 .\" NS   doc-reg-Ss1
1130 .\" NS
1131 .\" NS width register `Ss' set above
1132 .
1133 .de Ss
1134 .  ie \n[doc-arg-limit] \{\
1135 .    \" we only allow `Ss' within `Ss'; it will change the font back to
1136 .    \" `doc-Sh-font'
1137 .    ie "\*[doc-macro-name]"Ss" \{\
1138 .      nr doc-arg-ptr +1
1139 .      ie (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \{\
1140 .        nr doc-curr-font \n[.f]
1141 .        nr doc-curr-size \n[.ps]
1142 .        nop \*[doc-Sh-font]\c
1143 .        doc-print-recursive
1144 .      \}
1145 .      el \{\
1146 .        tm Usage: .Ss subsection_name ... (#\n[.c])
1147 .        doc-reset-args
1148 .    \}\}
1149 .    el \{\
1150 .      tm Usage: .Ss not callable by other macros (#\n[.c])
1151 .      doc-reset-args
1152 .  \}\}
1153 .  el \{\
1154 .    if !\n[.$] \{\
1155 .      tm Usage: .Ss subsection_name ... (#\n[.c])
1156 .      return
1157 .    \}
1158 .
1159 .    ds doc-macro-name Ss
1160 .    doc-parse-args \$@
1161 .
1162 .    sp
1163 .    if !\n[cR] \
1164 .      ne 3
1165 .    ti -.25i
1166 .
1167 .    nr doc-reg-Ss \n[.ss]
1168 .    nr doc-reg-Ss1 \n[.sss]
1169 .    ss (\n[.ss] * 5 / 4) (\n[.sss] * 5 / 4)
1170 .
1171 .    nr doc-arg-ptr +1
1172 .    nr doc-curr-font \n[.f]
1173 .    nr doc-curr-size \n[.ps]
1174 .    nop \*[doc-Sh-font]\c
1175 .    doc-print-recursive
1176 .
1177 .    ss \n[doc-reg-Ss] \n[doc-reg-Ss1]
1178 .
1179 .    ta T .5i
1180 .    if !\n[cR] \
1181 .      ne 2
1182 .    br
1183 .    ns
1184 .
1185 .    doc-check-depth
1186 .  \}
1187 ..
1188 .
1189 .
1190 .\" NS Rd macro (not parsed, not callable)
1191 .\" NS   print global register dump to stderr
1192 .\" NS
1193 .\" NS local variables:
1194 .\" NS   doc-reg-Rd
1195 .
1196 .de Rd
1197 .  tm MDOC GLOBAL REGISTER DUMP
1198 .  tm doc-macro-name == `\*[doc-macro-name]'
1199 .  tm doc-arg-limit == \n[doc-arg-limit]
1200 .  tm doc-num-args == \n[doc-num-args]
1201 .  tm doc-arg-ptr == \n[doc-arg-ptr]
1202 .
1203 .  nr doc-reg-Rd 1
1204 .  while (\n[doc-reg-Rd] <= \n[doc-arg-limit]) \{\
1205 .    tm doc-arg\n[doc-reg-Rd] == `\*[doc-arg\n[doc-reg-Rd]]'
1206 .    tm doc-type\n[doc-reg-Rd] == \n[doc-type\n[doc-reg-Rd]]
1207 .    tm doc-space\n[doc-reg-Rd] == `\*[doc-space\n[doc-reg-Rd]]'
1208 .    nr doc-reg-Rd +1
1209 .  \}
1210 .
1211 .  tm doc-curr-font == \n[doc-curr-font]
1212 .  tm doc-curr-size == \n[doc-curr-size]
1213 .  tm doc-indent-synopsis == \n[doc-indent-synopsis]
1214 .  tm doc-indent-synopsis-active == \n[doc-indent-synopsis-active]
1215 .  tm doc-have-decl == \n[doc-have-decl]
1216 .  tm doc-have-var == \n[doc-have-var]
1217 .  tm doc-command-name == `\*[doc-command-name]'
1218 .  tm doc-quote-left == `\*[doc-quote-left]'
1219 .  tm doc-quote-right == `\*[doc-quote-right]'
1220 .  tm doc-nesting-level == \n[doc-nesting-level]
1221 .  tm doc-in-list == \n[doc-in-list]
1222 .  tm doc-space == `\*[doc-space]'
1223 .  tm doc-saved-space == `\*[doc-saved-space]'
1224 .  tm doc-space-mode == \n[doc-space-mode]
1225 .  tm doc-have-space == \n[doc-have-space]
1226 .  tm doc-have-slot == \n[doc-have-slot]
1227 .  tm doc-keep-type == \n[doc-keep-type]
1228 .  tm doc-display-depth == \n[doc-display-depth]
1229 .  tm doc-is-compact == \n[doc-is-compact]
1230 .
1231 .  nr doc-reg-Rd 0
1232 .  while (\n[doc-reg-Rd] <= \n[doc-display-depth]) \{\
1233 .    tm doc-display-type-stack\n[doc-reg-Rd] == `\*[doc-display-type-stack\n[doc-reg-Rd]]'
1234 .    tm doc-display-indent-stack\n[doc-reg-Rd] == \n[doc-display-indent-stack\n[doc-reg-Rd]]
1235 .    tm doc-display-ad-stack\n[doc-reg-Rd] == \n[doc-display-ad-stack\n[doc-reg-Rd]]
1236 .    tm doc-display-fi-stack\n[doc-reg-Rd] == \n[doc-display-fi-stack\n[doc-reg-Rd]]
1237 .    tm doc-display-ft-stack\n[doc-reg-Rd] == \n[doc-display-ft-stack\n[doc-reg-Rd]]
1238 .    tm doc-display-ps-stack\n[doc-reg-Rd] == \n[doc-display-ps-stack\n[doc-reg-Rd]]
1239 .    nr doc-reg-Rd +1
1240 .  \}
1241 .
1242 .  tm doc-fontmode-depth == \n[doc-fontmode-depth]
1243 .
1244 .  nr doc-reg-Rd 1
1245 .  while (\n[doc-reg-Rd] <= \n[doc-fontmode-depth]) \{\
1246 .    tm doc-fontmode-font-stack\n[doc-reg-Rd] == `\n[doc-fontmode-font-stack\n[doc-reg-Rd]]'
1247 .    tm doc-fontmode-size-stack\n[doc-reg-Rd] == `\n[doc-fontmode-size-stack\n[doc-reg-Rd]]'
1248 .    nr doc-reg-Rd +1
1249 .  \}
1250 .
1251 .  tm doc-list-depth == \n[doc-list-depth]
1252 .
1253 .  nr doc-reg-Rd 1
1254 .  while (\n[doc-reg-Rd] <= \n[doc-list-depth]) \{\
1255 .    tm doc-list-type-stack\n[doc-reg-Rd] == `\*[doc-list-type-stack\n[doc-reg-Rd]]'
1256 .    tm doc-list-have-indent-stack\n[doc-reg-Rd] == \n[doc-list-have-indent-stack\n[doc-reg-Rd]]
1257 .    tm doc-list-indent-stack\n[doc-reg-Rd] == \n[doc-list-indent-stack\n[doc-reg-Rd]]
1258 .    tm doc-compact-list-stack\n[doc-reg-Rd] == \n[doc-compact-list-stack\n[doc-reg-Rd]]
1259 .    tm doc-tag-prefix-stack\n[doc-reg-Rd] == `\*[doc-tag-prefix-stack\n[doc-reg-Rd]]'
1260 .    tm doc-tag-width-stack\n[doc-reg-Rd] == `\*[doc-tag-width-stack\n[doc-reg-Rd]]'
1261 .    tm doc-list-offset-stack\n[doc-reg-Rd] == \n[doc-list-offset-stack\n[doc-reg-Rd]]
1262 .    tm doc-enum-list-count-stack\n[doc-reg-Rd] == \n[doc-enum-list-count-stack\n[doc-reg-Rd]]
1263 .    nr doc-reg-Rd +1
1264 .  \}
1265 .
1266 .  tm doc-saved-Pa-font == `\*[doc-saved-Pa-font]'
1267 .  tm doc-curr-type == \n[doc-curr-type]
1268 .  tm doc-curr-arg == `\*[doc-curr-arg]'
1269 .  tm doc-diag-list-input-line-count == \n[doc-diag-list-input-line-count]
1270 .  tm doc-num-columns == \n[doc-num-columns]
1271 .  tm doc-column-indent-width == \n[doc-column-indent-width]
1272 .  tm doc-is-func == \n[doc-is-func]
1273 .  tm doc-have-old-func == \n[doc-have-old-func]
1274 .  tm doc-func-arg-count == \n[doc-func-arg-count]
1275 .  tm doc-func-arg == `\*[doc-func-arg]'
1276 .  tm doc-num-func-args == \n[doc-num-func-args]
1277 .  tm doc-func-args-processed == \n[doc-func-args-processed]
1278 .  tm doc-have-func == \n[doc-have-func]
1279 .  tm doc-is-reference == \n[doc-is-reference]
1280 .  tm doc-reference-count == \n[doc-reference-count]
1281 .  tm doc-author-count == \n[doc-author-count]
1282 .
1283 .  nr doc-reg-Rd 0
1284 .  while (\n[doc-reg-Rd] <= \n[doc-author-count]) \{\
1285 .    tm doc-author-name\n[doc-reg-Rd] == `\*[doc-author-name\n[doc-reg-Rd]]'
1286 .    nr doc-reg-Rd +1
1287 .  \}
1288 .
1289 .  tm doc-book-count == \n[doc-book-count]
1290 .  tm doc-book-name == `\*[doc-book-name]'
1291 .  tm doc-date-count == \n[doc-date-count]
1292 .  tm doc-date == `\*[doc-date]'
1293 .  tm doc-publisher-count == \n[doc-publisher-count]
1294 .  tm doc-publisher-name == `\*[doc-publisher-name]'
1295 .  tm doc-journal-count == \n[doc-journal-count]
1296 .  tm doc-journal-name == `\*[doc-journal-name]'
1297 .  tm doc-issue-count == \n[doc-issue-count]
1298 .  tm doc-issue-name == `\*[doc-issue-name]'
1299 .  tm doc-optional-count == \n[doc-optional-count]
1300 .  tm doc-optional-string == `\*[doc-optional-string]'
1301 .  tm doc-page-number-count == \n[doc-page-number-count]
1302 .  tm doc-page-number-string == `\*[doc-page-number-string]'
1303 .  tm doc-corporate-count == \n[doc-corporate-count]
1304 .  tm doc-corporate-name == `\*[doc-corporate-name]'
1305 .  tm doc-report-count == \n[doc-report-count]
1306 .  tm doc-report-name == `\*[doc-report-name]'
1307 .  tm doc-reference-title-count == \n[doc-reference-title-count]
1308 .  tm doc-reference-title-name == `\*[doc-reference-title-name]'
1309 .  tm doc-reference-title-name-for-book == `\*[doc-reference-title-name-for-book]'
1310 .  tm doc-url-count == \n[doc-url-count]
1311 .  tm doc-url-name == `\*[doc-url-name]'
1312 .  tm doc-volume-count == \n[doc-volume-count]
1313 .  tm doc-volume-name == `\*[doc-volume-name]'
1314 .  tm doc-have-author == \n[doc-have-author]
1315 .
1316 .  tm doc-document-title == `\*[doc-document-title]'
1317 .  tm doc-volume == `\*[doc-volume]'
1318 .  tm doc-section == `\*[doc-section]'
1319 .  tm doc-operating-system == `\*[doc-operating-system]'
1320 .  tm doc-date-string == `\*[doc-date-string]'
1321 .  tm doc-header-space == \n[doc-header-space]
1322 .  tm doc-footer-space == \n[doc-footer-space]
1323 .  tm doc-display-vertical == \n[doc-display-vertical]
1324 .  tm doc-header-string == `\*[doc-header-string]'
1325 .  tm doc-in-synopsis-section == \n[doc-in-synopsis-section]
1326 .  tm doc-in-library-section == \n[doc-in-library-section]
1327 .  tm doc-in-see-also-section == \n[doc-in-see-also-section]
1328 .  tm doc-in-files-section == \n[doc-in-files-section]
1329 .  tm doc-in-authors-section == \n[doc-in-authors-section]
1330 .
1331 .  tm END OF GLOBAL REGISTER DUMP
1332 ..
1333 .
1334 .
1335 .ec
1336 .
1337 .\" EOF