aDriv4 - MANAGER

Edit File: doc.tmac

.\" Copyright (c) 1991, 1993
.\"   The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in
.\"    the documentation and/or other materials provided with the
.\"    distribution.
.\" 3. [Deleted.  See
.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change]
.\" 4. Neither the name of the University nor the names of its
.\"    contributors may be used to endorse or promote products derived
.\"    from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)doc	8.1 (Berkeley) 06/08/93
.\"
.\" Modified by jjc@jclark.com as follows: the doc-* files are assumed
.\" to be installed as mdoc/doc-* rather than tmac.doc-* (the filename
.\" 'tmac.doc-common' would be too long); when using groff, the doc-*
.\" files are loaded using the 'mso' request.
.\"
.\" Modified by
.\"
.\"   Werner LEMBERG <wl@gnu.org>      and
.\"   Ruslan Ermilov <ru@freebsd.org>
.\"
.\" to make it more readable: using long names and many groff features,
.\" updating and extending documentation, etc.
.
.
.if !\n(.g \
.  ab groff mdoc macros require groff extensions; aborting
.
.
.do if d Dd .nx
.
.
.cp 0
.
.
.if (\n[.x]\n[.y] < 118) \{\
.  ds doc-msg doc.tmac: groff mdoc macros require groff 1.18 or later,
.  as doc-msg " but found groff \n[.x].\n[.y]; aborting
.  ab \*[doc-msg]
.\}
.
.\" Handle most rendering options.
.
.nr doc-is-output-html 0
.if '\*[.T]'html' .nr doc-is-output-html 1
.
.\" Use -dAD to set the adjustment mode for ordinary body text.
.if !d AD \
.  ds AD b\"
.
.\" Use -rC1 to consecutively number pages across multiple documents.
.\"
.\" We must use consecutive page numbers when using PostScript to
.\" generate HTML images; we must not reset the page number at the
.\" beginning of each document (the 'ps4html' register is automatically
.\" added to the command line by the pre-HTML preprocessor).
.ie !r C \
.  nr C 0
.el \
.  if !\n[C] \
.    if \n[doc-is-output-html] \{\
.       tm mdoc: consecutive page numbering required for HTML output
.       nr C 1
.    \}
.if \n[doc-is-output-html] \
.  nr C 1
.if r ps4html \
.  nr C 1
.
.\" Use -rCS=1 to force capitalization of section headings.
.if !r CS .nr CS 0
.
.\" Use -rCT=1 to force capitalization of page titles in headers.
.if !r CT .nr CT 0
.
.\" Use -rcR=0 for multiple pages instead of a single, very long page.
.if !r cR \{\
.  if t .nr cR 0
.  if n .nr cR 1
.\}
.
.\" If continuous rendering, tell tbl not to use keeps.
.ie \n[cR] \
.  nr 3usekeeps 0
.el \
.  nr 3usekeeps 1
.
.\" double-sided layout
.ie !r D \
.  nr D 0
.el \
.  if \n[D] \
.    if \n[doc-is-output-html] \{\
.       tm mdoc: ignoring double-sided layout in HTML output
.       nr D 0
.    \}
.
.\" footer distance
.\"
.\" Unlike most of these parameters, we do not set a default for FT; the
.\" doc-set-up-titles macro places page location traps only if not
.\" continuously rendering.
.if r FT \{\
.  \" Validate it.  Continuous rendering ignores FT.  Measuring a footer
.  \" distance from the page top isn't done.  A footer distance of over
.  \" half the page length is unlikely.  A footer distance of less than
.  \" one line height is too.
.  ie \n[cR] \
.    ds doc-msg footer distance when continuously rendering\"
.  el \{\
.    nr doc-tmp 1v
.    ds doc-help " (1v=\n[doc-tmp]u)\"
.    ie (\n[FT] : (\n[FT] = 0)) \
.      ds doc-msg non-negative footer distance: \n[FT]u\*[doc-help]\"
.    el \{\
.      ie (-(\n[FT]) > (\n[.p] / 2)) \{\
.        ds doc-msg implausibly large footer distance:\"
.        as doc-msg " \n[FT]u\*[doc-help]\"
.      \}
.      el \
.        if (-(\n[FT]) < 1v) \{\
.          ds doc-msg implausibly small footer distance:\"
.          as doc-msg " \n[FT]u\*[doc-help]\"
.        \}
.    rm doc-help
.    rr doc-tmp
.    \}
.  \}
.  if d doc-msg \{\
.    tm mdoc: ignoring \*[doc-msg]
.    rr FT
.    rm doc-msg
.  \}
.\}
.
.\" (sub)section heading font
.if !d HF \
.  ds HF B\"
.
.\" If HF is a bold style, use bold italics for italics in headings.
.ds doc-heading-style \*[HF]\"
.substring doc-heading-style -1 -1
.ds doc-heading-family \" empty
.length doc-HF-length \*[HF]
.if (\n[doc-HF-length] > 1) \{\
.  as doc-heading-family \*[HF]\"
.  substring doc-heading-family 0 -2
.\}
.if '\*[doc-heading-style]'B' \
.  if F \*[doc-heading-family]BI \
.    nr doc-remap-I-style-in-headings 1
.rr doc-HF-length
.rm doc-heading-style
.
.\" \n[HY] is recognized for groff_man(7) compatibility, particularly
.\" via andoc.tmac and man(1); see \n[doc-hyphen-flags] in doc-common.
.if !r HY .nr HY 1
.
.\" Use -rIN=<xxx> to set the paragraph indentation amount.
.if !r IN \{\
.  \" We select an integer indentation value in nroff mode because this
.  \" value is used additively for multiple purposes; rounding of
.  \" accumulating fractions would produce inconsistent results.
.  ie t .nr IN 7.2n
.  el   .nr IN 7n
.\}
.
.\" LL and LT registers are handled by the doc-setup-page-layout macro.
.
.\" TODO: Implement MF string.
.
.\" starting page number
.\"
.\" Unlike most of these parameters, we do not set a default for P;
.\" troff supplies a default starting page number (1).  When rendering
.\" for the HTML output device, page numbers are concealed and used for
.\" internal purposes like image embedding.  Page numbers are not
.\" rendered at all in continuous rendering mode.
.if r P \{\
.  if \n[doc-is-output-html] \
.    if !(\n[P] = 1) \
.      ds doc-msg in HTML output\"
.  if \n[cR] \
.    ds doc-msg when continuously rendering
.\}
.if d doc-msg \{\
.  tm mdoc: ignoring starting page number \*[doc-msg]
.  rr P
.  rm doc-msg
.\}
.
.\" Setting the page number turns out to be tricky when batch rendering
.\" and switching macro packages.  We must use different techniques
.\" depending on whether the transition to the first output page has
.\" happened yet.  If it has not, `nl` will be `-1` and we use `pn`.  If
.\" it has, we set `%`.  Technically this is fragile since in theory a
.\" page could assign a negative value to `nl`.  We might then be
.\" justified in saying they've broken the macro package and they get to
.\" keep both pieces.  But if not, consider using a nonce register,
.\" initially set but then permanently cleared adjacent to this logic,
.\" and whose state is shared with man (and andoc.tmac, if necessary).
.\"
.\" Also, we can't use the `P` register with grohtml at all.
.ie r ps4html \{\
.  if r P \{\
.     tm mdoc: ignoring starting page number in HTML output
.     rr P
.  \}
.\}
.el \{\
.  if r P \{\
.    ie (\n[nl] = -1) .pn 0\n[P]
.    el               .nr % 0\n[P]
.  \}
.\}
.
.\" Use -rSN=<xxx> to set the subsection heading indentation amount.
.if !r SN .nr SN 3n
.
.\" TODO: Implement U register.
.
.\" page number after which to apply letter suffixes
.\"
.\" Unlike most of these parameters, we do not set a default for X; only
.\" the macro an-footer uses it.  Page numbers are not rendered at all
.\" in continuous rendering mode.
.if r X \{\
.  af doc-page-letter a
.  if \n[doc-is-output-html] \
.    ds doc-msg in HTML output\"
.  if \n[cR] \
.    ds doc-msg when continuously rendering
.\}
.if d doc-msg \{\
.  tm mdoc: ignoring page number suffix \*[doc-msg]
.  rr X
.  rm doc-msg
.\}
.
.
.\" Load startup files.
.ie t \
.  mso mdoc/doc-ditroff
.el \
.  mso mdoc/doc-nroff
.
.mso mdoc/doc-common
.mso mdoc/doc-syms
.
.
.\" NS doc-macro-name global string
.\" NS   name of calling request (set in each user-requestable macro)
.
.ds doc-macro-name
.als doc-arg0 doc-macro-name
.
.
.\" NS doc-arg-count global register
.\" NS   total number of arguments
.\" XXX: This register name and description aren't quite right, but its
.\" old name `doc-arg-limit` doesn't seem accurate either.  Demystify.
.
.nr doc-arg-count 0
.
.
.\" NS doc-num-args global register
.\" NS   number of arguments to handle (must be set to \n[.$] prior to
.\" NS   'doc-parse-arg-vector' request)
.
.nr doc-num-args 0
.
.
.\" NS doc-arg-ptr global register
.\" NS   argument pointer
.
.nr doc-arg-ptr 0
.
.
.\" NS doc-argXXX global string
.\" NS   argument vector
.\" NS
.\" NS limit:
.\" NS   doc-arg-count
.
.ds doc-arg1
.
.
.\" NS doc-typeXXX global register
.\" NS   argument type vector (macro=1, string=2, punctuation suffix=3,
.\" NS   punctuation prefix=4)
.\" NS
.\" NS limit:
.\" NS   doc-arg-count
.
.nr doc-type1 0
.
.
.\" NS doc-spaceXXX global string
.\" NS   space vector
.\" NS
.\" NS limit:
.\" NS   doc-arg-count
.
.ds doc-space1
.
.
.\" NS doc-parse-args macro
.\" NS   parse arguments (recursively) ('.doc-parse-args arg ...')
.\" NS
.\" NS modifies:
.\" NS   doc-arg-count
.\" NS   doc-arg-ptr
.\" NS   doc-argXXX
.\" NS   doc-spaceXXX
.\" NS   doc-typeXXX
.\" NS   doc-arg-ptr
.\" NS   doc-have-space
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dpa
.\" NS   doc-reg-dpa1
.\" NS   doc-str-dpa
.
.eo
.de doc-parse-args
.  if !\n[doc-arg-count] \
.    doc-set-spacing-1
.
.  nr doc-have-space 0
.
.  if !\n[.$] \
.    return
.
.  nr doc-arg-count +1
.
.  \" handle '|' and '...' specially
.  ie        "\$1"|" \
.    ds doc-arg\n[doc-arg-count] \f[R]|\f[]
.  el \{ .ie "\$1"..." \
.    ds doc-arg\n[doc-arg-count] \|.\|.\|.
.  el \
.    ds doc-arg\n[doc-arg-count] "\$1
.  \}
.
.  \" get argument type and set spacing
.  doc-get-arg-type* \n[doc-arg-count]
.  nr doc-type\n[doc-arg-count] \n[doc-arg-type]
.  doc-set-spacing-\n[doc-arg-type]
.
.  \" check whether we have processed the last parameter
.  ie (\n[.$] == 1) \
.    nr doc-arg-ptr 0
.  el \{\
.    shift
.    doc-parse-args \$@
.  \}
.
.  nh
..
.ec
.
.
.\" NS doc-parse-arg-vector macro
.\" NS   parse argument vector (recursive)
.\" NS
.\" NS   cf. comments in doc-parse-args
.\" NS
.\" NS modifies:
.\" NS   doc-arg-count
.\" NS   doc-arg-ptr
.\" NS   doc-argXXX
.\" NS   doc-num-args
.\" NS   doc-spaceXXX
.\" NS   doc-typeXXX
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dpav
.\" NS   doc-reg-dpav1
.\" NS   doc-str-dpav
.
.eo
.de doc-parse-arg-vector
.  if !\n[doc-arg-count] \
.    doc-set-spacing-1
.
.  nr doc-arg-count +1
.
.  ie        "\*[doc-arg\n[doc-arg-count]]"|" \
.    ds doc-arg\n[doc-arg-count] \f[R]|\f[]
.  el \{ .if "\*[doc-arg\n[doc-arg-count]]"..." \
.    ds doc-arg\n[doc-arg-count] \|.\|.\|.
.  \}
.
.  doc-get-arg-type* \n[doc-arg-count]
.  nr doc-type\n[doc-arg-count] \n[doc-arg-type]
.  doc-set-spacing-\n[doc-arg-type]
.
.  ie (\n[doc-num-args] == 1) \{\
.    nr doc-arg-ptr 0
.    nr doc-num-args 0
.  \}
.  el \{\
.    nr doc-num-args -1
.    doc-parse-arg-vector
.  \}
.
.  nh
..
.ec
.
.
.\" NS doc-parse-space-vector macro
.\" NS   parse space vector (recursive)
.\" NS
.\" NS modifies:
.\" NS   doc-arg-count
.\" NS   doc-num-args
.\" NS   doc-spaceXXX
.
.eo
.de doc-parse-space-vector
.  nr doc-arg-count +1
.
.  doc-set-spacing-\n[doc-type\n[doc-arg-count]]
.
.  ie (\n[doc-num-args] == 1) \
.    nr doc-num-args 0
.  el \{\
.    nr doc-num-args -1
.    doc-parse-space-vector
.  \}
..
.ec
.
.
.\" NS doc-remaining-args macro
.\" NS   output remaining arguments as-is, separated by spaces (until
.\" NS   'doc-num-args' is exhausted)
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-num-args
.
.eo
.de doc-remaining-args
.  nr doc-arg-ptr +1
.  nop \)\*[doc-arg\n[doc-arg-ptr]]\c
.
.  ie (\n[doc-num-args] == 1) \{\
.    nr doc-arg-ptr 0
.    nr doc-num-args 0
.  \}
.  el \{\
.    nop \)\*[doc-space]\c
.    nr doc-num-args -1
.    doc-remaining-args
.  \}
..
.ec
.
.
.\" NS doc-append-arg macro
.\" NS   append one argument to argument vector:
.\" NS   '.doc-append-arg [arg] [type]'
.\" NS
.\" NS modifies:
.\" NS   doc-arg-count
.\" NS   doc-argXXX
.\" NS   doc-typeXXX
.
.eo
.de doc-append-arg
.  nr doc-arg-count +1
.  ds doc-arg\n[doc-arg-count] "\$1
.  nr doc-type\n[doc-arg-count] \$2
.  doc-set-spacing-\$2
..
.ec
.
.
.\" NS doc-print-and-reset macro
.\" NS   finish input line and clean up argument vectors
.
.eo
.de doc-print-and-reset
.  if \n[doc-space-mode] \
.    nop \)
.  doc-reset-args
..
.ec
.
.
.\" NS doc-reset-args macro
.\" NS   reset argument counters
.\" NS
.\" NS modifies:
.\" NS   doc-arg-count
.\" NS   doc-arg-ptr
.\" NS   doc-have-slot
.
.eo
.de doc-reset-args
.  nr doc-arg-count 0
.  nr doc-arg-ptr 0
.  nr doc-have-slot 0
.
.  hy \n[doc-hyphen-flags]
..
.ec
.
.
.\" NS doc-curr-font global register
.\" NS   saved current font
.
.nr doc-curr-font \n[.f]
.
.
.\" NS Fl user macro
.\" NS   handle flags (appends '-' and prints flags): '.Fl [arg ...]'
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS
.\" NS local variables:
.\" NS   doc-reg-Fl (for communication with doc-flag-recursion)
.\" NS
.\" NS width register 'Fl' set in doc-common
.
.eo
.de Fl
.  nr doc-curr-font \n[.f]
.  nop \*[doc-Fl-font]\c
.
.  if !\n[doc-arg-count] \{\
.    ds doc-macro-name Fl
.    doc-parse-args \$@
.
.    \" no arguments
.    if !\n[.$] \
.      nop \|\-\|\f[]
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  ie (\n[doc-arg-count] < \n[doc-arg-ptr]) \{\
.    \" last argument
.    nop \|\-\f[]\c
.    doc-print-and-reset
.  \}
.  el \{\
.    ie (\n[doc-type\n[doc-arg-ptr]] == 1) \{\
.      nop \|\-\f[]\c
.      \*[doc-arg\n[doc-arg-ptr]]
.    \}
.    el \{\
.      if (\n[doc-type\n[doc-arg-ptr]] == 3) \
.        nop \|\-\|\c
.
.      nr doc-reg-Fl 1
.      doc-flag-recursion
.  \}\}
..
.ec
.
.
.\" NS doc-flag-recursion macro
.\" NS   'Fl' flag recursion routine (special handling)
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dfr
.\" NS   doc-reg-dfr1
.\" NS   doc-str-dfr
.
.eo
.de doc-flag-recursion
.  nr doc-reg-dfr1 \n[doc-type\n[doc-arg-ptr]]
.  ds doc-str-dfr "\*[doc-arg\n[doc-arg-ptr]]
.
.  ie (\n[doc-reg-dfr1] == 1) \{\
.    nop \f[]\c
.    \*[doc-str-dfr]
.  \}
.  el \{\
.    nr doc-reg-dfr \n[doc-arg-ptr]
.
.    ie (\n[doc-reg-dfr1] == 2) \{\
.      \" handle vertical bar -- doc-reg-Fl is set for the first call of
.      \" doc-flag-recursion only; we need this to make '.Fl | ...' work
.      \" correctly
.      ie "\*[doc-str-dfr]"\*[Ba]" \{\
.        if \n[doc-reg-Fl] \
.          nop \|\-\*[doc-space]\c
.        nop \)\*[Ba]\c
.      \}
.      el \{\
.        ie "\*[doc-str-dfr]"\f[R]|\f[]" \{\
.          if \n[doc-reg-Fl] \
.            nop \|\-\*[doc-space]\c
.          nop \f[R]|\f[]\c
.        \}
.        el \{\
.          \" two consecutive hyphen characters?
.          ie "\*[doc-str-dfr]"-" \
.            nop \|\-\^\-\|\c
.          el \
.            nop \|\%\-\*[doc-str-dfr]\&\c
.    \}\}\}
.    el \{\
.      nop \f[\n[doc-curr-font]]\c
.      nop \)\*[doc-str-dfr]\f[]\c
.    \}
.
.    ie (\n[doc-arg-count] == \n[doc-arg-ptr]) \{\
.      \" last argument
.      if (\n[doc-reg-dfr1] == 4) \
.        nop \|\-\c
.      nop \f[\n[doc-curr-font]]\c
.      doc-print-and-reset
.    \}
.    el \{\
.      nr doc-arg-ptr +1
.      ie (\n[doc-type\n[doc-arg-ptr]] == 3) \{\
.        ie (\n[doc-type\n[doc-reg-dfr]] == 4) \
.          nop \|\-\c
.        el \
.          nop \)\*[doc-space\n[doc-reg-dfr]]\c
.      \}
.      el \
.        nop \)\*[doc-space\n[doc-reg-dfr]]\c
.
.      shift
.      nr doc-reg-Fl 0
.      doc-flag-recursion \$@
.  \}\}
..
.ec
.
.
.\" NS doc-print-recursive macro
.\" NS   general name recursion routine (print remaining arguments)
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dpr
.\" NS   doc-reg-dpr1
.\" NS   doc-str-dpr
.
.eo
.de doc-print-recursive
.  nr doc-reg-dpr1 \n[doc-type\n[doc-arg-ptr]]
.  ds doc-str-dpr "\*[doc-arg\n[doc-arg-ptr]]
.
.  if \n[doc-do-capitalize] .stringup doc-str-dpr
.
.  ie (\n[doc-reg-dpr1] == 1) \{\
.    nop \f[\n[doc-curr-font]]\c
.    \*[doc-str-dpr]
.  \}
.  el \{\
.    nr doc-reg-dpr \n[doc-arg-ptr]
.
.    \" the '\%' prevents hyphenation on a dash ('-')
.    ie (\n[doc-reg-dpr1] == 2) \
.      nop \%\*[doc-str-dpr]\&\c
.    el \{\
.      \" punctuation character
.      nop \f[\n[doc-curr-font]]\c
.      nop \)\*[doc-str-dpr]\f[]\c
.    \}
.
.    nr doc-arg-ptr +1
.    ie (\n[doc-arg-count] < \n[doc-arg-ptr]) \{\
.      \" last argument
.      nop \f[\n[doc-curr-font]]\c
.      doc-print-and-reset
.    \}
.    el \{\
.      nop \)\*[doc-space\n[doc-reg-dpr]]\c
.      doc-print-recursive
.  \}\}
..
.ec
.
.
.\" NS doc-print-prefixes macro
.\" NS   print leading prefixes
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.
.eo
.de doc-print-prefixes
.  while (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    if !(\n[doc-type\n[doc-arg-ptr]] == 4) \
.      break
.    nop \f[\n[doc-curr-font]]\c
.    nop \)\*[doc-arg\n[doc-arg-ptr]]\f[]\c
.    nr doc-arg-ptr +1
.  \}
..
.ec
.
.
.\" NS doc-generic-macro macro
.\" NS   this is the skeleton for most simple macros
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.
.eo
.de doc-generic-macro
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name \$0
.      doc-parse-args \$@
.    \}
.    el \
.      tm Usage: .\$0 \*[doc-\$0-usage] ... (#\n[.c])
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    if (\n[doc-type\n[doc-arg-ptr]] == 1) \{\
.      tmc mdoc warning: Using a macro as first argument
.      tm1 " cancels effect of .\$0 (#\n[.c])
.
.      \" the right action here would be to reset the argument counters
.      \" and bail out -- unfortunately, a small number of manual pages
.      \" (less than 2% for FreeBSD which has been used for testing)
.      \" relied on the old behaviour (silently ignore this error),
.      \" so it is commented out
.
.\"    doc-reset-args
.    \}
.\"  el \{\
.      nr doc-curr-font \n[.f]
.      nop \*[doc-\$0-font]\c
.      doc-print-recursive
.\"  \}
.  \}
.  el \{\
.    tm Usage: .\$0 \*[doc-\$0-usage] ... (#\n[.c])
.    doc-reset-args
.  \}
..
.ec
.
.
.\" NS Ar user macro
.\" NS   command-line 'argument' macro: '.Ar [args ...]'
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS
.\" NS local variable:
.\" NS   doc-str-Ar-default
.\" NS
.\" NS width register 'Ar' set in doc-common
.
.ds doc-str-Ar-default "file\ .\|.\|.
.
.eo
.de Ar
.  nr doc-curr-font \n[.f]
.  nop \*[doc-Ar-font]\c
.
.  if !\n[doc-arg-count] \{\
.    ds doc-macro-name Ar
.    doc-parse-args \$@
.
.    \" no argument
.    if !\n[.$] \
.      nop \)\*[doc-str-Ar-default]\&\f[]
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  doc-print-prefixes
.  ie (\n[doc-arg-count] < \n[doc-arg-ptr]) \{\
.    nop \)\*[doc-str-Ar-default]\&\f[]\c
.    doc-print-and-reset
.  \}
.  el \{\
.    if !(\n[doc-type\n[doc-arg-ptr]] == 2) \{\
.      \" replace previous argument (Ar) with default value
.      nr doc-arg-ptr -1
.      ds doc-arg\n[doc-arg-ptr] "\*[doc-str-Ar-default]
.      nr doc-type\n[doc-arg-ptr] 2
.      ds doc-space\n[doc-arg-ptr] "\*[doc-space]
.
.      \" recompute space vector for remaining arguments
.      nr doc-num-args (\n[doc-arg-count] - \n[doc-arg-ptr])
.      nr doc-arg-count \n[doc-arg-ptr]
.      doc-parse-space-vector
.    \}
.    doc-print-recursive
.  \}
..
.ec
.
.
.\" NS Ad user macro
.\" NS   Addresses
.\" NS
.\" NS width register 'Ad' set in doc-common
.
.als Ad doc-generic-macro
.ds doc-Ad-usage address
.
.
.\" NS doc-indent-synopsis global register
.\" NS   indentation in synopsis
.
.nr doc-indent-synopsis 0
.
.
.\" NS doc-indent-synopsis-active global register (bool)
.\" NS   indentation in synopsis active
.
.nr doc-indent-synopsis-active 0
.
.
.\" NS Cd user macro
.\" NS   config declaration (for section 4 SYNOPSIS)
.\" NS
.\" NS   this function causes a break; it uses the 'Nm' font
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-indent-synopsis
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Cd' set in doc-common
.
.eo
.de Cd
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Cd
.      doc-parse-args \$@
.    \}
.    el \
.      tm Usage: .Cd configuration_file_declaration ... (#\n[.c])
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    nr doc-curr-font \n[.f]
.
.    ie \n[doc-in-synopsis-section] \{\
.      ie "\*[doc-macro-name]"Cd" \{\
.        br
.        if !\n[doc-indent-synopsis] \
.          nr doc-indent-synopsis \n[doc-display-indent]u
.        if !\n[doc-indent-synopsis-active] \
.          in +\n[doc-indent-synopsis]u
.        ti -\n[doc-indent-synopsis]u
.        nop \*[doc-Nm-font]\c
.        doc-print-recursive
.        if !\n[doc-indent-synopsis-active] \
.          in -\n[doc-indent-synopsis]u
.      \}
.      el \{\
.        nop \*[doc-Nm-font]\c
.        doc-print-recursive
.    \}\}
.    el \{\
.      nop \*[doc-Nm-font]\c
.      doc-print-recursive
.  \}\}
.  el \{\
.    tm Usage: .Cd configuration_file_declaration ... (#\n[.c])
.    doc-reset-args
.  \}
..
.ec
.
.
.\" NS Cm user macro
.\" NS   interactive command modifier (flag)
.\" NS
.\" NS width register 'Cm' set in doc-common
.
.als Cm doc-generic-macro
.ds doc-Cm-usage interactive_command_modifier
.
.
.\" NS Dv user macro
.\" NS   defined variable
.\" NS
.\" NS   this function uses the 'Er' font
.\" NS
.\" NS width register 'Dv' set in doc-common
.
.als Dv doc-generic-macro
.ds doc-Dv-usage defined_variable
.als doc-Dv-font doc-Er-font
.
.
.\" NS Em user macro
.\" NS   emphasis
.\" NS
.\" NS width register 'Em' set in doc-common
.
.als Em doc-generic-macro
.ds doc-Em-usage text
.
.
.\" NS Er user macro
.\" NS   errno type
.\" NS
.\" NS width register 'Er' set in doc-common
.
.als Er doc-generic-macro
.ds doc-Er-usage text
.
.
.\" NS Ev user macro
.\" NS   environment variable
.\" NS
.\" NS width register 'Ev' set in doc-common
.
.als Ev doc-generic-macro
.ds doc-Ev-usage text
.
.
.\" NS doc-have-decl global register (bool)
.\" NS   subroutine test (in synopsis only)
.
.nr doc-have-decl 0
.
.
.\" NS doc-have-var global register (bool)
.\" NS   whether last type is a variable type
.
.nr doc-have-var 0
.
.
.\" NS doc-do-func-decl macro
.\" NS   do something special while in SYNOPSIS
.\" NS
.\" NS modifies:
.\" NS   doc-curr-font
.\" NS   doc-have-decl
.\" NS   doc-have-var
.
.eo
.de doc-do-func-decl
.  if \n[doc-in-synopsis-section] \{\
.    \" if a variable type was the last thing given, want vertical space
.    if \n[doc-have-var] \{\
.      doc-paragraph
.      nr doc-have-var 0
.    \}
.    \" if a subroutine was the last thing given, want vertical space
.    if \n[doc-have-func] \{\
.      ie \n[doc-have-decl] \
.        br
.      el \
.        doc-paragraph
.    \}
.    nr doc-have-decl 1
.  \}
.
.  nr doc-curr-font \n[.f]
..
.ec
.
.
.\" NS Fd user macro
.\" NS   function declaration -- not callable
.\" NS
.\" NS   this function causes a break
.\" NS
.\" NS width register 'Fd' set in doc-common
.
.eo
.de Fd
.  ie ((\n[.$] >= 1) & (\n[doc-arg-count] == 0)) \{\
.    doc-do-func-decl
.    nop \*[doc-Fd-font]\$*
.    br
.    ft \n[doc-curr-font]
.  \}
.  el \{\
.    tm Usage: .Fd function_declaration -- Fd is not callable (#\n[.c])
.    doc-reset-args
.  \}
..
.ec
.
.
.\" NS In user macro
.\" NS   #include statement in SYNOPSIS
.\" NS   <header.h> if not in SYNOPSIS
.\" NS
.\" NS   this function causes a break; it uses the 'Fd' font
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-indent-synopsis
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'In' set in doc-common
.
.eo
.de In
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name In
.      doc-parse-args \$@
.    \}
.    el \
.      tm Usage: .In include_file ... (#\n[.c])
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  doc-print-prefixes
.  ie ((\n[doc-arg-count] >= \n[doc-arg-ptr]) & (\n[doc-type\n[doc-arg-ptr]] == 2)) \{\
.    nr doc-curr-font \n[.f]
.
.    ie \n[doc-in-synopsis-section] \{\
.      ie "\*[doc-macro-name]"In" \{\
.        doc-do-func-decl
.        nop \*[doc-Fd-font]#include <\*[doc-arg\n[doc-arg-ptr]]>
.        ft \n[doc-curr-font]
.        br
.        nr doc-arg-ptr +1
.        ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \
.          doc-print-recursive
.        el \
.          doc-reset-args
.      \}
.      el \{\
.        ds doc-arg\n[doc-arg-ptr] "<\*[doc-Pa-font]\*[doc-arg\n[doc-arg-ptr]]
.        as doc-arg\n[doc-arg-ptr] \f[\n[doc-curr-font]]>
.        doc-print-recursive
.    \}\}
.    el \{\
.      ds doc-arg\n[doc-arg-ptr] "<\*[doc-Pa-font]\*[doc-arg\n[doc-arg-ptr]]
.      as doc-arg\n[doc-arg-ptr] \f[\n[doc-curr-font]]>
.      doc-print-recursive
.  \}\}
.  el \{\
.    tm Usage: .In include_file ... (#\n[.c])
.    doc-reset-args
.  \}
..
.ec
.
.
.\" NS Fr user macro
.\" NS   function return value
.\" NS
.\" NS   this function uses the 'Ar' font
.\" NS
.\" NS width register 'Fr' set in doc-common
.
.als Fr doc-generic-macro
.ds doc-Fr-usage function_return_value
.als doc-Fr-font doc-Ar-font
.
.
.\" NS Ic user macro
.\" NS   interactive command
.\" NS
.\" NS width register 'Ic' set in doc-common
.
.als Ic doc-generic-macro
.ds doc-Ic-usage interactive_command
.
.
.\" NS Li user macro
.\" NS   literals
.\" NS
.\" NS width register 'Li' set in doc-common
.
.als Li doc-generic-macro
.ds doc-Li-usage argument
.
.
.\" NS Ms user macro
.\" NS   math symbol
.\" NS
.\" NS   this function uses the 'Sy' font
.\" NS
.\" NS width register 'Ms' set in doc-common
.
.als Ms doc-generic-macro
.ds doc-Ms-usage math_symbol
.als doc-Ms-font doc-Sy-font
.
.
.\" NS doc-topic-name global string
.\" NS   save first invocation of .Nm
.
.ds doc-topic-name \" empty
.
.
.\" NS Nm user macro
.\" NS   name of command or page topic
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-topic-name
.\" NS   doc-curr-font
.\" NS   doc-indent-synopsis
.\" NS   doc-indent-synopsis-active
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Nm' set in doc-common
.
.eo
.de Nm
.  if !\n[doc-arg-count] \{\
.    ds doc-macro-name Nm
.    ie \n[.$] \{\
.      \" Handle '.Nm ...' in "Name" section: don't use a special font.
.      ie \n[doc-in-name-section] \{\
.        if "\*[doc-topic-name]"" \
.          ds doc-topic-name "\$1\"
.        No \$@
.      \}
.      el \
.        doc-parse-args \$@
.    \}
.    el \{\
.      ie "\*[doc-topic-name]"" \
.        tm Usage: .Nm name ... (#\n[.c])
.      el \
.        doc-parse-args \*[doc-topic-name]
.  \}\}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  doc-print-prefixes
.  ie (\n[doc-arg-count] < \n[doc-arg-ptr]) \{\
.    \" last argument
.    ie "\*[doc-topic-name]"" \{\
.      tm Usage: .Nm name ... (#\n[.c])
.      doc-reset-args
.    \}
.    el \{\
.      nop \*[doc-Nm-font]\*[doc-topic-name]\f[]\c
.      doc-print-and-reset
.  \}\}
.  el \{\
.    nr doc-curr-font \n[.f]
.
.    ie !(\n[doc-type\n[doc-arg-ptr]] == 2) \{\
.      ie "\*[doc-topic-name]"" \
.        tm Usage: .Nm name ... (#\n[.c])
.      el \{\
.        \" replace previous argument (Nm) with default value
.        nr doc-arg-ptr -1
.        ds doc-arg\n[doc-arg-ptr] "\*[doc-Nm-font]\*[doc-topic-name]\f[]
.        nr doc-type\n[doc-arg-ptr] 2
.        ds doc-space\n[doc-arg-ptr] "\*[doc-space]
.
.        \" recompute space vector for remaining arguments
.        nr doc-num-args (\n[doc-arg-count] - \n[doc-arg-ptr])
.        nr doc-arg-count \n[doc-arg-ptr]
.        doc-parse-space-vector
.    \}\}
.    el \{\
.      \" Handle '.Nm ...' in "Synopsis" section.
.      if \n[doc-in-synopsis-section] \{\
.        if "\*[doc-macro-name]"Nm" \{\
.          br
.          if !\n[doc-indent-synopsis] \{\
.            doc-get-width "\*[doc-arg\n[doc-arg-ptr]]"
.            nr doc-indent-synopsis ((\n[doc-width]u + 1u) * \n[doc-fixed-width]u)
.          \}
.          if !\n[doc-indent-synopsis-active] \{\
.            in +\n[doc-indent-synopsis]u
.            nr doc-indent-synopsis-active 1
.          \}
.          ti -\n[doc-indent-synopsis]u
.      \}\}
.
.      nop \*[doc-Nm-font]\c
.    \}
.    doc-print-recursive
.  \}
..
.ec
.
.
.\" NS Pa user macro
.\" NS   pathname: '.Pa [arg ...]'
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Pa' set in doc-common
.
.eo
.de Pa
.  if !\n[doc-arg-count] \{\
.    ds doc-macro-name Pa
.    doc-parse-args \$@
.
.    \" default value
.    if !\n[.$] \
.      nop \*[doc-Pa-font]\[ti]\f[]
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  doc-print-prefixes
.  ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    nr doc-curr-font \n[.f]
.    nop \*[doc-Pa-font]\c
.    if !(\n[doc-type\n[doc-arg-ptr]] == 2) \{\
.      \" replace previous argument (Pa) with default value
.      nr doc-arg-ptr -1
.      ds doc-arg\n[doc-arg-ptr] \[ti]
.      nr doc-type\n[doc-arg-ptr] 2
.      ds doc-space\n[doc-arg-ptr] "\*[doc-space]
.
.      \" recompute space vector for remaining arguments
.      nr doc-num-args (\n[doc-arg-count] - \n[doc-arg-ptr])
.      nr doc-arg-count \n[doc-arg-ptr]
.      doc-parse-space-vector
.    \}
.    doc-print-recursive
.  \}
.  el \{\
.    nop \*[doc-Pa-font]\[ti]\f[]\c
.    doc-print-and-reset
.  \}
..
.ec
.
.
.\" NS Sy user macro
.\" NS   symbolics
.\" NS
.\" NS width register 'Sy' set in doc-common
.
.als Sy doc-generic-macro
.ds doc-Sy-usage symbolic_text
.
.
.\" NS Me user macro
.\" NS   menu entries
.\" NS
.\" NS width register 'Me' set in doc-common
.
.als Me doc-generic-macro
.ds doc-Me-usage menu_entry
.
.
.\" NS Tn user macro
.\" NS   trade name
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Tn' set in doc-common
.
.eo
.de Tn
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Tn
.      doc-parse-args \$@
.    \}
.    el \
.      tm Usage: .Tn trade_name ... (#\n[.c])
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    nr doc-curr-font \n[.f]
.    nop \)\c
.    ie !\n[doc-is-reference] \{\
.      nop \)\*[doc-Tn-font]\c
.      doc-print-recursive
.    \}
.    el \
.      doc-do-references
.  \}
.  el \{\
.    tm Usage: .Tn trade_name ... (#\n[.c])
.    doc-reset-args
.  \}
..
.ec
.
.
.\" NS Va user macro
.\" NS   variable name
.\" NS
.\" NS width register 'Va' set in doc-common
.
.als Va doc-generic-macro
.ds doc-Va-usage variable_name
.
.
.\" NS No user macro
.\" NS   normal text macro (default text style if mess up)
.\" NS
.\" NS width register 'No' set in doc-common
.
.als No doc-generic-macro
.ds doc-No-usage normal_text
.
.
.\" NS doc-quote-left global string
.\" NS   left quotation character for 'doc-enclose-string' and
.\" NS   'doc-enclose-open'
.
.ds doc-quote-left
.
.
.\" NS doc-quote-right global string
.\" NS   right quotation character for 'doc-enclose-string' and
.\" NS   'doc-enclose-close'
.
.ds doc-quote-right
.
.
.\" NS Op user macro
.\" NS   option expression (i.e., enclose string in square brackets)
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Op' set in doc-common
.
.eo
.de Op
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Op
.
.  ds doc-quote-left "\*[doc-left-bracket]
.  ds doc-quote-right "\*[doc-right-bracket]
.
.  doc-enclose-string \$@
..
.ec
.
.
.\" NS Aq user macro
.\" NS   enclose string in angle brackets
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Aq' set in doc-common
.
.eo
.de Aq
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Aq
.
.  ie "\*[doc-macro-name]"An" \{\
.    ds doc-quote-left <
.    ds doc-quote-right >
.  \}
.  el \{\
.    ds doc-quote-left \[la]
.    ds doc-quote-right \[ra]
.  \}
.
.  doc-enclose-string \$@
..
.ec
.
.
.\" NS Bq user macro
.\" NS   enclose string in square brackets
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Bq' set in doc-common
.
.eo
.de Bq
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Bq
.
.  ds doc-quote-left "\*[doc-left-bracket]
.  ds doc-quote-right "\*[doc-right-bracket]
.
.  doc-enclose-string \$@
..
.ec
.
.
.\" NS Brq user macro
.\" NS   enclose string in braces
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Brq' set in doc-common
.
.eo
.de Brq
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Brq
.
.  ds doc-quote-left {
.  ds doc-quote-right }
.
.  doc-enclose-string \$@
..
.ec
.
.
.\" NS Dq user macro
.\" NS   enclose string in double quotes
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Dq' set in doc-common
.
.eo
.de Dq
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Dq
.
.  ds doc-quote-left "\*[Lq]
.  ds doc-quote-right "\*[Rq]
.
.  doc-enclose-string \$@
..
.ec
.
.
.\" NS Eq user macro
.\" NS   enclose string in user-defined quotes (args 1 and 2)
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Eq' set in doc-common
.
.eo
.de Eq
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Eq
.
.  ds doc-quote-left "\$1
.  ds doc-quote-right "\$2
.
.  shift 2
.  doc-enclose-string \$@
..
.ec
.
.
.\" NS Pq user macro
.\" NS   enclose string in parentheses
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Pq' set in doc-common
.
.eo
.de Pq
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Pq
.
.  ds doc-quote-left "\*[doc-left-parenthesis]
.  ds doc-quote-right "\*[doc-right-parenthesis]
.
.  doc-enclose-string \$@
..
.ec
.
.
.\" NS Ql user macro
.\" NS   quoted literal
.\"
.\"   is in file doc-[dit|n]roff
.
.
.\" NS Qq user macro
.\" NS   enclose string in straight double quotes
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Qq' set in doc-common
.
.eo
.de Qq
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Qq
.
.  ds doc-quote-left "\*[q]
.  ds doc-quote-right "\*[q]
.
.  doc-enclose-string \$@
..
.ec
.
.
.\" NS Sq user macro
.\" NS   enclose string in single quotes
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Sq' set in doc-common
.
.eo
.de Sq
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Sq
.
.  ds doc-quote-left "\*[doc-left-singlequote]
.  ds doc-quote-right "\*[doc-right-singlequote]
.
.  doc-enclose-string \$@
..
.ec
.
.
.\" NS Es user macro
.\" NS   set up arguments (i.e., the left and right quotation character
.\" NS   as first and second argument) for .En call
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.
.eo
.de Es
.  if !\n[doc-arg-count] \{\
.    ie (\n[.$] > 2) \{\
.      ds doc-macro-name Es
.      doc-parse-args \$@
.    \}
.    el \{\
.      ds doc-quote-left "\$1
.      ds doc-quote-right "\$2
.  \}\}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  ds doc-quote-left "\*[doc-arg\n[doc-arg-ptr]]
.  nr doc-arg-ptr +1
.  ds doc-quote-right "\*[doc-arg\n[doc-arg-ptr]]
.  nr doc-arg-ptr +1
.  ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \
.    doc-do-\n[doc-type\n[doc-arg-ptr]]
.  el \
.    doc-print-and-reset
..
.ec
.
.
.\" NS doc-have-slot global register (bool)
.\" NS   set if 'doc-enclose-string' has created a slot for closing
.\" NS   delimiter
.
.nr doc-have-slot 0
.
.
.\" NS doc-enclose-string macro
.\" NS   enclose string with given args (e.g. [ and ])
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-argXXX
.\" NS   doc-have-slot
.\" NS
.\" NS local variables:
.\" NS   doc-reg-des
.\" NS   doc-reg-des1
.\" NS   doc-reg-des2
.\" NS
.\" NS requires:
.\" NS   doc-quote-left
.\" NS   doc-quote-right
.
.eo
.de doc-enclose-string
.  if \n[doc-in-synopsis-section] \
.    doc-set-hard-space
.
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \
.      doc-parse-args \$@
.    el \{\
.      nop \)\*[doc-quote-left]\*[doc-quote-right]
.  \}\}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-curr-font \n[.f]
.
.  nr doc-arg-ptr +1
.  doc-print-prefixes
.  \" the final '\)' prevents hyphenation in case next character is '\%'
.  nop \)\*[doc-quote-left]\)\c
.  ie (\n[doc-arg-count] < \n[doc-arg-ptr]) \{\
.    \" last argument
.    nop \)\*[doc-quote-right]\)\c
.    doc-print-and-reset
.  \}
.  el \{\
.    \" test whether last arguments are of type closing punctuation
.    \" resp. suffix
.    ie (\n[doc-type\n[doc-arg-count]] == 3) \{\
.      nr doc-reg-des (\n[doc-arg-count] - 1)
.      while (\n[doc-type\n[doc-reg-des]] == 3) \
.        nr doc-reg-des -1
.
.      \" prepend closing delimiter
.      nr doc-reg-des +1
.      ds doc-arg\n[doc-reg-des] "\*[doc-quote-right]\)\*[doc-arg\n[doc-reg-des]]
.    \}
.    el \{\
.      \" test whether last arguments are macros which continue the line
.      \" logically
.      nr doc-reg-des \n[doc-arg-count]
.      while (\n[doc-reg-des] >= \n[doc-arg-ptr]) \{\
.        if !\A'\*[doc-arg\n[doc-reg-des]]' \
.          break
.        if !d doc-after-\*[doc-arg\n[doc-reg-des]] \
.          break
.        nr doc-reg-des -1
.      \}
.
.      \" if there are no trailing macros to be skipped, append argument
.      ie (\n[doc-reg-des] == \n[doc-arg-count]) \
.        doc-append-arg "\)\*[doc-quote-right]\)" 3
.      el \{\
.        \" if a previous call to 'doc-enclose-string' has already
.        \" created a slot, prepend argument
.        ie \n[doc-have-slot] \
.          ds doc-arg\n[doc-reg-des] "\*[doc-quote-right]\)\*[doc-arg\n[doc-reg-des]]
.        el \{\
.          \" we have to shift all arguments to the right
.          nr doc-reg-des +1
.          nr doc-reg-des1 \n[doc-arg-count]
.          nr doc-reg-des2 (\n[doc-arg-count] + 1)
.          while (\n[doc-reg-des1] >= \n[doc-reg-des]) \{\
.            rn doc-arg\n[doc-reg-des1] doc-arg\n[doc-reg-des2]
.            rnn doc-type\n[doc-reg-des1] doc-type\n[doc-reg-des2]
.            rn doc-space\n[doc-reg-des1] doc-space\n[doc-reg-des2]
.            nr doc-reg-des1 -1
.            nr doc-reg-des2 -1
.          \}
.          nr doc-arg-count +1
.
.          \" finally, insert closing delimiter into the freed slot and
.          \" recompute spacing vector
.          ds doc-arg\n[doc-reg-des] "\)\*[doc-quote-right]\)
.          nr doc-type\n[doc-reg-des] 3
.          nr doc-num-args (\n[doc-arg-count] - \n[doc-reg-des] + 1)
.          nr doc-arg-count (\n[doc-reg-des] - 1)
.          doc-parse-space-vector
.          nr doc-have-slot 1
.    \}\}\}
.
.    doc-do-\n[doc-type\n[doc-arg-ptr]]
.  \}
.
.  if \n[doc-in-synopsis-section] \
.    doc-set-soft-space
..
.ec
.
.
.\" NS En user macro
.\" NS   enclose arguments with quotation characters set up with '.Es'
.
.als En doc-enclose-string
.
.
.\" NS Ao user macro
.\" NS   angle open
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'Ao' set in doc-common
.
.eo
.de Ao
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Ao
.
.  ie "\*[doc-macro-name]"An" \
.    ds doc-quote-left <
.  el \
.    ds doc-quote-left \[la]
.
.  doc-enclose-open \$@
..
.ec
.
.
.\" NS Ac user macro
.\" NS   angle close
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Ac' set in doc-common
.
.eo
.de Ac
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Ac
.
.  ie "\*[doc-macro-name]"An" \
.    ds doc-quote-right >
.  el \
.    ds doc-quote-right \[ra]
.
.  doc-enclose-close \$@
..
.ec
.
.
.\" NS Bo user macro
.\" NS   bracket open
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'Bo' set in doc-common
.
.eo
.de Bo
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Bo
.
.  ds doc-quote-left "\*[doc-left-bracket]
.
.  doc-enclose-open \$@
..
.ec
.
.
.\" NS Bc user macro
.\" NS   bracket close
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Bc' set in doc-common
.
.eo
.de Bc
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Bc
.
.  ds doc-quote-right "\*[doc-right-bracket]
.
.  doc-enclose-close \$@
..
.ec
.
.
.\" NS Bro user macro
.\" NS   brace open
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'Bro' set in doc-common
.
.eo
.de Bro
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Bo
.
.  ds doc-quote-left {
.
.  doc-enclose-open \$@
..
.ec
.
.
.\" NS Brc user macro
.\" NS   brace close
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Brc' set in doc-common
.
.eo
.de Brc
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Bc
.
.  ds doc-quote-right }
.
.  doc-enclose-close \$@
..
.ec
.
.
.\" NS Do user macro
.\" NS   double quote open
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'Do' set in doc-common
.
.eo
.de Do
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Do
.
.  ds doc-quote-left "\*[Lq]
.
.  doc-enclose-open \$@
..
.ec
.
.
.\" NS Dc user macro
.\" NS   double quote close
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Dc' set in doc-common
.
.eo
.de Dc
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Dc
.
.  ds doc-quote-right "\*[Rq]
.
.  doc-enclose-close \$@
..
.ec
.
.
.\" NS Eo user macro
.\" NS   enclose open (using first argument as beginning of enclosure)
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'Eo' set in doc-common
.
.eo
.de Eo
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Eo
.
.  ds doc-quote-left "\$1
.
.  shift
.  doc-enclose-open \$@
..
.ec
.
.
.\" NS Ec user macro
.\" NS   enclose close (using first argument as end of enclosure)
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Ec' set in doc-common
.
.eo
.de Ec
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Ec
.
.  ds doc-quote-right "\$1
.
.  shift
.  doc-enclose-close \$@
..
.ec
.
.
.\" NS Oo user macro
.\" NS   option open
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'Oo' set in doc-common
.
.eo
.de Oo
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Oo
.
.  ds doc-quote-left [
.
.  doc-enclose-open \$@
..
.ec
.
.
.\" NS Oc user macro
.\" NS   option close
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Oc' set in doc-common
.
.eo
.de Oc
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Oc
.
.  ds doc-quote-right ]
.
.  doc-enclose-close \$@
..
.ec
.
.
.\" NS Po user macro
.\" NS   parenthesis open
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'Po' set in doc-common
.
.eo
.de Po
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Po
.
.  ds doc-quote-left "\*[doc-left-parenthesis]
.
.  doc-enclose-open \$@
..
.ec
.
.
.\" NS Pc user macro
.\" NS   parenthesis close
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Pc' set in doc-common
.
.eo
.de Pc
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Pc
.
.  ds doc-quote-right "\*[doc-right-parenthesis]
.
.  doc-enclose-close \$@
..
.ec
.
.
.\" NS Qo user macro
.\" NS   straight double quote open
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'Qo' set in doc-common
.
.eo
.de Qo
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Qo
.
.  ds doc-quote-left "\*[q]
.
.  doc-enclose-open \$@
..
.ec
.
.
.\" NS Qc user macro
.\" NS   straight double quote close
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Qc' set in doc-common
.
.eo
.de Qc
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Qc
.
.  ds doc-quote-right "\*[q]
.
.  doc-enclose-close \$@
..
.ec
.
.
.\" NS So user macro
.\" NS   single quote open
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'So' set in doc-common
.
.eo
.de So
.  if !\n[doc-arg-count] \
.    ds doc-macro-name So
.
.  ds doc-quote-left "\*[doc-left-singlequote]
.
.  doc-enclose-open \$@
..
.ec
.
.
.\" NS Sc user macro
.\" NS   single quote close
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Sc' set in doc-common
.
.eo
.de Sc
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Sc
.
.  ds doc-quote-right "\*[doc-right-singlequote]
.
.  doc-enclose-close \$@
..
.ec
.
.
.\" NS Xo user macro
.\" NS   extend open
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'Xo' set in doc-common
.
.eo
.de Xo
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Xo
.
.  ds doc-quote-left
.
.  doc-enclose-open \$@
..
.ec
.
.
.\" NS Xc user macro
.\" NS   extend close
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS   doc-quote-right
.\" NS
.\" NS width register 'Xc' set in doc-common
.
.eo
.de Xc
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Xc
.
.  ds doc-quote-right
.
.  doc-enclose-close \$@
..
.ec
.
.
.\" NS doc-nesting-level global register
.\" NS   used by 'doc-enclose-open' and 'doc-enclose-close'
.
.nr doc-nesting-level 0
.
.
.\" NS doc-in-list global register (bool)
.\" NS   whether we are in (logical) .It
.
.nr doc-in-list 0
.
.
.\" NS doc-enclose-open macro
.\" NS   enclose string open
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-nesting-level
.
.eo
.de doc-enclose-open
.  if !\n[doc-arg-count] \
.    doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  doc-print-prefixes
.  nr doc-arg-ptr -1
.
.  nop \)\*[doc-quote-left]\)\c
.
.  \" start enclosure box
.  box doc-enclosure-box\n[doc-nesting-level]
.  ev doc-enclosure-env\n[doc-nesting-level]
.  evc 0
.  in 0
.  nf
.  \" we insert something to make .chop always work
.  nop \&\c
.
.  \" increase nesting level *after* parsing of arguments
.  nr doc-nesting-level +1
.
.  if \n[doc-arg-count] \{\
.    nr doc-arg-ptr +1
.    ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \
.      doc-print-recursive
.    el \
.      doc-reset-args
.  \}
..
.ec
.
.
.\" NS doc-enclose-close macro
.\" NS   enclose string close
.\" NS
.\" NS modifies:
.\" NS   doc-nesting-level
.
.eo
.de doc-enclose-close
.  nr doc-nesting-level -1
.
.  \" finish enclosure box
.  br
.  ev
.  box
.  chop doc-enclosure-box\n[doc-nesting-level]
.  unformat doc-enclosure-box\n[doc-nesting-level]
.
.  nh
.  nop \*[doc-enclosure-box\n[doc-nesting-level]]\c
.  nop \)\*[doc-quote-right]\)\c
.
.  if !\n[doc-arg-count] \{\
.    doc-parse-args \$@
.
.    if !\n[.$] \
.      doc-print-and-reset
.  \}
.
.  if \n[doc-arg-count] \{\
.    ie (\n[doc-arg-count] > \n[doc-arg-ptr]) \{\
.      nop \)\*[doc-space\n[doc-arg-ptr]]\c
.      nr doc-arg-ptr +1
.      doc-print-recursive
.    \}
.    el \
.      doc-print-and-reset
.  \}
.
.  \" shall we finish .It macro?
.  if !"\*[doc-macro-name]"It" \
.    if \n[doc-in-list] \
.      if !\n[doc-nesting-level] \
.        doc-\*[doc-list-type-stack\n[doc-list-depth]]
..
.ec
.
.
.\" NS Pf user macro
.\" NS   prefix: '.Pf prefix arg ...'
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-macro-name
.\" NS   doc-quote-left
.\" NS
.\" NS width register 'Pf' set in doc-common
.
.eo
.de Pf
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Pf
.
.  ie \n[doc-arg-count] \{\
.    ie ((\n[doc-arg-count] - \n[doc-arg-ptr]) > 1) \{\
.      nr doc-arg-ptr +1
.      nop \)\*[doc-arg\n[doc-arg-ptr]]\c
.    \}
.    el \
.      tm mdoc warning: .Pf: trailing prefix (#\n[.c])
.  \}
.  el \{\
.    nop \)\$1\)\c
.    shift
.    ie \n[.$] \
.      doc-parse-args \$@
.    el \{\
.      tm mdoc warning: .Pf: missing arguments (#\n[.c])
.      nop \)
.  \}\}
.
.  if \n[doc-arg-count] \{\
.    nr doc-arg-ptr +1
.    ie (\n[doc-arg-count] < \n[doc-arg-ptr]) \
.      doc-print-and-reset
.    el \
.      doc-do-\n[doc-type\n[doc-arg-ptr]]
.  \}
..
.ec
.
.
.\" NS Ns user macro
.\" NS   remove space (space removal done by 'doc-parse-args')
.\" NS
.\" NS modifies:
.\" NS   doc-argXXX
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Ns' set in doc-common
.
.eo
.de Ns
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Ns
.      doc-parse-args \$@
.    \}
.    el \
.      tm Usage: .Ns must be called with arguments (#\n[.c])
.  \}
.
.  if \n[doc-arg-count] \{\
.    nr doc-arg-ptr +1
.    ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \
.      doc-print-recursive
.    el \
.      doc-reset-args
.  \}
..
.ec
.
.
.\" NS Ap user macro
.\" NS   append an apostrophe
.\" NS
.\" NS width register 'Ap' set in doc-common
.
.eo
.de Ap
.  ie !\n[doc-arg-count] \
.    tm Usage: 'Ap' cannot be first macro on a line (no '.Ap') (#\n[.c])
.  el \{\
.    nop \)'\)\c
.    nr doc-arg-ptr +1
.    ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \
.      doc-print-recursive
.    el \
.      doc-reset-args
.  \}
..
.ec
.
.
.\" NS doc-space global string
.\" NS   current inter-argument space
.
.ds doc-space "\*[doc-soft-space]
.
.
.\" NS doc-soft-space constant string
.\" NS   soft (stretchable) space (defined in doc-common)
.
.
.\" NS doc-hard-space constant string
.\" NS   hard (unpaddable) space (defined in doc-common)
.
.
.\" NS doc-set-hard-space macro
.\" NS   set current space string to hard (unpaddable) space.
.\" NS
.\" NS modifies:
.\" NS   doc-saved-space
.\" NS   doc-space
.
.eo
.de doc-set-hard-space
.  ie "\*[doc-space]"" \
.    ds doc-saved-space "\*[doc-hard-space]
.  el \
.    ds doc-space "\*[doc-hard-space]
..
.ec
.
.
.\" NS doc-set-soft-space macro
.\" NS   set current space string to soft space
.\" NS
.\" NS modifies:
.\" NS   doc-saved-space
.\" NS   doc-space
.
.eo
.de doc-set-soft-space
.  ie "\*[doc-space]"" \
.    ds doc-saved-space "\*[doc-soft-space]
.  el \
.    ds doc-space "\*[doc-soft-space]
..
.ec
.
.
.\" NS doc-space-mode global register (bool)
.\" NS   default is one (space mode on)
.
.nr doc-space-mode 1
.
.
.\" NS doc-saved-space global string
.\" NS   saved value of 'doc-space'
.
.ds doc-saved-space "\*[doc-space]
.
.
.\" NS doc-have-space global register (bool)
.\" NS   set if last command was horizontal space
.
.nr doc-have-space 0
.
.
.\" NS Sm user macro
.\" NS   space mode ('.Sm'/'.Sm on'/'.Sm off')
.\" NS
.\" NS   without argument, toggle space mode
.\" NS
.\" NS modifies:
.\" NS   doc-arg-count
.\" NS   doc-arg-ptr
.\" NS   doc-argXXX
.\" NS   doc-macro-name
.\" NS   doc-num-args
.\" NS   doc-saved-space
.\" NS   doc-space
.\" NS   doc-space-mode
.\" NS   doc-spaceXXX
.\" NS
.\" NS local variables:
.\" NS   doc-reg-Sm
.\" NS
.\" NS width register 'Sm' set in doc-common
.
.eo
.de Sm
.  ie \n[doc-have-space] \
.    nr doc-reg-Sm 0
.  el \
.    nr doc-reg-Sm 1
.
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Sm
.      doc-parse-args \$@
.    \}
.    el \{\
.      ie \n[doc-space-mode] \{\
.        ds doc-saved-space "\*[doc-space]
.        ds doc-space
.        nr doc-space-mode 0
.      \}
.      el \{\
.        ds doc-space "\*[doc-saved-space]
.        nr doc-space-mode 1
.
.        \" finish line only if it is interrupted and 'doc-have-space'
.        \" isn't set
.        if \n[doc-reg-Sm] \
.          if \n[.int] \
.            nop \)
.      \}
.  \}\}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.
.  \" avoid a warning message in case 'Sm' is the last parameter
.  if !d doc-arg\n[doc-arg-ptr] \
.    ds doc-arg\n[doc-arg-ptr]
.
.  ie "\*[doc-arg\n[doc-arg-ptr]]"on" \{\
.    ds doc-space "\*[doc-saved-space]
.    nr doc-space-mode 1
.  \}
.  el \{\
.    ie "\*[doc-arg\n[doc-arg-ptr]]"off" \{\
.      ds doc-saved-space "\*[doc-space]
.      ds doc-space
.      nr doc-space-mode 0
.    \}
.    el \{\
.      \" no argument for Sm
.      nr doc-arg-ptr -1
.      ie \n[doc-space-mode] \{\
.        ds doc-saved-space "\*[doc-space]
.        ds doc-space
.        nr doc-space-mode 0
.      \}
.      el \{\
.        ds doc-space "\*[doc-saved-space]
.        nr doc-space-mode 1
.      \}
.  \}\}
.
.  ie \n[doc-space-mode] \{\
.    \" recompute space vector for remaining arguments
.    nr doc-num-args (\n[doc-arg-count] - \n[doc-arg-ptr])
.    nr doc-arg-count \n[doc-arg-ptr]
.    if \n[doc-num-args] \
.      doc-parse-space-vector
.
.    \" finish line only if it is interrupted and 'doc-have-space'
.    \" isn't set
.    if \n[doc-reg-Sm] \
.      if \n[.int] \
.        nop \)
.  \}
.  el \{\
.    \" reset remaining space vector elements
.    nr doc-reg-Sm (\n[doc-arg-ptr] + 1)
.    while (\n[doc-reg-Sm] <= \n[doc-arg-count]) \{\
.      ds doc-space\n[doc-reg-Sm]
.      nr doc-reg-Sm +1
.      \" the body of a 'while' request must end with the fitting '\}'!
.    \}
.  \}
.
.  \" do we have parameters to print?
.  ie (\n[doc-arg-count] > \n[doc-arg-ptr]) \{\
.    \" skip 'Sm' argument
.    nr doc-arg-ptr +1
.    doc-print-recursive
.  \}
.  el \
.    doc-reset-args
..
.ec
.
.
.\" NS doc-arg-type immediate register
.\" NS   argument type (macro=1, string=2, punctuation suffix=3,
.\" NS   punctuation prefix=4)
.
.nr doc-arg-type 0
.
.
.\" NS doc-get-arg-type macro
.\" NS   get argument type
.\" NS
.\" NS   this macro expects the width of the argument in 'doc-width'
.\" NS
.\" NS modifies:
.\" NS   doc-arg-type
.
.eo
.de doc-get-arg-type
.  nr doc-arg-type 2
.
.  if ((\n[doc-width] < 4) & \A'\$1') \{\
.    ie (\n[doc-width] == 1) \{\
.      if r doc-punct\$1 \
.        nr doc-arg-type \n[doc-punct\$1]
.    \}
.    el \
.      if r \$1 \
.        if d \$1 \
.          nr doc-arg-type 1
.  \}
..
.ec
.
.
.\" NS doc-get-arg-type* macro
.\" NS   similar to as 'doc-get-arg-type' but uses doc-argXXX strings
.\" NS
.\" NS   this macro sets the 'doc-width' register using the 'length'
.\" NS   request to get the number of characters in a string literally
.\" NS
.\" NS modifies:
.\" NS   doc-arg-type
.\" NS   doc-width
.
.eo
.de doc-get-arg-type*
.  nr doc-arg-type 2
.  length doc-width "\*[doc-arg\$1]
.
.  if ((\n[doc-width] < 4) & \A'\*[doc-arg\$1]') \{\
.    ie (\n[doc-width] == 1) \{\
.      if r doc-punct\*[doc-arg\$1] \
.        nr doc-arg-type \n[doc-punct\*[doc-arg\$1]]
.    \}
.    el \
.      if r \*[doc-arg\$1] \
.        if d \*[doc-arg\$1] \
.          nr doc-arg-type 1
.  \}
..
.ec
.
.
.\" NS doc-set-spacing-1 macro
.\" NS   set spacing for macros
.\" NS
.\" NS modifies:
.\" NS   doc-spaceXXX
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dssfm
.\" NS   doc-reg-dssfm1
.
.eo
.de doc-set-spacing-1
.  nr doc-reg-dssfm1 \n[\*[doc-arg\n[doc-arg-count]]]
.
.  \" closing macros like .Ac, Bc., etc. have value 3 (remove space
.  \" before argument)
.  ie (\n[doc-reg-dssfm1] == 3) \{\
.    if \n[doc-arg-count] \{\
.      nr doc-reg-dssfm (\n[doc-arg-count] - 1)
.      ds doc-space\n[doc-reg-dssfm]
.    \}
.    ds doc-space\n[doc-arg-count] "\*[doc-space]
.  \}
.  el \{\
.    \" macros like .Ap and .Ns have value 2 (remove space before and
.    \" after argument)
.    ie (\n[doc-reg-dssfm1] == 2) \{\
.      if \n[doc-arg-count] \{\
.        nr doc-reg-dssfm (\n[doc-arg-count] - 1)
.        ds doc-space\n[doc-reg-dssfm]
.      \}
.      ds doc-space\n[doc-arg-count]
.    \}
.    el \
.      ds doc-space\n[doc-arg-count]
.  \}
..
.ec
.
.
.\" NS doc-set-spacing-2 macro
.\" NS   set spacing for strings
.\" NS
.\" NS modifies:
.\" NS   doc-spaceXXX
.
.eo
.de doc-set-spacing-2
.  ds doc-space\n[doc-arg-count] "\*[doc-space]
..
.ec
.
.
.\" NS doc-set-spacing-3 macro
.\" NS   set spacing for punctuation suffixes
.\" NS
.\" NS modifies:
.\" NS   doc-spaceXXX
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dssfps
.
.eo
.de doc-set-spacing-3
.  if \n[doc-arg-count] \{\
.    nr doc-reg-dssfps (\n[doc-arg-count] - 1)
.    ds doc-space\n[doc-reg-dssfps]
.  \}
.
.  ds doc-space\n[doc-arg-count] "\*[doc-space]
..
.ec
.
.
.\" NS doc-set-spacing-4 macro
.\" NS   set spacing for punctuation prefixes
.\" NS
.\" NS modifies:
.\" NS   doc-spaceXXX
.
.eo
.de doc-set-spacing-4
.  ds doc-space\n[doc-arg-count]
..
.ec
.
.
.\" type switches (on current argument doc-arg-ptr)
.
.
.\" NS doc-do-1 macro
.\" NS   call request if macro
.
.eo
.de doc-do-1
.  \*[doc-arg\n[doc-arg-ptr]]
..
.ec
.
.
.\" NS doc-do-2 macro
.\" NS   call .doc-print-recursive if string
.
.als doc-do-2 doc-print-recursive
.
.
.\" NS doc-do-3 macro
.\" NS   call .doc-print-recursive if punctuation suffix
.
.als doc-do-3 doc-print-recursive
.
.
.\" NS doc-do-4 macro
.\" NS   call .doc-print-recursive if punctuation prefix
.
.als doc-do-4 doc-print-recursive
.
.
.\" NS doc-fontmode-depth global register
.\" NS   font mode level
.
.nr doc-fontmode-depth 0
.
.
.\" NS doc-fontmode-font-stackXXX global register
.\" NS   stack of saved current font values from 'Bf' macro
.\" NS
.\" NS limit:
.\" NS   doc-fontmode-depth
.
.nr doc-fontmode-font-stack0 0
.
.
.\" NS doc-fontmode-size-stackXXX global register
.\" NS   stack of saved current size values from 'Bf' macro
.\" NS
.\" NS limit:
.\" NS   doc-fontmode-depth
.
.nr doc-fontmode-size-stack0 0
.
.
.\" NS Bf user macro
.\" NS   begin font mode (will be begin-mode/end-mode in groff & TeX)
.\" NS
.\" NS modifies:
.\" NS   doc-fontmode-depth
.\" NS   doc-fontmode-font-stackXXX
.\" NS   doc-fontmode-size-stackXXX
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Bf' set in doc-common
.
.eo
.de Bf
.  ds doc-macro-name Bf
.
.  ie \n[.$] \{\
.    nr doc-fontmode-depth +1
.
.    \" save current font and size
.    nr doc-fontmode-font-stack\n[doc-fontmode-depth] \n[.f]
.    nr doc-fontmode-size-stack\n[doc-fontmode-depth] \n[.ps]
.
.    ie        "\$1"Em" \
.      nop \*[doc-Em-font]\c
.    el \{ .ie "\$1"Li" \
.      nop \*[doc-Li-font]\c
.    el \{ .ie "\$1"Sy" \
.      nop \*[doc-Sy-font]\c
.    el \{ .ie "\$1"-emphasis" \
.      nop \*[doc-Em-font]\c
.    el \{ .ie "\$1"-literal" \
.      nop \*[doc-Li-font]\c
.    el \{ .ie "\$1"-symbolic" \
.      nop \*[doc-Sy-font]\c
.    el \{\
.      tmc mdoc warning: Unknown keyword '\$1' in .Bf macro
.      tm1 " (#\n[.c])
.  \}\}\}\}\}\}\}
.  el \
.    tm Usage: .Bf [Em | -emphasis | Li | -literal | Sy | -symbolic] (#\n[.c])
..
.ec
.
.
.\" NS Ef user macro
.\" NS   end font mode
.\" NS
.\" NS modifies:
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Ef' set in doc-common
.
.eo
.de Ef
.  ds doc-macro-name Ef
.
.  ie \n[doc-fontmode-depth] \{\
.    \" restore saved font and size
.    nop \)\f[\n[doc-fontmode-font-stack\n[doc-fontmode-depth]]]\c
.    nop \)\s[\n[doc-fontmode-size-stack\n[doc-fontmode-depth]]u]\c
.
.    nr doc-fontmode-font-stack\n[doc-fontmode-depth] 0
.    nr doc-curr-font \n[.f]
.    nr doc-fontmode-size-stack\n[doc-fontmode-depth] 0
.    nr doc-fontmode-depth -1
.  \}
.  el \
.    tm mdoc warning: Extraneous .Ef (#\n[.c])
..
.ec
.
.
.\" NS doc-keep-type global register
.\" NS   current keep type; 1 is '-words', 2 is '-lines', 3 is unknown
.
.nr doc-keep-type 0
.
.
.\" NS Bk user macro
.\" NS   begin keep
.\" NS
.\" NS modifies:
.\" NS   doc-keep-type
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Bk' set in doc-common
.
.eo
.de Bk
.  ds doc-macro-name Bk
.
.  if \n[doc-keep-type] \
.    tm .Bk: nesting keeps not implemented yet. (#\n[.c])
.
.  ie        "\$1"-lines" \{\
.    nr doc-keep-type 2
.    tm .Bk -lines: Not implemented yet. (#\n[.c])
.  \}
.  el \{ .ie "\$1"-words" \{\
.    nr doc-keep-type 1
.    doc-set-hard-space
.  \}
.  el \{ .ie "\$1"" \{\
.    \" default
.    nr doc-keep-type 1
.    doc-set-hard-space
.  \}
.  el \{\
.    tm mdoc warning: Unknown keyword '\$1' in .Bk macro (#\n[.c])
.    nr doc-keep-type 3
.  \}\}\}
.
\#.  nr doc-nesting-level +1
..
.ec
.
.
.\" NS Ek user macro
.\" NS   end keep
.\" NS
.\" NS modifies:
.\" NS   doc-keep-type
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Ek' set in doc-common
.
.eo
.de Ek
.  ds doc-macro-name Ek
.
\#.  nr doc-nesting-level -1
.
.  ie \n[.$] \
.    tm Usage: .Ek (does not take arguments) (#\n[.c])
.  el \{\
.    if !\n[doc-keep-type] \
.      tm mdoc warning: .Ek found without .Bk before (#\n[.c])
.
.    ie        (\n[doc-keep-type] == 1) \
.      doc-set-soft-space
.    el \{ .if (\n[doc-keep-type] == 2) \
.      tm .Bk -lines: Not implemented yet. (#\n[.c])
.  \}\}
.
.  nr doc-keep-type 0
.
\#.  if !"\*[doc-out-string]"" \
\#.    doc-print-out-string
..
.ec
.
.
.\" NS doc-display-depth global register
.\" NS   display level
.
.nr doc-display-depth 0
.
.
.\" NS doc-is-compact global register (bool)
.\" NS   set if the 'compact' keyword is given
.
.nr doc-is-compact 0
.
.
.\" NS doc-display-type-stackXXX global string
.\" NS   the display type stack
.\" NS
.\" NS limit:
.\" NS   doc-display-depth
.
.ds doc-display-type-stack0
.
.
.\" NS doc-display-indent-stackXXX global register
.\" NS   stack of display indentation values
.\" NS
.\" NS limit:
.\" NS   doc-display-depth
.
.nr doc-display-indent-stack0 0
.
.
.\" NS doc-display-ad-stackXXX global register
.\" NS   stack of saved adjustment modes
.\" NS
.\" NS limit:
.\" NS   doc-display-depth
.
.nr doc-display-ad-stack0 0
.
.
.\" NS doc-display-fi-stackXXX global register
.\" NS   stack of saved fill modes
.\" NS
.\" NS limit:
.\" NS   doc-display-depth
.
.nr doc-display-fi-stack0 0
.
.
.\" NS doc-display-ft-stackXXX global register
.\" NS   stack of saved fonts
.\" NS
.\" NS limit:
.\" NS   doc-display-depth
.
.nr doc-display-ft-stack0 0
.
.
.\" NS doc-display-ps-stackXXX global register
.\" NS   stack of saved font sizes
.\" NS
.\" NS limit:
.\" NS   doc-display-depth
.
.nr doc-display-ps-stack0 0
.
.
.\" NS Bd user macro
.\" NS   begin display
.\" NS
.\" NS width register 'Bd' set in doc-common
.\" NS
.\" NS modifies:
.\" NS   doc-curr-font
.\" NS   doc-display-depth
.\" NS   doc-display-ad-stackXXX
.\" NS   doc-display-fi-stackXXX
.\" NS   doc-display-ft-stackXXX
.\" NS   doc-display-ps-stackXXX
.\" NS   doc-display-file
.\" NS   doc-display-indent-stackXXX
.\" NS   doc-display-type-stackXXX
.\" NS   doc-is-compact
.\" NS   doc-macro-name
.\" NS
.\" NS local variables:
.\" NS   doc-reg-Bd
.
.eo
.de Bd
.  ds doc-macro-name Bd
.
.  if !\n[.$] \{\
.    tm1 "Usage: .Bd {-literal | -filled | -ragged | -centered | -unfilled}
.    tm1 "           [-offset [string]] [-compact] [-file name] (#\n[.c])
.    return
.  \}
.
.  nr doc-is-compact 0
.  ds doc-display-file
.  nr doc-reg-Bd 1
.  nr doc-display-depth +1
.
.  \" save current adjustment and fill modes
.  nr doc-display-ad-stack\n[doc-display-depth] \n[.j]
.  nr doc-display-fi-stack\n[doc-display-depth] \n[.u]
.
.  ie        "\$1"-literal" \{\
.    ds doc-display-type-stack\n[doc-display-depth] literal
.    nr doc-display-ft-stack\n[doc-display-depth] \n[.f]
.    nr doc-display-ps-stack\n[doc-display-depth] \n[.ps]
.
.    ie t \
.      ta T 9n
.    el \
.      ta T 8n
.    nf
.  \}
.  el \{ .ie "\$1"-filled" \{\
.    ds doc-display-type-stack\n[doc-display-depth] filled
.    ad b
.    fi
.  \}
.  el \{ .ie "\$1"-ragged" \{\
.    ds doc-display-type-stack\n[doc-display-depth] ragged
.    na
.    fi
.  \}
.  el \{ .ie "\$1"-centered" \{\
.    ds doc-display-type-stack\n[doc-display-depth] centered
.    ad c
.    fi
.  \}
.  el \{ .ie "\$1"-unfilled" \{\
.    ds doc-display-type-stack\n[doc-display-depth] unfilled
.    nf
.  \}
.  el \{\
.    tm1 "mdoc warning: Unknown keyword '\$1' (or missing display type)
.    tm1 "              in .Bd macro (#\n[.c])
.    nr doc-reg-Bd 0
.  \}\}\}\}\}
.
.  \" have we seen an argument?
.  if \n[doc-reg-Bd] \{\
.    shift
.    \" check other arguments
.    if \n[.$] \
.      doc-do-Bd-args \$@
.  \}
.
.  \" avoid warning about non-existent register
.  if !r doc-display-indent-stack\n[doc-display-depth] \
.    nr doc-display-indent-stack\n[doc-display-depth] 0
.
.  if \n[doc-display-indent-stack\n[doc-display-depth]] \
.    in +\n[doc-display-indent-stack\n[doc-display-depth]]u
.
.  if !\n[doc-is-compact] \
.    sp \n[doc-display-vertical]u
.
.  if "\*[doc-display-type-stack\n[doc-display-depth]]"literal" \
.    if t \
.      nop \*[doc-Li-font]\c
.
.  if !\n[cR] \
.    ne 2v
.
.  if !"\*[doc-display-file]"" \
.    so \*[doc-display-file]
.
.  nr doc-is-compact 0
.  ds doc-display-file
..
.ec
.
.
.\" NS doc-do-Bd-args macro
.\" NS   resolve remaining .Bd arguments
.\" NS
.\" NS modifies:
.\" NS   doc-display-file
.\" NS   doc-display-indent-stackXXX
.\" NS   doc-is-compact
.\" NS
.\" NS local variables:
.\" NS   doc-reg-ddBa
.\" NS   doc-reg-ddBa1
.\" NS   doc-reg-ddBa2
.\" NS   doc-reg-ddBa3
.\" NS   doc-reg-ddBa4
.\" NS   doc-str-ddBa
.
.eo
.de doc-do-Bd-args
.  nr doc-reg-ddBa 1
.
.  ie        "\$1"-offset" \{\
.    nr doc-reg-ddBa 2
.
.    ie        "\$2"left" \
.      nr doc-display-indent-stack\n[doc-display-depth] 0
.    el \{ .ie "\$2"right" \
.      nr doc-display-indent-stack\n[doc-display-depth] (\n[.l]u / 3u)
.    el \{ .ie "\$2"center" \
.      nr doc-display-indent-stack\n[doc-display-depth] ((\n[.l]u - \n[.i]u) / 4u)
.    el \{ .ie "\$2"indent" \
.      nr doc-display-indent-stack\n[doc-display-depth] \n[doc-display-indent]u
.    el \{ .ie "\$2"indent-two" \
.      nr doc-display-indent-stack\n[doc-display-depth] (\n[doc-display-indent]u + \n[doc-display-indent]u)
.    el \
.      nr doc-reg-ddBa 1
.    \}\}\}\}
.
.    \" not a known keyword
.    if (\n[doc-reg-ddBa] == 1) \{\
.      nr doc-reg-ddBa 2
.
.      nr doc-reg-ddBa1 0
.      if \B'(\$2)' \{\
.        \" disable warnings related to scaling indicators (32)
.        nr doc-reg-ddBa2 \n[.warn]
.        warn (\n[.warn] - (\n[.warn] / 32 % 2 * 32))
.
.        \" values without a scaling indicator are taken as strings;
.        \" we test whether the parameter string with and without the
.        \" last character yields identical numerical results (ignoring
.        \" the scaling indicator)
.        ds doc-str-ddBa "\$2
.        substring doc-str-ddBa 0 -2
.        if \B'(\*[doc-str-ddBa])' \{\
.          nr doc-reg-ddBa3 (;(\$2))
.          nr doc-reg-ddBa4 (\*[doc-str-ddBa])
.          if (\n[doc-reg-ddBa3] == \n[doc-reg-ddBa4]) \
.            nr doc-reg-ddBa1 1
.        \}
.
.        \" enable all warnings again
.        warn \n[doc-reg-ddBa2]
.      \}
.
.      ie \n[doc-reg-ddBa1] \
.        nr doc-display-indent-stack\n[doc-display-depth] \$2
.      el \{\
.        doc-get-width "\$2"
.        ie (\n[doc-width] <= 3) \{\
.          \" if the offset parameter is a macro, use the macro's
.          \" width as specified in doc-common
.          doc-get-arg-type "\$2"
.          ie (\n[doc-arg-type] == 1) \
.            nr doc-display-indent-stack\n[doc-display-depth] \n[\$2]
.          el \
.            nr doc-display-indent-stack\n[doc-display-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
.        \}
.        el \
.          nr doc-display-indent-stack\n[doc-display-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
.    \}\}
.  \}
.  el \{ .ie "\$1"-compact" \
.    nr doc-is-compact 1
.  el \{ .ie "\$1"-file" \{\
.    ie !"\$2"" \{\
.      ds doc-display-file "\$2
.      nr doc-reg-ddBa 2
.    \}
.    el \
.      tm mdoc warning: .Bd '-file' keyword requires argument (#\n[.c])
.  \}
.  el \
.      tm mdoc warning: Unknown keyword '\$1' in .Bd macro (#\n[.c])
.  \}\}
.
.  if (\n[doc-reg-ddBa] < \n[.$]) \{\
.    shift \n[doc-reg-ddBa]
.    doc-do-Bd-args \$@
.  \}
..
.ec
.
.
.\" NS Ed user macro
.\" NS   end display
.\" NS
.\" NS modifies:
.\" NS   doc-display-depth
.\" NS   doc-display-indent-stackXXX
.\" NS   doc-display-type-stackXXX
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Ed' set in doc-common
.
.eo
.de Ed
.  ds doc-macro-name Ed
.
.  br
.
.  if !\n[doc-display-depth] \{\
.    tm mdoc warning: Extraneous .Ed (#\n[.c])
.    nr doc-display-depth 1
.  \}
.
.  if "\*[doc-display-type-stack\n[doc-display-depth]]"literal" \{\
.    ft \n[doc-display-ft-stack\n[doc-display-depth]]
.    ps \n[doc-display-ps-stack\n[doc-display-depth]]u
.  \}
.
.  in -\n[doc-display-indent-stack\n[doc-display-depth]]u
.
.  \" restore saved adjustment and fill modes
.  ie \n[doc-display-fi-stack\n[doc-display-depth]] \
.    fi
.  el \
.    nf
.  ad \n[doc-display-ad-stack\n[doc-display-depth]]
.
.  nr doc-display-indent-stack\n[doc-display-depth] 0
.  ds doc-display-type-stack\n[doc-display-depth]
.  nr doc-display-depth -1
..
.ec
.
.
.\" NS doc-list-type-stackXXX global string
.\" NS   stack of list types
.\" NS
.\" NS limit:
.\" NS   doc-list-depth
.
.ds doc-list-type-stack1
.
.
.\" NS doc-list-indent-stackXXX global register
.\" NS   stack of list indentation values
.\" NS
.\" NS limit:
.\" NS   doc-list-depth
.
.nr doc-list-indent-stack1 0
.
.
.\" NS doc-list-have-indent-stackXXX global register (bool)
.\" NS   an indentation value is active
.\" NS
.\" NS limit:
.\" NS   doc-list-depth
.
.nr doc-list-have-indent-stack1 0
.
.
.\" NS Bl user macro
.\" NS   begin list
.\" NS
.\" NS width register 'Bl' set in doc-common
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-argXXX
.\" NS   doc-list-depth
.\" NS   doc-list-have-indent-stackXXX
.\" NS   doc-list-indent-stackXXX
.\" NS   doc-list-type-stackXXX
.\" NS   doc-macro-name
.\" NS   doc-num-args
.\" NS   doc-num-columns
.\" NS
.\" NS local variables:
.\" NS   doc-reg-Bl
.
.eo
.de Bl
.  if !\n[.$] \{\
.    doc-Bl-usage
.    return
.  \}
.
.  ds doc-macro-name Bl
.  nr doc-list-depth +1
.  nr doc-arg-ptr 1
.
.  ie        "\$1"-hang" \{\
.    ds doc-list-type-stack\n[doc-list-depth] hang-list
.    nr doc-list-indent-stack\n[doc-list-depth] 6n
.    nr doc-list-have-indent-stack\n[doc-list-depth] 1
.  \}
.  el \{ .ie "\$1"-tag" \{\
.    ds doc-list-type-stack\n[doc-list-depth] tag-list
.    nr doc-list-indent-stack\n[doc-list-depth] 6n
.    nr doc-list-have-indent-stack\n[doc-list-depth] 1
.  \}
.  el \{ .ie "\$1"-item" \{\
.    ds doc-list-type-stack\n[doc-list-depth] item-list
.    nr doc-list-have-indent-stack\n[doc-list-depth] 1
.  \}
.  el \{ .ie "\$1"-enum" \{\
.    ds doc-list-type-stack\n[doc-list-depth] enum-list
.    nr doc-list-indent-stack\n[doc-list-depth] 3n
.    nr doc-list-have-indent-stack\n[doc-list-depth] 1
.  \}
.  el \{ .ie "\$1"-bullet" \{\
.    ds doc-list-type-stack\n[doc-list-depth] bullet-list
.    nr doc-list-indent-stack\n[doc-list-depth] 2n
.    nr doc-list-have-indent-stack\n[doc-list-depth] 1
.  \}
.  el \{ .ie "\$1"-dash" \{\
.    ds doc-list-type-stack\n[doc-list-depth] dash-list
.    nr doc-list-indent-stack\n[doc-list-depth] 2n
.    nr doc-list-have-indent-stack\n[doc-list-depth] 1
.  \}
.  el \{ .ie "\$1"-hyphen" \{\
.    ds doc-list-type-stack\n[doc-list-depth] dash-list
.    nr doc-list-indent-stack\n[doc-list-depth] 2n
.    nr doc-list-have-indent-stack\n[doc-list-depth] 1
.  \}
.  el \{ .ie "\$1"-inset" \{\
.    ds doc-list-type-stack\n[doc-list-depth] inset-list
.    nr doc-list-have-indent-stack\n[doc-list-depth] 1
.  \}
.  el \{ .ie "\$1"-diag" \{\
.    ds doc-list-type-stack\n[doc-list-depth] diag-list
.  \}
.  el \{ .ie "\$1"-ohang" \{\
.    ds doc-list-type-stack\n[doc-list-depth] ohang-list
.    nr doc-list-have-indent-stack\n[doc-list-depth] 1
.  \}
.  el \{ .ie "\$1"-column" \{\
.    ds doc-list-type-stack\n[doc-list-depth] column-list
.    linetabs 1
.  \}
.  el \{\
.    tm1 "mdoc warning: Unknown list type '\$1' (or missing list type)
.    tm1 "              in .Bl macro
.    tm
.    nr doc-arg-ptr 0
.  \}\}\}\}\}\}\}\}\}\}\}
.
.  \" we have seen a list type
.  if !\n[doc-arg-ptr] \{\
.    doc-Bl-usage
.    doc-reset-args
.    nr doc-list-depth -1
.    return
.  \}
.
.  shift
.
.  \" fill argument vector
.  nr doc-reg-Bl 1
.  while (\n[doc-reg-Bl] <= \n[.$]) \{\
.    ds doc-arg\n[doc-reg-Bl] "\$[\n[doc-reg-Bl]]
.    \" dummy type and space so that doc-save-global-vars() doesn't warn
.    nr doc-type\n[doc-reg-Bl] 0
.    ds doc-space\n[doc-reg-Bl]
.    nr doc-reg-Bl +1
.  \}
.
.  doc-increment-list-stack
.
.  if \n[.$] \{\
.    nr doc-arg-count \n[.$]
.    nr doc-arg-ptr 0
.    doc-do-Bl-args
.
.    in +\n[doc-list-offset-stack\n[doc-list-depth]]u
.
.    \" initialize column list
.    if "\*[doc-list-type-stack\n[doc-list-depth]]"column-list" \{\
.      doc-set-column-tab \n[doc-num-columns]
'      in -\n[doc-column-indent-width]u
.      if !\n[doc-compact-list-stack\n[doc-list-depth]] \
.        sp \n[doc-display-vertical]u
.
.      nf
.      nr doc-num-columns 0
.  \}\}
.
.  doc-reset-args
..
.ec
.
.
.\" NS doc-Bl-usage macro
.
.eo
.de doc-Bl-usage
.  tm1 "Usage: .Bl {-hang | -ohang | -tag | -diag | -inset}
.  tm1 "             [-width <string>]
.  tm1 "             [-offset <string>] [-compact]
.  tm1 "       .Bl -column [-offset <string>] <string1> <string2> ...
.  tm1 "       .Bl {-item | -enum [-nested] | -bullet | -hyphen | -dash}
.  tm1 "             [-offset <string>] [-compact] (#\n[.c])
..
.ec
.
.
.\" NS doc-do-Bl-args macro
.\" NS   resolve remaining .Bl arguments
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-argXXX
.\" NS   doc-compact-list-stackXXX
.\" NS   doc-list-indent-stackXXX
.\" NS   doc-list-offset-stackXXX
.\" NS   doc-num-columns
.\" NS   doc-tag-prefix-stackXXX
.\" NS
.\" NS local variables:
.\" NS   doc-box-dBla
.\" NS   doc-env-dBla
.\" NS   doc-reg-dBla
.\" NS   doc-reg-dBla1
.\" NS   doc-reg-dBla2
.\" NS   doc-reg-dBla3
.\" NS   doc-reg-dBla4
.\" NS   doc-str-dBla
.\" NS   doc-str-dBla1
.
.eo
.de doc-do-Bl-args
.  nr doc-arg-ptr +1
.
.  if (\n[doc-arg-count] < \n[doc-arg-ptr]) \
.    return
.
.  \" avoid a warning message in case e.g. '-offset' has no parameter
.  nr doc-reg-dBla (\n[doc-arg-ptr] + 1)
.  if (\n[doc-arg-count] < \n[doc-reg-dBla]) \
.    ds doc-arg\n[doc-reg-dBla]
.
.  nr doc-reg-dBla 1
.
.  ie        "\*[doc-arg\n[doc-arg-ptr]]"-compact" \
.    nr doc-compact-list-stack\n[doc-list-depth] 1
.
.  el \{ .ie "\*[doc-arg\n[doc-arg-ptr]]"-nested" \{\
.    ie (\n[doc-list-depth] > 1) \{\
.      nr doc-reg-dBla1 (\n[doc-list-depth] - 1)
.      ds doc-tag-prefix-stack\n[doc-list-depth] "\*[doc-tag-prefix-stack\n[doc-reg-dBla1]]
.      as doc-tag-prefix-stack\n[doc-list-depth] \n[doc-enum-list-count-stack\n[doc-reg-dBla1]].
.      length doc-reg-dBla1 "\*[doc-tag-prefix-stack\n[doc-list-depth]]
.      nr doc-list-indent-stack\n[doc-list-depth] +\n[doc-reg-dBla1]n
.    \}
.    el \
.      tm mdoc warning: '-nested' allowed with nested .Bl macros only (#\n[.c])
.  \}
.
.  el \{ .ie "\*[doc-arg\n[doc-arg-ptr]]"-width" \{\
.    nr doc-arg-ptr +1
.    ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
.    substring doc-str-dBla 0 0
.    ie '.'\*[doc-str-dBla]' \{\
.      ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
.      substring doc-str-dBla 1
.      doc-first-parameter \*[doc-str-dBla]
.      doc-get-width "\*[doc-str-dfp]
.      doc-get-arg-type "\*[doc-str-dfp]
.      ie (\n[doc-arg-type] == 1) \
.        nr doc-reg-dBla1 1
.      el \
.        nr doc-reg-dBla1 0
.    \}
.    el \
.      nr doc-reg-dBla1 0
.    ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
.
.    ie \n[doc-reg-dBla1] \{\
.      \" execute string in a box to get the width of the diversion
.      ds doc-str-dBla \*[doc-arg\n[doc-arg-ptr]]
.      doc-save-global-vars
.      doc-reset-args
.      box doc-box-dBla
.      ev doc-env-dBla
.      evc 0
.      in 0
.      nf
.      nop \*[doc-str-dBla]
.      br
.      ev
.      box
.      doc-restore-global-vars
.      doc-get-width \h'\n[dl]u'
.      nr doc-list-indent-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
.    \}
.    el \{\
.      \" test whether argument is a valid numeric expression
.      nr doc-reg-dBla1 0
.      if \B'(\*[doc-str-dBla])' \{\
.        \" disable warnings related to scaling indicators (32)
.        nr doc-reg-dBla2 \n[.warn]
.        warn (\n[.warn] - (\n[.warn] / 32 % 2 * 32))
.
.        \" values without a scaling indicator are taken as strings;
.        \" we test whether the parameter string with and without the
.        \" last character yields identical numerical results (ignoring
.        \" the scaling indicator)
.        ds doc-str-dBla1 "\*[doc-str-dBla]
.        substring doc-str-dBla1 0 -2
.        if \B'(\*[doc-str-dBla1])' \{\
.          nr doc-reg-dBla3 (;(\*[doc-str-dBla]))
.          nr doc-reg-dBla4 (\*[doc-str-dBla1])
.          if (\n[doc-reg-dBla3] == \n[doc-reg-dBla4]) \
.            nr doc-reg-dBla1 1
.        \}
.
.        \" enable all warnings again
.        warn \n[doc-reg-dBla2]
.      \}
.
.      ie \n[doc-reg-dBla1] \
.        nr doc-list-indent-stack\n[doc-list-depth] (\*[doc-str-dBla])
.      el \{\
.        doc-get-arg-width \n[doc-arg-ptr]
.        ie (\n[doc-width] == 2) \{\
.          \" if the width parameter is a macro, use the macro's
.          \" width as specified in doc-common
.          doc-get-arg-type \*[doc-str-dBla]
.          ie (\n[doc-arg-type] == 1) \
.            nr doc-list-indent-stack\n[doc-list-depth] \n[\*[doc-str-dBla]]
.          el \
.            nr doc-list-indent-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
.        \}
.        el \
.          nr doc-list-indent-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
.  \}\}\}
.
.  el \{ .ie "\*[doc-arg\n[doc-arg-ptr]]"-offset" \{\
.    nr doc-arg-ptr +1
.
.    ie "\*[doc-arg\n[doc-arg-ptr]]"indent" \
.      nr doc-list-offset-stack\n[doc-list-depth] \n[doc-display-indent]u
.    el \{\
.      ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
.      nr doc-reg-dBla1 0
.      if \B'(\*[doc-str-dBla])' \{\
.        nr doc-reg-dBla2 \n[.warn]
.        warn (\n[.warn] - (\n[.warn] / 32 % 2 * 32))
.
.        ds doc-str-dBla1 "\*[doc-str-dBla]
.        substring doc-str-dBla1 0 -2
.        if \B'(\*[doc-str-dBla1])' \{\
.          nr doc-reg-dBla3 (;(\*[doc-str-dBla]))
.          nr doc-reg-dBla4 (\*[doc-str-dBla1])
.          if (\n[doc-reg-dBla3] == \n[doc-reg-dBla4]) \
.            nr doc-reg-dBla1 1
.        \}
.
.        warn \n[doc-reg-dBla2]
.      \}
.
.      ie \n[doc-reg-dBla1] \
.        nr doc-list-offset-stack\n[doc-list-depth] \*[doc-str-dBla]
.      el \{\
.        doc-get-arg-width \n[doc-arg-ptr]
.        ie (\n[doc-width] <= 3) \{\
.          \" if the offset parameter is a macro, use the macro's
.          \" width as specified in doc-common
.          doc-get-arg-type \*[doc-str-dBla]
.          ie (\n[doc-arg-type] == 1) \
.            nr doc-list-offset-stack\n[doc-list-depth] \n[\*[doc-str-dBla]]
.          el \
.            nr doc-list-offset-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
.        \}
.        el \
.          nr doc-list-offset-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
.  \}\}\}
.  el \
.    nr doc-reg-dBla 0
.  \}\}\}
.
.  \" not a known keyword, so it specifies the width of the next column
.  \" (if it is a column list)
.  if !\n[doc-reg-dBla] \{\
.    ie "\*[doc-list-type-stack\n[doc-list-depth]]"column-list" \{\
.      nr doc-num-columns +1
.      ds doc-str-dBla \*[doc-arg\n[doc-arg-ptr]]
.      substring doc-str-dBla 0 0
.      ie '.'\*[doc-str-dBla]' \{\
.        ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
.        substring doc-str-dBla 1
.        doc-first-parameter \*[doc-str-dBla]
.        doc-get-width "\*[doc-str-dfp]
.        doc-get-arg-type "\*[doc-str-dfp]
.        ie (\n[doc-arg-type] == 1) \
.          nr doc-reg-dBla1 1
.        el \
.          nr doc-reg-dBla1 0
.      \}
.      el \
.        nr doc-reg-dBla1 0
.      ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
.
.      ie \n[doc-reg-dBla1] \{\
.        \" execute string in a box to get the width of the diversion
.        ds doc-str-dBla \*[doc-arg\n[doc-arg-ptr]]
.        doc-save-global-vars
.        doc-reset-args
.        box doc-box-dBla
.        ev doc-env-dBla
.        evc 0
.        in 0
.        nf
.        nop \*[doc-str-dBla]
.        br
.        ev
.        box
.        doc-restore-global-vars
.        ds doc-arg\n[doc-num-columns] "\h'\n[dl]u'
.      \}
.      el \
.        ds doc-arg\n[doc-num-columns] "\*[doc-arg\n[doc-arg-ptr]]
.    \}
.    el \{\
.      tmc mdoc warning: Unknown keyword '\*[doc-arg\n[doc-arg-ptr]]'
.      tm1 " in .Bl macro (#\n[.c])
.  \}\}
.
.  if (\n[doc-arg-count] > \n[doc-arg-ptr]) \
.    doc-do-Bl-args
..
.ec
.
.
.\" NS doc-save-global-vars macro
.\" NS   save all global variables
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dsgv
.
.eo
.de doc-save-global-vars
.  ds doc-macro-name-saved "\*[doc-macro-name]
.  nr doc-arg-count-saved \n[doc-arg-count]
.  nr doc-num-args-saved \n[doc-num-args]
.  nr doc-arg-ptr-saved \n[doc-arg-ptr]
.
.  nr doc-reg-dsgv 1
.  while (\n[doc-reg-dsgv] <= \n[doc-arg-count]) \{\
.    ds doc-arg\n[doc-reg-dsgv]-saved "\*[doc-arg\n[doc-reg-dsgv]]
.    nr doc-type\n[doc-reg-dsgv]-saved \n[doc-type\n[doc-reg-dsgv]]
.    ds doc-space\n[doc-reg-dsgv]-saved "\*[doc-space\n[doc-reg-dsgv]]
.    nr doc-reg-dsgv +1
.  \}
.
.  nr doc-curr-font-saved \n[doc-curr-font]
.  nr doc-in-name-section-saved \n[doc-in-name-section]
.  nr doc-in-synopsis-section-saved \n[doc-in-synopsis-section]
.  nr doc-in-library-section-saved \n[doc-in-library-section]
.  nr doc-indent-synopsis-saved \n[doc-indent-synopsis]
.  nr doc-indent-synopsis-active-saved \n[doc-indent-synopsis-active]
.  nr doc-have-decl-saved \n[doc-have-decl]
.  nr doc-have-var-saved \n[doc-have-var]
.  ds doc-topic-name-saved "\*[doc-topic-name]
.  ds doc-quote-left-saved "\*[doc-quote-left]
.  ds doc-quote-right-saved "\*[doc-quote-right]
.  nr doc-nesting-level-saved \n[doc-nesting-level]
.  nr doc-in-list-saved \n[doc-in-list]
.  ds doc-space-saved "\*[doc-space]
.  ds doc-saved-space-saved "\*[doc-saved-space]
.  nr doc-space-mode-saved \n[doc-space-mode]
.  nr doc-have-space-saved \n[doc-have-space]
.  nr doc-have-slot-saved \n[doc-have-slot]
.  nr doc-keep-type-saved \n[doc-keep-type]
.  nr doc-display-depth-saved \n[doc-display-depth]
.  nr doc-is-compact-saved \n[doc-is-compact]
.
.  nr doc-reg-dsgv 0
.  while (\n[doc-reg-dsgv] <= \n[doc-display-depth]) \{\
.    ds doc-display-type-stack\n[doc-reg-dsgv]-saved "\*[doc-display-type-stack\n[doc-reg-dsgv]]
.    nr doc-display-indent-stack\n[doc-reg-dsgv]-saved \n[doc-display-indent-stack\n[doc-reg-dsgv]]
.    nr doc-display-ad-stack\n[doc-reg-dsgv]-saved \n[doc-display-ad-stack\n[doc-reg-dsgv]]
.    nr doc-display-fi-stack\n[doc-reg-dsgv]-saved \n[doc-display-fi-stack\n[doc-reg-dsgv]]
.    nr doc-display-ft-stack\n[doc-reg-dsgv]-saved \n[doc-display-ft-stack\n[doc-reg-dsgv]]
.    nr doc-display-ps-stack\n[doc-reg-dsgv]-saved \n[doc-display-ps-stack\n[doc-reg-dsgv]]
.    nr doc-reg-dsgv +1
.  \}
.
.  nr doc-fontmode-depth-saved \n[doc-fontmode-depth]
.
.  nr doc-reg-dsgv 1
.  while (\n[doc-reg-dsgv] <= \n[doc-fontmode-depth]) \{\
.    nr doc-fontmode-font-stack\n[doc-reg-dsgv]-saved \n[doc-fontmode-font-stack\n[doc-reg-dsgv]]
.    nr doc-fontmode-size-stack\n[doc-reg-dsgv]-saved \n[doc-fontmode-size-stack\n[doc-reg-dsgv]]
.    nr doc-reg-dsgv +1
.  \}
.
.  nr doc-list-depth-saved \n[doc-list-depth]
.
.  nr doc-reg-dsgv 1
.  while (\n[doc-reg-dsgv] <= \n[doc-list-depth]) \{\
.    ds doc-list-type-stack\n[doc-reg-dsgv]-saved "\*[doc-list-type-stack\n[doc-reg-dsgv]]
.    nr doc-list-have-indent-stack\n[doc-reg-dsgv]-saved \n[doc-list-have-indent-stack\n[doc-reg-dsgv]]
.    nr doc-list-indent-stack\n[doc-reg-dsgv]-saved \n[doc-list-indent-stack\n[doc-reg-dsgv]]
.    nr doc-compact-list-stack\n[doc-reg-dsgv]-saved \n[doc-compact-list-stack\n[doc-reg-dsgv]]
.    ds doc-tag-prefix-stack\n[doc-reg-dsgv]-saved "\*[doc-tag-prefix-stack\n[doc-reg-dsgv]]
.    nr doc-list-offset-stack\n[doc-reg-dsgv]-saved \n[doc-list-offset-stack\n[doc-reg-dsgv]]
.    nr doc-enum-list-count-stack\n[doc-reg-dsgv]-saved \n[doc-enum-list-count-stack\n[doc-reg-dsgv]]
.    nr doc-reg-dsgv +1
.  \}
.
.  nr doc-curr-type-saved \n[doc-curr-type]
.  ds doc-curr-arg-saved "\*[doc-curr-arg]
.  nr doc-diag-list-input-line-count-saved \n[doc-diag-list-input-line-count]
.  nr doc-num-columns-saved \n[doc-num-columns]
.  nr doc-column-indent-width-saved \n[doc-column-indent-width]
.  nr doc-is-func-saved \n[doc-is-func]
.  nr doc-have-old-func-saved \n[doc-have-old-func]
.  nr doc-func-arg-count-saved \n[doc-func-arg-count]
.  ds doc-func-arg-saved "\*[doc-func-arg]
.  nr doc-num-func-args-saved \n[doc-num-func-args]
.  nr doc-func-args-processed-saved \n[doc-func-args-processed]
.  nr doc-have-func-saved \n[doc-have-func]
.  nr doc-is-reference-saved \n[doc-is-reference]
.  nr doc-reference-count-saved \n[doc-reference-count]
.  nr doc-author-count-saved \n[doc-author-count]
.
.  nr doc-reg-dsgv 0
.  while (\n[doc-reg-dsgv] <= \n[doc-author-count]) \{\
.    ds doc-author-name\n[doc-reg-dsgv]-saved "\*[doc-author-name\n[doc-reg-dsgv]]
.    nr doc-reg-dsgv +1
.  \}
.
.  nr doc-book-count-saved \n[doc-book-count]
.  ds doc-book-name-saved "\*[doc-book-name]
.  nr doc-city-count-saved \n[doc-city-count]
.  ds doc-city-name-saved "\*[doc-city-name]
.  nr doc-date-count-saved \n[doc-date-count]
.  ds doc-date-saved "\*[doc-date]
.  nr doc-publisher-count-saved \n[doc-publisher-count]
.  ds doc-publisher-name-saved "\*[doc-publisher-name]
.  nr doc-journal-count-saved \n[doc-journal-count]
.  ds doc-journal-name-saved "\*[doc-journal-name]
.  nr doc-issue-count-saved \n[doc-issue-count]
.  ds doc-issue-name-saved "\*[doc-issue-name]
.  nr doc-optional-count-saved \n[doc-optional-count]
.  ds doc-optional-string-saved "\*[doc-optional-string]
.  nr doc-page-number-count-saved \n[doc-page-number-count]
.  ds doc-page-number-string-saved "\*[doc-page-number-string]
.  nr doc-corporate-count-saved \n[doc-corporate-count]
.  ds doc-corporate-name-saved "\*[doc-corporate-name]
.  nr doc-report-count-saved \n[doc-report-count]
.  ds doc-report-name-saved "\*[doc-report-name]
.  nr doc-reference-title-count-saved \n[doc-reference-title-count]
.  ds doc-reference-title-name-saved "\*[doc-reference-title-name]
.  ds doc-reference-title-name-for-book-saved "\*[doc-reference-title-name-for-book]
.  nr doc-url-count-saved \n[doc-url-count]
.  ds doc-url-name-saved "\*[doc-url-name]
.  nr doc-volume-count-saved \n[doc-volume-count]
.  ds doc-volume-name-saved "\*[doc-volume-name]
.  nr doc-have-author-saved \n[doc-have-author]
.
.  ds doc-page-topic-saved "\*[doc-page-topic]
.  ds doc-volume-saved "\*[doc-volume]
.  ds doc-section-saved "\*[doc-section]
.  ds doc-operating-system-saved "\*[doc-operating-system]
.  ds doc-date-string-saved "\*[doc-date-string]
.  nr doc-display-vertical-saved \n[doc-display-vertical]
.  nr doc-in-see-also-section-saved \n[doc-in-see-also-section]
.  nr doc-in-files-section-saved \n[doc-in-files-section]
.  nr doc-in-authors-section-saved \n[doc-in-authors-section]
..
.ec
.
.
.\" NS doc-restore-global-vars macro
.\" NS   restore all global variables
.\" NS
.\" NS local variables:
.\" NS   doc-reg-drgv
.
.eo
.de doc-restore-global-vars
.  ds doc-macro-name "\*[doc-macro-name-saved]
.  nr doc-arg-count \n[doc-arg-count-saved]
.  nr doc-num-args \n[doc-num-args-saved]
.  nr doc-arg-ptr \n[doc-arg-ptr-saved]
.
.  nr doc-reg-drgv 1
.  while (\n[doc-reg-drgv] <= \n[doc-arg-count]) \{\
.    ds doc-arg\n[doc-reg-drgv] "\*[doc-arg\n[doc-reg-drgv]-saved]
.    nr doc-type\n[doc-reg-drgv] \n[doc-type\n[doc-reg-drgv]-saved]
.    ds doc-space\n[doc-reg-drgv] "\*[doc-space\n[doc-reg-drgv]-saved]
.    nr doc-reg-drgv +1
.  \}
.
.  nr doc-curr-font \n[doc-curr-font-saved]
.  nr doc-in-name-section \n[doc-in-name-section-saved]
.  nr doc-in-synopsis-section \n[doc-in-synopsis-section-saved]
.  nr doc-in-library-section \n[doc-in-library-section-saved]
.  nr doc-indent-synopsis \n[doc-indent-synopsis-saved]
.  nr doc-indent-synopsis-active \n[doc-indent-synopsis-active-saved]
.  nr doc-have-decl \n[doc-have-decl-saved]
.  nr doc-have-var \n[doc-have-var-saved]
.  ds doc-topic-name "\*[doc-topic-name-saved]
.  ds doc-quote-left "\*[doc-quote-left-saved]
.  ds doc-quote-right "\*[doc-quote-right-saved]
.  nr doc-nesting-level \n[doc-nesting-level-saved]
.  nr doc-in-list \n[doc-in-list-saved]
.  ds doc-space "\*[doc-space-saved]
.  ds doc-saved-space "\*[doc-saved-space-saved]
.  nr doc-space-mode \n[doc-space-mode-saved]
.  nr doc-have-space \n[doc-have-space-saved]
.  nr doc-have-slot \n[doc-have-slot-saved]
.  nr doc-keep-type \n[doc-keep-type-saved]
.  nr doc-display-depth \n[doc-display-depth-saved]
.  nr doc-is-compact \n[doc-is-compact-saved]
.
.  nr doc-reg-drgv 0
.  while (\n[doc-reg-drgv] <= \n[doc-display-depth]) \{\
.    ds doc-display-type-stack\n[doc-reg-drgv] "\*[doc-display-type-stack\n[doc-reg-drgv]-saved]
.    nr doc-display-indent-stack\n[doc-reg-drgv] \n[doc-display-indent-stack\n[doc-reg-drgv]-saved]
.    nr doc-display-ad-stack\n[doc-reg-drgv] \n[doc-display-ad-stack\n[doc-reg-drgv]-saved]
.    nr doc-display-fi-stack\n[doc-reg-drgv] \n[doc-display-fi-stack\n[doc-reg-drgv]-saved]
.    nr doc-display-ft-stack\n[doc-reg-drgv] \n[doc-display-ft-stack\n[doc-reg-drgv]-saved]
.    nr doc-display-ps-stack\n[doc-reg-drgv] \n[doc-display-ps-stack\n[doc-reg-drgv]-saved]
.    nr doc-reg-drgv +1
.  \}
.
.  nr doc-fontmode-depth \n[doc-fontmode-depth-saved]
.
.  nr doc-reg-drgv 1
.  while (\n[doc-reg-drgv] <= \n[doc-fontmode-depth]) \{\
.    nr doc-fontmode-font-stack\n[doc-reg-drgv] \n[doc-fontmode-font-stack\n[doc-reg-drgv]]-saved
.    nr doc-fontmode-size-stack\n[doc-reg-drgv] \n[doc-fontmode-size-stack\n[doc-reg-drgv]]-saved
.    nr doc-reg-drgv +1
.  \}
.
.  nr doc-list-depth \n[doc-list-depth-saved]
.
.  nr doc-reg-drgv 1
.  while (\n[doc-reg-drgv] <= \n[doc-list-depth]) \{\
.    ds doc-list-type-stack\n[doc-reg-drgv] "\*[doc-list-type-stack\n[doc-reg-drgv]-saved]
.    nr doc-list-have-indent-stack\n[doc-reg-drgv] \n[doc-list-have-indent-stack\n[doc-reg-drgv]-saved]
.    nr doc-list-indent-stack\n[doc-reg-drgv] \n[doc-list-indent-stack\n[doc-reg-drgv]-saved]
.    nr doc-compact-list-stack\n[doc-reg-drgv] \n[doc-compact-list-stack\n[doc-reg-drgv]-saved]
.    ds doc-tag-prefix-stack\n[doc-reg-drgv] "\*[doc-tag-prefix-stack\n[doc-reg-drgv]-saved]
.    nr doc-list-offset-stack\n[doc-reg-drgv] \n[doc-list-offset-stack\n[doc-reg-drgv]-saved]
.    nr doc-enum-list-count-stack\n[doc-reg-drgv] \n[doc-enum-list-count-stack\n[doc-reg-drgv]-saved]
.    nr doc-reg-drgv +1
.  \}
.
.  nr doc-curr-type \n[doc-curr-type-saved]
.  ds doc-curr-arg "\*[doc-curr-arg-saved]
.  nr doc-diag-list-input-line-count \n[doc-diag-list-input-line-count-saved]
.  nr doc-num-columns \n[doc-num-columns-saved]
.  nr doc-column-indent-width \n[doc-column-indent-width-saved]
.  nr doc-is-func \n[doc-is-func-saved]
.  nr doc-have-old-func \n[doc-have-old-func-saved]
.  nr doc-func-arg-count \n[doc-func-arg-count-saved]
.  ds doc-func-arg "\*[doc-func-arg-saved]
.  nr doc-num-func-args \n[doc-num-func-args-saved]
.  nr doc-func-args-processed \n[doc-func-args-processed-saved]
.  nr doc-have-func \n[doc-have-func-saved]
.  nr doc-is-reference \n[doc-is-reference-saved]
.  nr doc-reference-count \n[doc-reference-count-saved]
.  nr doc-author-count \n[doc-author-count-saved]
.
.  nr doc-reg-drgv 0
.  while (\n[doc-reg-drgv] <= \n[doc-author-count]) \{\
.    ds doc-author-name\n[doc-reg-drgv] "\*[doc-author-name\n[doc-reg-drgv]-saved]
.    nr doc-reg-drgv +1
.  \}
.
.  nr doc-book-count \n[doc-book-count-saved]
.  ds doc-book-name "\*[doc-book-name-saved]
.  nr doc-city-count \n[doc-city-count-saved]
.  ds doc-city-name "\*[doc-city-name-saved]
.  nr doc-date-count \n[doc-date-count-saved]
.  ds doc-date "\*[doc-date-saved]
.  nr doc-publisher-count \n[doc-publisher-count-saved]
.  ds doc-publisher-name "\*[doc-publisher-name-saved]
.  nr doc-journal-count \n[doc-journal-count-saved]
.  ds doc-journal-name "\*[doc-journal-name-saved]
.  nr doc-issue-count \n[doc-issue-count-saved]
.  ds doc-issue-name "\*[doc-issue-name-saved]
.  nr doc-optional-count \n[doc-optional-count-saved]
.  ds doc-optional-string "\*[doc-optional-string-saved]
.  nr doc-page-number-count \n[doc-page-number-count-saved]
.  ds doc-page-number-string "\*[doc-page-number-string-saved]
.  nr doc-corporate-count \n[doc-corporate-count-saved]
.  ds doc-corporate-name "\*[doc-corporate-name-saved]
.  nr doc-report-count \n[doc-report-count-saved]
.  ds doc-report-name "\*[doc-report-name-saved]
.  nr doc-reference-title-count \n[doc-reference-title-count-saved]
.  ds doc-reference-title-name "\*[doc-reference-title-name-saved]
.  ds doc-reference-title-name-for-book "\*[doc-reference-title-name-for-book-saved]
.  nr doc-url-count \n[doc-url-count-saved]
.  ds doc-url-name "\*[doc-url-name-saved]
.  nr doc-volume-count \n[doc-volume-count-saved]
.  ds doc-volume-name "\*[doc-volume-name-saved]
.  nr doc-have-author \n[doc-have-author-saved]
.
.  ds doc-page-topic "\*[doc-page-topic-saved]
.  ds doc-volume "\*[doc-volume-saved]
.  ds doc-section "\*[doc-section-saved]
.  ds doc-operating-system "\*[doc-operating-system-saved]
.  ds doc-date-string "\*[doc-date-string-saved]
.  nr doc-display-vertical \n[doc-display-vertical-saved]
.  nr doc-in-see-also-section \n[doc-in-see-also-section-saved]
.  nr doc-in-files-section \n[doc-in-files-section-saved]
.  nr doc-in-authors-section \n[doc-in-authors-section-saved]
..
.ec
.
.
.\" NS El user macro
.\" NS   end list
.\" NS
.\" NS modifies:
.\" NS   doc-list-depth
.\" NS   doc-macro-name
.\" NS
.\" NS local variables:
.\" NS   doc-str-El
.\" NS
.\" NS width register 'El' set in doc-common
.
.eo
.de El
.  if \n[.$] \{\
.    tm Usage: .El (does not take arguments) (#\n[.c])
.    return
.  \}
.
.  ds doc-macro-name El
.  ds doc-str-El \*[doc-list-type-stack\n[doc-list-depth]]
.
.  ie        "\*[doc-str-El]"diag-list" \
.    doc-end-list 0
.  el \{ .ie "\*[doc-str-El]"column-list" \
.    doc-end-column-list
.  el \{ .ie "\*[doc-str-El]"item-list" \
.    doc-end-list 0
.  el \{ .ie "\*[doc-str-El]"ohang-list" \
.    doc-end-list 0
.  el \{ .ie "\*[doc-str-El]"inset-list" \
.    doc-end-list 0
.  el \
.    doc-end-list 1
.  \}\}\}\}
.
.  br
..
.ec
.
.
.\" NS doc-curr-type global register
.\" NS   current argument type
.
.nr doc-curr-type 0
.
.
.\" NS doc-curr-arg global string
.\" NS   current argument
.
.ds doc-curr-arg
.
.
.\" NS doc-item-boxXXX global box
.\" NS   item boxes associated list depth
.\" NS
.\" NS limit:
.\" NS   doc-list-depth
.
.
.\" NS It user macro
.\" NS   list item
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-argXXX
.\" NS   doc-curr-arg
.\" NS   doc-curr-type
.\" NS   doc-in-list
.\" NS   doc-macro-name
.\" NS   doc-num-args
.\" NS
.\" NS local variables:
.\" NS   doc-reg-It
.\" NS   doc-str-It
.\" NS   doc-XXX-list-type
.\" NS
.\" NS width register 'It' set in doc-common
.
.nr doc-bullet-list-type 1
.nr doc-column-list-type 0
.nr doc-dash-list-type 1
.nr doc-diag-list-type 0
.nr doc-enum-list-type 1
.nr doc-hang-list-type 2
.nr doc-inset-list-type 2
.nr doc-item-list-type 1
.nr doc-ohang-list-type 2
.nr doc-tag-list-type 2
.
.eo
.de It
.  ds doc-str-It \*[doc-list-type-stack\n[doc-list-depth]]
.
.  if "\*[doc-str-It]"" \
.    tm mdoc error: .It without preceding .Bl (#\n[.c])
.
.  if \n[doc-nesting-level] \{\
.    tmc "mdoc error: .It found in enclosing (e.g. .Ac ... .It ... .Ao)
.    tm1 " (#\n[.c])
.  \}
.
.  br
.  if !\n[cR] \
.    ne 3v
.
.  if \n[.$] \{\
.    ds doc-macro-name It
.
.    \" fill argument vector
.    nr doc-reg-It 1
.    while (\n[doc-reg-It] <= \n[.$]) \{\
.      ds doc-arg\n[doc-reg-It] "\$[\n[doc-reg-It]]
.      nr doc-reg-It +1
.    \}
.
.    nr doc-num-args \n[.$]
.    nr doc-arg-ptr 0
.  \}
.
.  nr doc-reg-It \n[doc-\*[doc-str-It]-type]
.
.  if \n[doc-reg-It] \{\
.    \" start item box
.    box doc-item-box\n[doc-list-depth]
.    ev doc-item-env\n[doc-list-depth]
.    evc 0
.    in 0
.    nf
.  \}
.
.  ie (\n[doc-reg-It] == 1) \{\
.    if \n[.$] \{\
.      tm1 "mdoc warning: .It macros in lists of type '\*[doc-str-It]'
.      tm1 "              don't take arguments (#\n[.c])
.  \}\}
.  el \{\
.    ie \n[.$] \{\
.      if (\n[doc-reg-It] == 2) \{\
.        \" handle list types with arguments
.        doc-parse-arg-vector
.
.        nr doc-in-list 1
.        nr doc-arg-ptr 1
.        nr doc-curr-type \n[doc-type1]
.        ds doc-curr-arg "\*[doc-arg1]
.
.        ie (\n[doc-type1] == 1) \
.          \*[doc-arg1]
.        el \{\
.          nr doc-arg-ptr 1
.          doc-print-recursive
.    \}\}\}
.    el \{\
.      tm1 "mdoc warning: .It macros in lists of type '\*[doc-str-It]'
.      tm1 "              require arguments (#\n[.c])
.    \}
.  \}
.
.  \" the previous call of '.doc-print-recursive' can contain calls to
.  \" opening macros like '.Ao'; we then defer the call of
.  \" 'doc-xxx-list'
.  if !\n[doc-nesting-level] \
.    doc-\*[doc-str-It]
..
.ec
.
.
.\" NS doc-inset-list macro
.\" NS   .It item of list-type inset
.\" NS
.\" NS modifies:
.\" NS   doc-in-list
.
.eo
.de doc-inset-list
.  \" finish item box
.  br
.  ev
.  box
.  unformat doc-item-box\n[doc-list-depth]
.
.  doc-set-vertical-and-indent 0
.  br
.
.  nh
.  doc-item-box\n[doc-list-depth]
.
.  nr doc-in-list 0
.  doc-reset-args
..
.ec
.
.
.\" NS doc-hang-list macro
.\" NS   .It item of list-type hanging tag (as opposed to tagged)
.\" NS
.\" NS modifies:
.\" NS   doc-have-space
.\" NS   doc-in-list
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dhl
.\" NS   doc-reg-dhl1
.
.eo
.de doc-hang-list
.  \" finish item box
.  br
.  ev
.  box
.  unformat doc-item-box\n[doc-list-depth]
.
.  doc-set-vertical-and-indent 1
.  nr doc-reg-dhl (\n[doc-list-indent-stack\n[doc-list-depth]]u + \n[doc-digit-width]u)
.  ti -\n[doc-reg-dhl]u
.
.  nh
.  ie (\n[dl]u > \n[doc-list-indent-stack\n[doc-list-depth]]u) \
.    doc-item-box\n[doc-list-depth]
.  el \{\
.    chop doc-item-box\n[doc-list-depth]
.    nr doc-reg-dhl1 \n[.k]u
.    nop \*[doc-item-box\n[doc-list-depth]]\c
.    nop \h'|(\n[doc-reg-dhl1]u - \n[.k]u + \n[doc-reg-dhl]u)'\c
.    nr doc-have-space 1
.  \}
.
.  nr doc-in-list 0
.  doc-reset-args
..
.ec
.
.
.\" NS doc-ohang-list macro
.\" NS   .It item of list-type overhanging tag
.\" NS
.\" NS modifies:
.\" NS   doc-in-list
.
.eo
.de doc-ohang-list
.  \" finish item box
.  br
.  ev
.  box
.  unformat doc-item-box\n[doc-list-depth]
.
.  doc-set-vertical-and-indent 0
.  nh
.  doc-item-box\n[doc-list-depth]
.  br
.
.  nr doc-in-list 0
.  doc-reset-args
..
.ec
.
.
.\" NS doc-item-list macro
.\" NS   .It item of list-type [empty tag]
.
.eo
.de doc-item-list
.  \" finish (dummy) item box
.  br
.  ev
.  box
.
.  doc-set-vertical-and-indent 0
.  br
.
.  doc-reset-args
..
.ec
.
.
.\" NS doc-enum-list-count-stackXXX global register
.\" NS   stack of current enum count values
.\" NS
.\" NS limit:
.\" NS   doc-list-depth
.
.nr doc-enum-list-count-stack1 0
.
.
.\" NS doc-enum-list macro
.\" NS   enumerated list
.\" NS
.\" NS modifies:
.\" NS   doc-enum-list-count-stackXXX
.\" NS   doc-in-list
.
.eo
.de doc-enum-list
.  nr doc-in-list 1
.  nr doc-enum-list-count-stack\n[doc-list-depth] +1
\# XXX
\#.ll \n[doc-list-indent-stack\n[doc-list-depth]]u
\#.rj
.  nop \*[doc-tag-prefix-stack\n[doc-list-depth]]\c
.  nop \n[doc-enum-list-count-stack\n[doc-list-depth]].\&
.  doc-do-list
..
.ec
.
.
.\" NS doc-bullet-list macro
.\" NS   bullet paragraph list
.\" NS
.\" NS modifies:
.\" NS   doc-in-list
.
.eo
.de doc-bullet-list
.  nr doc-in-list 1
.  nop \)\*[doc-Sy-font]\[bu]\f[]
.  doc-do-list
..
.ec
.
.
.\" NS doc-dash-list macro
.\" NS   hyphen paragraph list (sub bullet list)
.\" NS
.\" NS modifies:
.\" NS   doc-in-list
.
.eo
.de doc-dash-list
.  nr doc-in-list 1
.  nop \)\*[doc-Sy-font]\-\f[]
.  doc-do-list
..
.ec
.
.
.\" NS doc-do-list macro
.\" NS   .It item of list-type enum/bullet/hyphen
.
.als doc-do-list doc-hang-list
.
.
.\" NS doc-diag-list-input-line-count global register
.\" NS   saved line number to be checked in next diag-list item
.
.nr doc-diag-list-input-line-count 0
.
.
.\" NS doc-diag-list macro
.\" NS   .It item of list-type diagnostic-message
.\" NS
.\" NS modifies:
.\" NS   doc-curr-font
.\" NS   doc-diag-list-input-line-count
.
.eo
.de doc-diag-list
.  nr doc-curr-font \n[.f]
.
.  ie ((\n[.c] - \n[doc-diag-list-input-line-count]) > 1) \{\
.    ie !\n[doc-compact-list-stack\n[doc-list-depth]] \
.      doc-paragraph
.    el \
.      br
.  \}
.  el \
.    br
.  nr doc-diag-list-input-line-count \n[.c]
.
.  nh
.  nop \*[doc-Sy-font]\c
.  if \n[doc-num-args] \
.    doc-remaining-args
.  nop \f[\n[doc-curr-font]]\*[doc-hard-space]\c
.
.  doc-print-and-reset
..
.ec
.
.
.\" NS doc-tag-list macro
.\" NS   .It item of list-type 'tag'
.\" NS
.\" NS modifies:
.\" NS   doc-have-space
.\" NS   doc-in-list
.\" NS
.\" NS local variables:
.\" NS   doc-box-dtl
.\" NS   doc-reg-dtl
.\" NS   doc-reg-dtl1
.
.eo
.de doc-tag-list
.  \" finish item box
.  br
.  ev
.  box
.  unformat doc-item-box\n[doc-list-depth]
.
.  \" we use a box without '.nf' to compute the tag width (via 'dl' register)
.  box doc-box-dtl
.  ev doc-env-dtl
.  evc 0
.  fi
.  ad l
.  in 0
.  doc-item-box\n[doc-list-depth]
.  br
.  ev
.  box
.
.  doc-set-vertical-and-indent 1
.  nr doc-reg-dtl (\n[doc-list-indent-stack\n[doc-list-depth]]u + \n[doc-digit-width]u)
.  ti -\n[doc-reg-dtl]u
.
.  nh
.  doc-item-box\n[doc-list-depth]
.  ie (\n[dl]u > \n[doc-list-indent-stack\n[doc-list-depth]]u) \
.    br
.  el \{\
.    \" format the tag separately to prevent stretching of spaces
.    vpt 0
.    br
.    sp -1
.    vpt 1
.    nop \&\c
.    nr doc-have-space 1
.  \}
.
.  nr doc-in-list 0
.  doc-reset-args
..
.ec
.
.
.\" NS doc-set-vertical-and-indent macro
.\" NS   set up vertical spacing (if not compact) and indentation (with
.\" NS   offset if argument is non-zero)
.\" NS
.\" NS modifies:
.\" NS   doc-list-have-indent-stackXXX
.
.eo
.de doc-set-vertical-and-indent
.  if !\n[doc-compact-list-stack\n[doc-list-depth]] \
.    sp \n[doc-display-vertical]u
.
.  if \n[doc-list-have-indent-stack\n[doc-list-depth]] \{\
.    nr doc-list-have-indent-stack\n[doc-list-depth] 0
.    if \$1 \
.      in +(\n[doc-list-indent-stack\n[doc-list-depth]]u + \n[doc-digit-width]u)
.  \}
.
.  if !\n[cR] \
.    ne 2v
..
.ec
.
.
.\" NS doc-list-depth global register
.\" NS   list type stack counter
.
.nr doc-list-depth 0
.
.
.\" NS doc-num-columns global register
.\" NS   number of columns
.
.nr doc-num-columns 0
.
.
.\" NS doc-compact-list-stackXXX global register (bool)
.\" NS   stack of flags to indicate whether a particular list is compact
.\" NS
.\" NS limit:
.\" NS   doc-list-depth
.
.nr doc-compact-list-stack1 0
.
.
.\" NS doc-tag-prefix-stackXXX global string
.\" NS   stack of tag prefixes (currently used for -nested -enum lists)
.\" NS
.\" NS limit:
.\" NS   doc-list-depth
.
.ds doc-tag-prefix-stack1
.
.
.\" NS doc-list-offset-stackXXX global register
.\" NS   stack of list offsets
.\" NS
.\" NS limit:
.\" NS   doc-list-depth
.
.nr doc-list-offset-stack1 0
.
.
.\" NS doc-end-list macro
.\" NS   list end function; resets indentation (and offset if argument
.\" NS   is non-zero)
.\" NS
.\" NS modifies:
.\" NS   doc-list-depth
.\" NS   doc-list-offset-stackXXX
.
.eo
.de doc-end-list
.  if \$1 \
'    in -(\n[doc-list-indent-stack\n[doc-list-depth]]u + \n[doc-digit-width]u)
.
'  in -\n[doc-list-offset-stack\n[doc-list-depth]]u
.
.  if (\n[doc-list-depth] <= 0) \
.    tm mdoc warning: extraneous .El call (#\n[.c])
.
.  doc-decrement-list-stack
.  nr doc-list-depth -1
..
.ec
.
.
.\" NS doc-increment-list-stack macro
.\" NS   set up next block for list
.\" NS
.\" NS modifies:
.\" NS   doc-compact-list-stackXXX
.\" NS   doc-list-have-indent-stackXXX
.\" NS   doc-list-indent-stackXXX
.\" NS   doc-list-offset-stackXXX
.\" NS   doc-list-type-stackXXX
.\" NS   doc-tag-prefix-stackXXX
.\" NS   doc-enum-list-count-stackXXX
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dils
.
.eo
.de doc-increment-list-stack
.  nr doc-reg-dils (\n[doc-list-depth] + 1)
.  nr doc-list-have-indent-stack\n[doc-reg-dils] 0
.  nr doc-list-indent-stack\n[doc-reg-dils] 0
.  nr doc-list-offset-stack\n[doc-reg-dils] 0
.  ds doc-tag-prefix-stack\n[doc-reg-dils]
.  ds doc-list-type-stack\n[doc-reg-dils]
.  nr doc-compact-list-stack\n[doc-reg-dils] 0
.  nr doc-enum-list-count-stack\n[doc-reg-dils] 0
..
.ec
.
.
.\" NS doc-decrement-list-stack macro
.\" NS   decrement stack
.\" NS
.\" NS modifies:
.\" NS   doc-compact-list-stackXXX
.\" NS   doc-list-have-indent-stackXXX
.\" NS   doc-list-indent-stackXXX
.\" NS   doc-list-offset-stackXXX
.\" NS   doc-list-type-stackXXX
.\" NS   doc-tag-prefix-stackXXX
.\" NS   doc-enum-list-count-stackXXX
.
.eo
.de doc-decrement-list-stack
.  ds doc-list-type-stack\n[doc-list-depth]
.  nr doc-list-have-indent-stack\n[doc-list-depth] 0
.  nr doc-list-indent-stack\n[doc-list-depth] 0
.  nr doc-list-offset-stack\n[doc-list-depth] 0
.  ds doc-tag-prefix-stack\n[doc-list-depth]
.  nr doc-compact-list-stack\n[doc-list-depth] 0
.  nr doc-enum-list-count-stack\n[doc-list-depth] 0
..
.ec
.
.
.\" NS Xr user macro
.\" NS   cross reference (for man pages only)
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-macro-name
.\" NS
.\" NS local variables:
.\" NS   doc-reg-Xr
.\" NS
.\" NS width register 'Xr' set in doc-common
.
.eo
.de Xr
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Xr
.      doc-parse-args \$@
.    \}
.    el \
.      doc-Xr-usage
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  doc-print-prefixes
.  ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    \" first argument must be a string
.    ie (\n[doc-type\n[doc-arg-ptr]] == 2) \{\
.      nr doc-curr-font \n[.f]
.      ds doc-arg\n[doc-arg-ptr] \*[doc-Xr-font]\*[doc-arg\n[doc-arg-ptr]]\f[]
.
.      if (\n[doc-arg-count] > \n[doc-arg-ptr]) \{\
.        nr doc-reg-Xr (\n[doc-arg-ptr] + 1)
.        \" modify second argument if it is a string and
.        \" remove space in between
.        if (\n[doc-type\n[doc-reg-Xr]] == 2) \{\
.          ds doc-arg\n[doc-reg-Xr] \*[lp]\*[doc-arg\n[doc-reg-Xr]]\*[rp]
.          ds doc-space\n[doc-arg-ptr]
.        \}
.      \}
.      doc-print-recursive
.    \}
.    el \
.      doc-Xr-usage
.  \}
.  el \
.    doc-Xr-usage
..
.ec
.
.
.\" NS doc-Xr-usage macro
.
.eo
.de doc-Xr-usage
.  tm Usage: .Xr manpage_name [section#] ... (#\n[.c])
.  doc-reset-args
..
.ec
.
.
.\" NS Sx user macro
.\" NS   cross section reference
.\" NS
.\" NS width register 'Sx' set in doc-common
.\"
.\" TODO: This duplicates the definition of `Dq`; figure out how to
.\" simply wrap that macro if possible.  (It's not trivial to do so
.\" because of mdoc's design feature of recursively calling macro
.\" arguments as macros.)
.
.eo
.de Sx
.  if !\n[doc-arg-count] \
.    ds doc-macro-name Sx
.
.  ds doc-quote-left "\*[Lq]
.  ds doc-quote-right "\*[Rq]
.
.  doc-enclose-string \$@
..
.ec
.
.
.\" NS doc-end-column-list macro
.\" NS   column-list end-list
.\" NS
.\" NS modifies:
.\" NS   doc-list-depth
.
.eo
.de doc-end-column-list
.  linetabs 0
'  in -(\n[doc-list-offset-stack\n[doc-list-depth]]u + \n[doc-list-indent-stack\n[doc-list-depth]]u)
.  ta T .5i
.  fi
.  doc-decrement-list-stack
.  nr doc-list-depth -1
..
.ec
.
.
.\" NS doc-column-indent-width global register
.\" NS   holds the indent width for a column list
.
.nr doc-column-indent-width 0
.
.
.\" NS doc-set-column-tab macro
.\" NS   establish tabs for list-type column: '.doc-set-column-tab num_cols'
.\" NS
.\" NS modifies:
.\" NS   doc-column-indent-width
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dsct
.\" NS   doc-str-dsct
.\" NS   doc-str-dsct1
.
.eo
.de doc-set-column-tab
.  ds doc-str-dsct
.  nr doc-reg-dsct 1
.  nr doc-column-indent-width 0
.
.  ie (\$1 < 5) \
.    ds doc-str-dsct1 "    \"
.  el \{\
.    ie (\$1 == 5) \
.      ds doc-str-dsct1 "   \"
.    el \{\
.      \" XXX: this is packed abnormally close -- intercolumn width
.      \"      should be configurable
.      ds doc-str-dsct1 " \"
.  \}\}
.
.  while (\n[doc-reg-dsct] <= \$1) \{\
.    as doc-str-dsct " +\w'\*[doc-arg\n[doc-reg-dsct]]\*[doc-str-dsct1]'u
.    nr doc-column-indent-width +\w'\*[doc-arg\n[doc-reg-dsct]]\*[doc-str-dsct1]'u
.    nr doc-reg-dsct +1
.  \}
.
.  ta \*[doc-str-dsct]
'  in +\n[doc-column-indent-width]u
..
.ec
.
.
.\" NS doc-column-list macro
.\" NS   column items
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-list-indent-stackXXX
.\" NS   doc-spaceXXX
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dcl
.
.eo
.de doc-column-list
.  if \n[doc-num-args] \
.    doc-parse-arg-vector
.  nr doc-arg-ptr +1
.
.  if (\n[doc-arg-count] < \n[doc-arg-ptr]) \{\
.    tm Usage: .It column_string [Ta [column_string ...] ] (#\n[.c])
.    return
.  \}
.
.  if "\*[doc-arg\n[doc-arg-ptr]]"Ta" \{\
.    nr doc-reg-dcl (\n[doc-arg-ptr] - 1)
.    ds doc-space\n[doc-reg-dcl]
.  \}
.
.  if !\n[doc-list-indent-stack\n[doc-list-depth]] \
.    nr doc-list-indent-stack\n[doc-list-depth] \n[doc-column-indent-width]u
.  if !\n[.u] \{\
.    fi
.    in +\n[doc-column-indent-width]u
.  \}
.  ti -\n[doc-column-indent-width]u
.
.  doc-do-\n[doc-type\n[doc-arg-ptr]]
..
.ec
.
.
.\" NS Ta user macro
.\" NS   append tab (\t)
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS
.\" NS width register 'Ta' set in doc-common
.
.eo
.de Ta
.  ie \n[doc-arg-count] \{\
.    nr doc-arg-ptr +1
.    nop \*[doc-tab]\c
.    ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \
.      doc-do-\n[doc-type\n[doc-arg-ptr]]
.    el \
.      doc-reset-args
.  \}
.  el \{\
.    tm1 "Usage: Ta must follow column entry: e.g.
.    tm1 "         .It column_string [Ta [column_string ...]] (#\n[.c])
.  \}
..
.ec
.
.
.\" NS Dl user macro
.\" NS   display (one line) literal
.\" NS
.\" NS   this function uses the 'Li' font
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Dl' set in doc-common
.
.eo
.de Dl
.  ta T .5i
.  in +\n[doc-display-indent]u
.
.  ie \n[doc-arg-count] \{\
.    tm Usage: .Dl not callable by other macros (#\n[.c])
.    doc-reset-args
.  \}
.  el \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Dl
.      doc-parse-args \$@
.      nr doc-arg-ptr 1
.      nr doc-curr-font \n[.f]
.      nop \*[doc-Li-font]\c
.      doc-print-recursive
.    \}
.    el \
.      tm Usage: .Dl argument ... (#\n[.c])
.  \}
.
.  in -\n[doc-display-indent]u
..
.ec
.
.
.\" NS D1 user macro
.\" NS   display (one line)
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'D1' set in doc-common
.
.eo
.de D1
.  ta T .5i
.  in +\n[doc-display-indent]u
.
.  ie \n[doc-arg-count] \{\
.    tm Usage: .D1 not callable by other macros (#\n[.c])
.    doc-reset-args
.  \}
.  el \{\
.    ie \n[.$] \{\
.      ds doc-macro-name D1
.      doc-parse-args \$@
.      nr doc-arg-ptr 1
.      doc-print-recursive
.    \}
.    el \
.      tm Usage: .D1 argument ... (#\n[.c])
.  \}
.
.  in -\n[doc-display-indent]u
..
.ec
.
.
.\" NS Vt user macro
.\" NS   variable type (for forcing old style variable declarations);
.\" NS   this is not done in the same manner as .Ot for fortrash --
.\" NS   clean up later
.\" NS
.\" NS modifies:
.\" NS   doc-curr-font
.\" NS   doc-have-decl
.\" NS   doc-have-var
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Vt' set in doc-common
.
.eo
.de Vt
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Vt
.      doc-parse-args \$@
.    \}
.    el \
.      tm Usage: .Vt variable_type ... (#\n[.c])
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  if (\n[doc-arg-count] < \n[doc-arg-ptr]) \{\
.    tm Usage: .Vt variable_type ... (#\n[.c])
.    doc-reset-args
.    return
.  \}
.
.  if \n[doc-in-synopsis-section] \{\
.    \" if a function declaration was the last thing given,
.    \" want vertical space
.    if \n[doc-have-decl] \{\
.      doc-paragraph
.      nr doc-have-decl 0
.    \}
.
.    \" if a subroutine was the last thing given, want vertical space
.    if \n[doc-have-func] \{\
.      ie \n[doc-have-var] \
.        br
.      el \
.        doc-paragraph
.    \}
.
.    nr doc-have-var 1
.  \}
.
.  nr doc-curr-font \n[.f]
.  nop \*[doc-Ft-font]\c
.  doc-print-recursive
.
.  if \n[doc-in-synopsis-section] \{\
.    ie \n[doc-have-old-func] \
.      nop \*[doc-soft-space]\c
.    el \
.      br
.  \}
..
.ec
.
.
.\" NS doc-is-func global register (bool)
.\" NS   set if subroutine (in synopsis only) (fortran only)
.
.nr doc-is-func 0
.
.
.\" NS Ft user macro
.\" NS   function type
.\" NS
.\" NS modifies:
.\" NS   doc-curr-font
.\" NS   doc-have-decl
.\" NS   doc-have-var
.\" NS   doc-is-func
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Ft' set in doc-common
.
.eo
.de Ft
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Ft
.      doc-parse-args \$@
.    \}
.    el \
.      tm Usage: .Ft function_type ... (#\n[.c])
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  nr doc-arg-ptr +1
.  if (\n[doc-arg-count] < \n[doc-arg-ptr]) \{\
.    tm Usage: .Ft function_type ... (#\n[.c])
.    doc-reset-args
.    return
.  \}
.
.  if \n[doc-in-synopsis-section] \{\
.    if (\n[doc-have-func] : \n[doc-have-decl]) \{\
.      doc-paragraph
.      nr doc-have-decl 0
.      nr doc-have-var 0
.    \}
.
.    if \n[doc-have-var] \{\
.      doc-paragraph
.      nr doc-have-var 0
.    \}
.
.    nr doc-is-func 1
.  \}
.
.  nr doc-curr-font \n[.f]
.  nop \*[doc-Ft-font]\c
.  doc-print-recursive
..
.ec
.
.
.\" NS doc-have-old-func global register (bool)
.\" NS   set if 'Ot' has been called
.
.nr doc-have-old-func 0
.
.
.\" NS Ot user macro
.\" NS   old function type (fortran -- no newline)
.\" NS
.\" NS modifies:
.\" NS   doc-have-decl
.\" NS   doc-have-old-func
.\" NS   doc-have-var
.\" NS   doc-is-func
.\" NS
.\" NS width register 'Ot' set in doc-common
.
.eo
.de Ot
.  nr doc-have-old-func 1
.
.  if \n[doc-in-synopsis-section] \{\
.    if (\n[doc-have-func] : \n[doc-have-decl]) \{\
.      doc-paragraph
.      nr doc-have-decl 0
.      nr doc-have-var 0
.    \}
.
.    if \n[doc-have-var] \{\
.      doc-paragraph
.      nr doc-have-var 0
.    \}
.
.    nr doc-is-func 1
.  \}
.
.  if \n[.$] \
.    nop \*[doc-Ft-font]\$*\c
.  nop \ \f[]\c
..
.ec
.
.
.\" NS Fa user macro
.\" NS   function arguments
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Fa' set in doc-common
.
.eo
.de Fa
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Fa
.      doc-parse-args \$@
.    \}
.    el \
.      tm Usage: .Fa function_arguments ... (#\n[.c])
.  \}
.
.  ie \n[doc-func-arg-count] \
.    doc-do-func
.  el \{\
.    nr doc-arg-ptr +1
.    if (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.      nr doc-curr-font \n[.f]
.      nop \*[doc-Fa-font]\c
.      doc-print-recursive
.
.      if \n[doc-in-synopsis-section] \
.        if \n[doc-have-func] \
.          br
.  \}\}
..
.ec
.
.
.\" NS doc-func-arg-count global register
.\" NS   how many function arguments have been processed so far
.
.nr doc-func-arg-count 0
.
.
.\" NS doc-func-arg global string
.\" NS   work buffer for function name strings
.
.ds doc-func-arg
.
.
.\" NS doc-num-func-args global register
.\" NS   number of function arguments
.
.nr doc-num-func-args 0
.
.
.\" NS doc-func-args-processed global register
.\" NS   function arguments processed so far
.
.nr doc-func-args-processed 0
.
.
.\" NS doc-do-func macro
.\" NS   internal .Fa for .Fc
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-argXXX
.\" NS   doc-func-arg
.\" NS   doc-func-arg-count
.\" NS   doc-func-args-processed
.\" NS   doc-num-func-args
.
.eo
.de doc-do-func
.  if (\n[doc-arg-count] <= \n[doc-arg-ptr]) \{\
.    doc-reset-args
.    return
.  \}
.
.  nr doc-arg-ptr +1
.
.  ds doc-func-arg
.  nr doc-num-func-args 0
.  nr doc-func-args-processed 0
.
.  doc-build-func-string \*[doc-arg\n[doc-arg-ptr]]
.  if (\n[doc-num-func-args] > 1) \
.    ds doc-arg\n[doc-arg-ptr] "\*[doc-func-arg]
.
.  if (\n[doc-func-arg-count] > 1) \{\
.    nop \f[\n[doc-curr-font]]\|\c
.    if !"\*[doc-arg\n[doc-arg-ptr]]"/*" \
.      if !"\*[doc-arg\n[doc-arg-ptr]]"*/" \
.        nop ,\)\c
.    nop \)\*[doc-space\n[doc-arg-ptr]]\*[doc-Fa-font]\c
.    nop \)\*[doc-arg\n[doc-arg-ptr]]\f[]\c
.  \}
.
.  if (\n[doc-func-arg-count] == 1) \{\
.    nop \)\*[doc-Fa-font]\*[doc-arg\n[doc-arg-ptr]]\c
.    nop \f[]\c
.  \}
.  nr doc-func-arg-count +1
.  doc-do-func
..
.ec
.
.
.\" NS doc-have-func global register (bool)
.\" NS   whether we have more than one function in synopsis
.
.nr doc-have-func 0
.
.
.\" NS Fn user macro
.\" NS   functions
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-have-decl
.\" NS   doc-have-func
.\" NS   doc-have-var
.\" NS   doc-indent-synopsis
.\" NS   doc-is-func
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Fn' set in doc-common
.
.eo
.de Fn
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Fn
.      doc-parse-args \$@
.    \}
.    el \
.      tm Usage: .Fn function_name [function_arg] ... (#\n[.c])
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  if \n[doc-in-synopsis-section] \{\
.    \" if there is/has been more than one subroutine declaration
.    ie \n[doc-is-func] \{\
.      br
.      nr doc-have-var 0
.      nr doc-have-decl 0
.      nr doc-is-func 0
.    \}
.    el \{\
.      if \n[doc-have-func] \{\
.        doc-paragraph
.        nr doc-have-var 0
.        nr doc-have-decl 0
.    \}\}
.
.    if \n[doc-have-decl] \{\
.      doc-paragraph
.      nr doc-have-var 0
.    \}
.
.    if \n[doc-have-var] \{\
.      doc-paragraph
.      nr doc-have-decl 0
.    \}
.
.    nr doc-have-func 1
.    nr doc-is-func 0
.
.    br
.    if !\n[doc-indent-synopsis] \
.      nr doc-indent-synopsis (4u * \n[doc-fixed-width]u)
.    if !\n[doc-indent-synopsis-active] \
.      in +\n[doc-indent-synopsis]u
.    ti -\n[doc-indent-synopsis]u
.  \}
.
.  nr doc-arg-ptr +1
.  doc-print-prefixes
.  if (\n[doc-arg-count] < \n[doc-arg-ptr]) \{\
.    tm Usage: .Fn function_name [function_arg] ... (#\n[.c])
.    doc-reset-args
.    return
.  \}
.
.  nr doc-curr-font \n[.f]
.  nop \*[doc-Fn-font]\*[doc-arg\n[doc-arg-ptr]]\c
.  nop \f[]\*[lp]\)\c
.
.  nr doc-arg-ptr +1
.  if (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    if (\n[doc-type\n[doc-arg-ptr]] == 2) \{\
.      nop \*[doc-Fa-font]\c
.      doc-do-func-args
.      nop \f[\n[doc-curr-font]]\c
.  \}\}
.
.  nop \)\*[rp]\)\c
.  if \n[doc-in-synopsis-section] \
.    nop \);\)\c
.
.  ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    \" output the space (if needed)
.    nr doc-arg-ptr -1
.    nop \)\*[doc-space\n[doc-arg-ptr]]\c
.    nr doc-arg-ptr +1
.
.    doc-print-recursive
.  \}
.  el \
.    doc-print-and-reset
.
.  if \n[doc-in-synopsis-section] \
.    if !\n[doc-indent-synopsis-active] \
.      in -\n[doc-indent-synopsis]u
..
.ec
.
.
.\" NS doc-do-func-args macro
.\" NS   handle function arguments
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-argXXX
.\" NS   doc-func-arg
.\" NS   doc-func-args-processed
.\" NS   doc-num-func-args
.\" NS
.\" NS local variables:
.\" NS   doc-reg-ddfa
.
.eo
.de doc-do-func-args
.  if \n[doc-in-synopsis-section] \{\
.    ds doc-func-arg
.    nr doc-num-func-args 0
.    nr doc-func-args-processed 0
.
.    doc-build-func-string \*[doc-arg\n[doc-arg-ptr]]
.    if (\n[doc-num-func-args] > 1) \
.      ds doc-arg\n[doc-arg-ptr] "\*[doc-func-arg]
.  \}
.
.  nop \)\*[doc-arg\n[doc-arg-ptr]]\c
.  nr doc-arg-ptr +1
.
.  if (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    if (\n[doc-type\n[doc-arg-ptr]] == 2) \{\
.      nr doc-reg-ddfa (\n[doc-arg-ptr] - 1)
.      nop \f[\n[doc-curr-font]]\|\c
.      if !"\*[doc-arg\n[doc-arg-ptr]]"/*" \
.        if !"\*[doc-arg\n[doc-arg-ptr]]"*/" \
.          nop ,\)\c
.      nop \)\*[doc-space\n[doc-reg-ddfa]]\f[]\|\c
.      doc-do-func-args
.  \}\}
..
.ec
.
.
.\" NS doc-saved-nesting-level global register
.
.nr doc-saved-nesting-level 0
.
.
.\" NS doc-in-func-enclosure global register (bool)
.
.nr doc-in-func-enclosure 0
.
.
.\" NS Fo user macro
.\" NS   function open
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-func-arg-count
.\" NS   doc-have-decl
.\" NS   doc-have-func
.\" NS   doc-have-var
.\" NS   doc-in-func-enclosure
.\" NS   doc-indent-synopsis
.\" NS   doc-is-func
.\" NS   doc-macro-name
.\" NS   doc-saved-nesting-level
.\" NS
.\" NS width register 'Fo' set in doc-common
.
.eo
.de Fo
.  if (\n[doc-in-func-enclosure]) \{\
.    tm mdoc error: .Fo/.Fc can't be nested (#\n[.c])
.    return
.  \}
.
.  nr doc-saved-nesting-level \n[doc-nesting-level]
.  nr doc-in-func-enclosure 1
.
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ds doc-macro-name Fo
.      doc-parse-args \$@
.    \}
.    el \
.      tm Usage: .Fo function_name (#\n[.c])
.  \}
.
.  if \n[doc-in-synopsis-section] \{\
.    \" if there is/has been more than one subroutine declaration
.    ie \n[doc-is-func] \{\
.      br
.      nr doc-have-var 0
.      nr doc-have-decl 0
.      nr doc-is-func 0
.    \}
.    el \{\
.      if \n[doc-have-func] \{\
.        doc-paragraph
.        nr doc-have-var 0
.        nr doc-have-decl 0
.    \}\}
.
.    if \n[doc-have-decl] \{\
.      doc-paragraph
.      nr doc-have-var 0
.    \}
.
.    if \n[doc-have-var] \{\
.      doc-paragraph
.      nr doc-have-decl 0
.    \}
.
.    nr doc-have-func 1
.    nr doc-is-func 0
.
.    br
.    if !\n[doc-indent-synopsis] \
.      nr doc-indent-synopsis (4u * \n[doc-fixed-width]u)
.  \}
.
.  \" start function box
.  box doc-func-box
.  ev doc-func-env
.  evc 0
.  in 0
.  nf
.
.  nr doc-arg-ptr +1
.  doc-print-prefixes
.  if (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    nr doc-func-arg-count 1
.    nr doc-curr-font \n[.f]
.
.    nop \*[doc-Fn-font]\*[doc-arg\n[doc-arg-ptr]]\c
.    nop \f[]\*[lp]\)\c
.    doc-reset-args
.  \}
..
.ec
.
.
.\" NS Fc user macro
.\" NS   function close
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-func-arg-count
.\" NS   doc-in-func-enclosure
.\" NS   doc-saved-nesting-level
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'Fc' set in doc-common
.
.eo
.de Fc
.  if !\n[doc-in-func-enclosure] \{\
.    tm mdoc warning: Extraneous .Fc (#\n[.c])
.    return
.  \}
.
.  if \n[.$] \{\
.    ds doc-macro-name Fc
.    \" the first (dummy) argument is used to get the correct spacing
.    doc-parse-args \) \$@
.  \}
.
.  if !(\n[doc-saved-nesting-level] == \n[doc-nesting-level]) \
.    tm mdoc warning: Unbalanced enclosure commands within .Fo/.Fc
.
.  nr doc-func-arg-count 0
.  nr doc-in-func-enclosure 0
.
.  ie \n[doc-in-synopsis-section] \
.    nop \|\*[rp];\)
.  el \
.    nop \|\*[rp]\)
.
.  \" finish function box
.  br
.  ev
.  box
.  chop doc-func-box
.  unformat doc-func-box
.
.  if \n[doc-in-synopsis-section] \{\
.    if !\n[doc-indent-synopsis-active] \
.      in +\n[doc-indent-synopsis]u
.    ti -\n[doc-indent-synopsis]u
.  \}
.
.  nh
.  nop \*[doc-func-box]\c
.
.  nr doc-arg-ptr +1
.  ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.    nr doc-curr-font \n[.f]
.    doc-print-recursive
.  \}
.  el \
.    doc-print-and-reset
.
.  if \n[doc-in-synopsis-section] \
.    if !\n[doc-indent-synopsis-active] \
.      in -\n[doc-indent-synopsis]u
..
.ec
.
.
.\" NS doc-build-func-string macro
.\" NS   collect function arguments and set hard spaces in between
.\" NS
.\" NS modifies:
.\" NS   doc-func-arg
.\" NS   doc-func-args-processed
.\" NS   doc-num-func-args
.
.eo
.de doc-build-func-string
.  if !\n[doc-num-func-args] \{\
.    nr doc-num-func-args \n[.$]
.    nr doc-func-args-processed 0
.    ds doc-func-arg
.  \}
.
.  nr doc-func-args-processed +1
.  as doc-func-arg "\$1
.
.  if (\n[doc-func-args-processed] < \n[doc-num-func-args]) \{\
.    as doc-func-arg "\*[doc-hard-space]
.
.    shift
.    doc-build-func-string \$@
.  \}
..
.ec
.
.
.\" Very crude references: Stash all reference info into boxes, print
.\" out reference on .Re macro and clean up.  Ordering very limited, no
.\" fancy citations, but can do articles, journals, and books -- need to
.\" add several missing options (like city etc).  Should be able to grab
.\" a refer entry, massage it a wee bit (prefix a '.' to the %[A-Z]) and
.\" not worry (ha!).
.
.
.\" NS doc-is-reference global register (bool)
.\" NS   set if in reference
.
.nr doc-is-reference 0
.
.
.\" NS doc-reference-count global register
.\" NS   reference element counter
.
.nr doc-reference-count 0
.
.
.\" NS Rs user macro
.\" NS   reference start
.\" NS
.\" NS modifies:
.\" NS   doc-is-reference
.\" NS   doc-reference-count
.\" NS
.\" NS width register 'Rs' set in doc-common
.
.eo
.de Rs
.  ie \n[.$] \
.    tm Usage: .Rs (does not take arguments) (#\n[.c])
.  el \{\
.    nr doc-is-reference 1
.    doc-reset-reference
.    if \n[doc-in-see-also-section] \
.      doc-paragraph
.    nr doc-reference-count 0
.  \}
..
.ec
.
.
.\" NS Re user macro
.\" NS   reference end
.\" NS
.\" NS modifies:
.\" NS   doc-is-reference
.\" NS
.\" NS width register 'Re' set in doc-common
.
.eo
.de Re
.  ie \n[.$] \
.    tm Usage: .Re (does not take arguments) (#\n[.c])
.  el \{\
.    if !\n[doc-is-reference] \{\
.      tm mdoc warning: Extraneous .Re (#\n[.c])
.      return
.    \}
.    doc-print-reference
.    doc-reset-reference
.    nr doc-is-reference 0
.  \}
..
.ec
.
.
.\" NS doc-reset-reference macro
.\" NS   reference cleanup
.\" NS
.\" NS modifies:
.\" NS   doc-author-count
.\" NS   doc-author-nameXXX
.\" NS   doc-book-count
.\" NS   doc-book-name
.\" NS   doc-city-count
.\" NS   doc-city-name
.\" NS   doc-corporate-count
.\" NS   doc-corporate-name
.\" NS   doc-date
.\" NS   doc-date-count
.\" NS   doc-issue-count
.\" NS   doc-issue-name
.\" NS   doc-journal-count
.\" NS   doc-journal-name
.\" NS   doc-optional-count
.\" NS   doc-optional-string
.\" NS   doc-page-number-count
.\" NS   doc-page-number-string
.\" NS   doc-publisher-count
.\" NS   doc-publisher-name
.\" NS   doc-reference-count
.\" NS   doc-reference-title-count
.\" NS   doc-reference-title-name
.\" NS   doc-reference-title-name-for-book
.\" NS   doc-report-count
.\" NS   doc-report-name
.\" NS   doc-url-count
.\" NS   doc-url-name
.\" NS   doc-volume-count
.\" NS   doc-volume-name
.
.eo
.de doc-reset-reference
.  while (\n[doc-author-count]) \{\
.    ds doc-author-name\n[doc-author-count]
.    nr doc-author-count -1
.  \}
.  nr doc-journal-count 0
.  nr doc-issue-count 0
.  nr doc-optional-count 0
.  nr doc-corporate-count 0
.  nr doc-report-count 0
.  nr doc-reference-title-count 0
.  nr doc-url-count 0
.  nr doc-volume-count 0
.  nr doc-city-count 0
.  nr doc-date-count 0
.  nr doc-page-number-count 0
.  nr doc-book-count 0
.  nr doc-publisher-count 0
.  nr doc-reference-count 0
.
.  ds doc-journal-name
.  ds doc-issue-name
.  ds doc-optional-string
.  ds doc-corporate-name
.  ds doc-report-name
.  ds doc-reference-title-name
.  ds doc-reference-title-name-for-book
.  ds doc-url-name
.  ds doc-volume-name
.  ds doc-city-name
.  ds doc-date
.  ds doc-page-number-string
.  ds doc-book-name
.  ds doc-publisher-name
..
.ec
.
.
.\" NS doc-finish-reference macro
.\" NS   auxiliary macro for doc-print-reference
.\" NS
.\" NS modifies:
.\" NS   doc-reference-count
.
.eo
.de doc-finish-reference
.  nr doc-reference-count -\$1
.  ie \n[doc-reference-count] \
.    nop \),
.  el \
.    nop \).
..
.ec
.
.
.\" NS doc-print-reference macro
.\" NS   reference print
.\" NS
.\" NS modifies:
.\" NS   doc-reference-count
.
.eo
.de doc-print-reference
.
.  nh
.
.  if \n[doc-author-count] \{\
.    doc-print-reference-authors
.    nr doc-reference-count -\n[doc-author-count]
.  \}
.
.  if \n[doc-reference-title-count] \{\
.    unformat doc-reference-title-name
.    chop doc-reference-title-name
.    unformat doc-reference-title-name-for-book
.    chop doc-reference-title-name-for-book
.    ie ((\n[doc-journal-count] == 1) : (\n[doc-book-count] == 1)) \{\
.      nop \)\*[Lq]\)\*[doc-reference-title-name-for-book]\)\*[Rq]\c
.      doc-finish-reference \n[doc-reference-title-count]
.    \}
.    el \{\
.      nop \*[doc-reference-title-name]\c
.      doc-finish-reference \n[doc-reference-title-count]
.  \}\}
.
.  if \n[doc-book-count] \{\
.    unformat doc-book-name
.    chop doc-book-name
.    nop \*[doc-book-name]\c
.    doc-finish-reference \n[doc-book-count]
.  \}
.
.  if \n[doc-publisher-count] \{\
.    unformat doc-publisher-name
.    chop doc-publisher-name
.    nop \*[doc-publisher-name]\c
.    doc-finish-reference \n[doc-publisher-count]
.  \}
.
.  if \n[doc-journal-count] \{\
.    unformat doc-journal-name
.    chop doc-journal-name
.    nop \*[doc-journal-name]\c
.    doc-finish-reference \n[doc-journal-count]
.  \}
.
.  if \n[doc-report-count] \{\
.    unformat doc-report-name
.    chop doc-report-name
.    nop \*[doc-report-name]\c
.    doc-finish-reference \n[doc-report-count]
.  \}
.
.  if \n[doc-issue-count] \{\
.    unformat doc-issue-name
.    chop doc-issue-name
.    nop \*[doc-issue-name]\c
.    doc-finish-reference \n[doc-issue-count]
.  \}
.
.  if \n[doc-volume-count] \{\
.    unformat doc-volume-name
.    chop doc-volume-name
.    nop \*[doc-volume-name]\c
.    doc-finish-reference \n[doc-volume-count]
.  \}
.
.  if \n[doc-url-count] \{\
.    unformat doc-url-name
.    chop doc-url-name
.    nop \*[doc-url-name]\c
.    doc-finish-reference \n[doc-url-count]
.  \}
.
.  if \n[doc-page-number-count] \{\
.    unformat doc-page-number-string
.    chop doc-page-number-string
.    nop \*[doc-page-number-string]\c
.    doc-finish-reference \n[doc-page-number-count]
.  \}
.
.  if \n[doc-corporate-count] \{\
.    unformat doc-corporate-name
.    chop doc-corporate-name
.    nop \*[doc-corporate-name]\c
.    doc-finish-reference \n[doc-corporate-count]
.  \}
.
.  if \n[doc-city-count] \{\
.    unformat doc-city-name
.    chop doc-city-name
.    nop \*[doc-city-name]\c
.    doc-finish-reference \n[doc-city-count]
.  \}
.
.  if \n[doc-date-count] \{\
.    unformat doc-date
.    chop doc-date
.    nop \*[doc-date]\c
.    doc-finish-reference \n[doc-date-count]
.  \}
.
.  if \n[doc-optional-count] \{\
.    unformat doc-optional-string
.    chop doc-optional-string
.    nop \*[doc-optional-string]\c
.    doc-finish-reference \n[doc-optional-count]
.  \}
.
.  if \n[doc-reference-count] \
.    tm mdoc warning: unresolved reference problem
.
.  hy \n[doc-hyphen-flags]
..
.ec
.
.
.\" NS doc-print-reference-authors macro
.\" NS   print out reference authors
.\" NS
.\" NS local variables:
.\" NS   doc-reg-dpra
.\" NS   doc-str-dpra
.
.ds doc-str-dpra "and
.
.eo
.de doc-print-reference-authors
.  nr doc-reg-dpra 1
.
.  while (\n[doc-reg-dpra] < \n[doc-author-count]) \{\
.    unformat doc-author-name\n[doc-reg-dpra]
.    chop doc-author-name\n[doc-reg-dpra]
.    ie (\n[doc-author-count] > 2) \
.      nop \)\*[doc-author-name\n[doc-reg-dpra]],
.    el \
.      nop \)\*[doc-author-name\n[doc-reg-dpra]]
.    nr doc-reg-dpra +1
.  \}
.
.  unformat doc-author-name\n[doc-reg-dpra]
.  chop doc-author-name\n[doc-reg-dpra]
.  if (\n[doc-author-count] > 1) \
.    nop \)\*[doc-str-dpra]
.  nop \)\*[doc-author-name\n[doc-reg-dpra]],
..
.ec
.
.
.\" NS doc-author-count global register
.\" NS   counter of author references
.
.nr doc-author-count 0
.
.
.\" NS doc-author-nameXXX global box
.\" NS   array of author names
.\" NS
.\" NS limit:
.\" NS   doc-author-count
.
.ds doc-author-name0
.
.
.\" NS %A user macro
.\" NS   reference author(s)
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-author-count
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS   doc-reference-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%A
.\" NS
.\" NS width register '%A' set in doc-common
.
.eo
.de %A
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%A author_name ... (#\n[.c])
.    return
.  \}
.
.  nr doc-author-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %A
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" save to reference box
.  box doc-author-name\n[doc-author-count]
.  ev doc-env-%A
.  evc 0
.  in 0
.  nf
.  doc-do-references
..
.ec
.
.
.\" NS doc-book-count global register
.\" NS   counter of book references
.
.nr doc-book-count 0
.
.
.\" NS doc-book-name global box
.\" NS   string of collected book references
.
.ds doc-book-name
.
.
.\" NS %B user macro
.\" NS   [reference] book name
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-book-count
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS   doc-reference-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%B
.\" NS
.\" NS width register '%B' set in doc-common
.
.eo
.de %B
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%B book_name ... (#\n[.c])
.    return
.  \}
.
.  if \n[doc-is-reference] \{\
.    nr doc-book-count +1
.    nr doc-reference-count +1
.  \}
.
.  ds doc-macro-name %B
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  ie \n[doc-is-reference] \{\
.    \" append to reference box
.    boxa doc-book-name
.    ev doc-env-%B
.    evc 0
.    in 0
.    nf
.    nop \*[doc-Em-font]\c
.    doc-do-references
.  \}
.  el \{\
.    nop \*[doc-Em-font]\c
.    doc-print-recursive
.  \}
..
.ec
.
.
.\" NS doc-city-count global register
.\" NS   counter of city references
.
.nr doc-city-count 0
.
.
.\" NS doc-city-name global box
.\" NS   string of collected city references
.
.ds doc-city-name
.
.
.\" NS %C user macro
.\" NS   [reference] city
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-city-count
.\" NS   doc-macro-name
.\" NS   doc-reference-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%C
.\" NS
.\" NS width register '%C' set in doc-common
.
.eo
.de %C
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%C city_name ... (#\n[.c])
.    return
.  \}
.
.  nr doc-city-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %C
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-city-name
.  ev doc-env-%C
.  evc 0
.  in 0
.  nf
.  doc-do-references
..
.ec
.
.
.\" NS doc-date-count global register
.\" NS   counter of date references
.
.nr doc-date-count 0
.
.
.\" NS doc-date global box
.\" NS   string of collected date references
.
.ds doc-date
.
.
.\" NS %D user macro
.\" NS   [reference] date
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-date-count
.\" NS   doc-macro-name
.\" NS   doc-reference-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%D
.\" NS
.\" NS width register '%D' set in doc-common
.
.eo
.de %D
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%D date ... (#\n[.c])
.    return
.  \}
.
.  nr doc-date-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %D
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-date
.  ev doc-env-%D
.  evc 0
.  in 0
.  nf
.  doc-do-references
..
.ec
.
.
.\" NS doc-publisher-count global register
.\" NS   counter of publisher references
.
.nr doc-publisher-count 0
.
.
.\" NS doc-publisher-name global box
.\" NS   string of collected publisher references
.
.ds doc-publisher-name
.
.
.\" NS %I user macro
.\" NS   [reference] issuer/publisher name
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS   doc-publisher-count
.\" NS   doc-reference-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%I
.\" NS
.\" NS width register '%I' set in doc-common
.
.eo
.de %I
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%I issuer/publisher_name ... (#\n[.c])
.    return
.  \}
.
.  nr doc-publisher-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %I
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-publisher-name
.  ev doc-env-%I
.  evc 0
.  in 0
.  nf
.  nop \*[doc-Em-font]\c
.  doc-do-references
..
.ec
.
.
.\" NS doc-journal-count global register
.\" NS   counter of journal references
.
.nr doc-journal-count 0
.
.
.\" NS doc-journal-name global box
.\" NS   string of collected journal references
.
.ds doc-journal-name
.
.
.\" NS %J user macro
.\" NS   [reference] Journal Name
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-journal-count
.\" NS   doc-macro-name
.\" NS   doc-reference-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%J
.\" NS
.\" NS width register '%J' set in doc-common
.
.eo
.de %J
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%J journal_name ... (#\n[.c])
.    return
.  \}
.
.  nr doc-journal-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %J
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-journal-name
.  ev doc-env-%J
.  evc 0
.  in 0
.  nf
.  nop \*[doc-Em-font]\c
.  doc-do-references
..
.ec
.
.
.\" NS doc-issue-count global register
.\" NS   counter of issue number references
.
.nr doc-issue-count 0
.
.
.\" NS doc-issue-name global box
.\" NS   string of collected issue number references
.
.ds doc-issue-name
.
.
.\" NS %N user macro
.\" NS   [reference] issue number
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-issue-count
.\" NS   doc-macro-name
.\" NS   doc-reference-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%N
.\" NS
.\" NS width register '%N' set in doc-common
.
.eo
.de %N
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%N issue_number ... (#\n[.c])
.    return
.  \}
.
.  nr doc-issue-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %N
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-issue-name
.  ev doc-env-%N
.  evc 0
.  in 0
.  nf
.  doc-do-references
..
.ec
.
.
.\" NS doc-optional-count global register
.\" NS   counter of optional information references
.
.nr doc-optional-count 0
.
.
.\" NS doc-optional-string global box
.\" NS   string of collected optional information references
.
.ds doc-optional-string
.
.
.\" NS %O user macro
.\" NS   [reference] optional information
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS   doc-optional-count
.\" NS   doc-reference-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%O
.\" NS
.\" NS width register '%O' set in doc-common
.
.eo
.de %O
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%O optional_information ... (#\n[.c])
.    return
.  \}
.
.  nr doc-optional-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %O
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-optional-string
.  ev doc-env-%O
.  evc 0
.  in 0
.  nf
.  doc-do-references
..
.ec
.
.
.\" NS doc-page-number-count global register
.\" NS   counter of page number references
.
.nr doc-page-number-count 0
.
.
.\" NS doc-page-number-string global box
.\" NS   string of collected page number references
.
.ds doc-page-number-string
.
.
.\" NS %P user macro
.\" NS   [reference] page numbers
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS   doc-page-number-count
.\" NS   doc-reference-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%P
.\" NS
.\" NS width register '%P' set in doc-common
.
.eo
.de %P
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%P page_number ... (#\n[.c])
.    return
.  \}
.
.  nr doc-page-number-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %P
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-page-number-string
.  ev doc-env-%P
.  evc 0
.  in 0
.  nf
.  doc-do-references
..
.ec
.
.
.\" NS doc-corporate-count global register
.\" NS   counter of corporate references
.
.nr doc-corporate-count 0
.
.
.\" NS doc-corporate-name global box
.\" NS   string of collected corporate references
.
.ds doc-corporate-name
.
.
.\" NS %Q user macro
.\" NS   corporate or foreign author
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-corporate-count
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS   doc-reference-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%Q
.\" NS
.\" NS width register '%Q' set in doc-common
.
.eo
.de %Q
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%Q corporate_or_foreign_author ... (#\n[.c])
.    return
.  \}
.
.  nr doc-corporate-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %Q
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-corporate-name
.  ev doc-env-%Q
.  evc 0
.  in 0
.  nf
.  doc-do-references
..
.ec
.
.
.\" NS doc-report-count global register
.\" NS   counter of report references
.
.nr doc-report-count 0
.
.
.\" NS doc-report-name global box
.\" NS   string of collected report references
.
.ds doc-report-name
.
.
.\" NS %R user macro
.\" NS   [reference] report name
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS   doc-reference-count
.\" NS   doc-report-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%R
.\" NS
.\" NS width register '%R' set in doc-common
.
.eo
.de %R
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%R reference_report ... (#\n[.c])
.    return
.  \}
.
.  nr doc-report-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %R
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-report-name
.  ev doc-env-%R
.  evc 0
.  in 0
.  nf
.  doc-do-references
..
.ec
.
.
.\" NS doc-reference-title-count global register
.\" NS   counter of reference title references
.
.nr doc-reference-title-count 0
.
.
.\" NS doc-reference-title-name global box
.\" NS   string of collected reference title references
.
.ds doc-reference-title-name
.
.
.\" NS doc-reference-title-name-for-book global box
.\" NS   string of collected reference title references
.\" NS   (saved with another font; this is a shortcoming of groff)
.
.ds doc-reference-title-name-for-book
.
.
.\" NS %T user macro
.\" NS   reference title
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS   doc-reference-title-count
.\" NS   doc-report-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%T
.\" NS
.\" NS width register '%T' set in doc-common
.
.eo
.de %T
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%T reference_title ... (#\n[.c])
.    return
.  \}
.
.  if \n[doc-is-reference] \{\
.    nr doc-reference-title-count +1
.    nr doc-reference-count +1
.  \}
.
.  ds doc-macro-name %T
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.  ie \n[doc-is-reference] \{\
.    \" append to reference box
.    boxa doc-reference-title-name-for-book
.    ev doc-env-%T
.    evc 0
.    in 0
.    nf
.    nop \*[doc-No-font]\c
.    doc-do-references
.
.    \" do it a second time with another font
.    ds doc-macro-name %T
.    doc-parse-args \$@
.
.    nr doc-arg-ptr +1
.    nr doc-curr-font \n[.f]
.    boxa doc-reference-title-name
.    ev doc-env-%T
.    evc 0
.    in 0
.    nf
.    nop \*[doc-Em-font]\c
.    doc-do-references
.  \}
.  el \{\
.    nop \*[doc-Em-font]\c
.    doc-print-recursive
.  \}
..
.ec
.
.
.\" NS doc-url-count global register
.\" NS   counter of hypertext references
.
.nr doc-url-count 0
.
.
.\" NS doc-url-name global box
.\" NS   string of collected hypertext references
.
.ds doc-url-name
.
.
.\" NS doc-volume-count global register
.\" NS   counter of reference title references
.
.nr doc-volume-count 0
.
.
.\" NS doc-volume-name global box
.\" NS   string of collected volume references
.
.ds doc-volume-name
.
.
.\" NS %U user macro
.\" NS   hypertext reference
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS   doc-reference-count
.\" NS   doc-url-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%U
.\" NS
.\" NS width register '%U' set in doc-common
.
.eo
.de %U
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%U URL ... (#\n[.c])
.    return
.  \}
.
.  nr doc-url-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %U
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-url-name
.  ev doc-env-%U
.  evc 0
.  in 0
.  nf
.  doc-do-references
..
.ec
.
.
.\" NS %V user macro
.\" NS   reference volume
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS   doc-reference-count
.\" NS   doc-volume-count
.\" NS
.\" NS local variables:
.\" NS   doc-env-%V
.\" NS
.\" NS width register '%V' set in doc-common
.
.eo
.de %V
.  if (\n[doc-arg-count] : (\n[.$] == 0)) \{\
.    tm Usage: .%V volume ... (#\n[.c])
.    return
.  \}
.
.  nr doc-volume-count +1
.  nr doc-reference-count +1
.
.  ds doc-macro-name %V
.  doc-parse-args \$@
.
.  nr doc-arg-ptr +1
.  nr doc-curr-font \n[.f]
.
.  \" append to reference box
.  boxa doc-volume-name
.  ev doc-env-%V
.  evc 0
.  in 0
.  nf
.  doc-do-references
..
.ec
.
.
.\" NS doc-do-references macro
.\" NS   reference recursion routine
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS
.\" NS local variables:
.\" NS   doc-reg-ddr
.\" NS   doc-reg-ddr1
.
.eo
.de doc-do-references
.  if !\n[doc-is-reference] \
.    tm mdoc error: .\*[doc-macro-name] found outside of .Rs ... .Re (#\n[.c])
.
.  nr doc-reg-ddr1 \n[doc-type\n[doc-arg-ptr]]
.
.  ie (\n[doc-reg-ddr1] == 1) \{\
.    \" .nop \f[\n[doc-curr-font]]\c
.    doc-append-arg \c 3
.    \*[doc-arg\n[doc-arg-ptr]]
.  \}
.  el \{\
.    nop \)\*[doc-arg\n[doc-arg-ptr]]\c
.
.    ie (\n[doc-arg-count] == \n[doc-arg-ptr]) \{\
.      \" finish reference box
.      br
.      ev
.      boxa
.
.      doc-reset-args
.    \}
.    el \{\
.      nr doc-reg-ddr \n[doc-arg-ptr]
.      nr doc-arg-ptr +1
.      nop \)\*[doc-space\n[doc-reg-ddr]]\c
.      doc-do-references
.  \}\}
..
.ec
.
.
.\" NS Hf user macro
.\" NS   source include header files.
.\" NS
.\" NS modifies:
.\" NS   doc-curr-font
.\" NS
.\" NS width register 'Hf' set in doc-common
.
.eo
.de Hf
.  ie ((\n[.$] == 1) & (\n[doc-arg-count] == 0)) \{\
.    doc-paragraph
.    nop File:
.    Pa \$1
.
.    Bd -literal
.    so \$1
.    Ed
.
.    doc-paragraph
.  \}
.  el \
.    Usage: .Hf file (#\n[.c])
..
.ec
.
.
.\" NS doc-have-author global register (bool)
.\" NS   set in 'An'
.
.nr doc-have-author 0
.
.
.\" NS An user macro
.\" NS   author name
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-have-author
.\" NS   doc-macro-name
.\" NS
.\" NS width register 'An' set in doc-common
.
.eo
.de An
.  if !\n[doc-arg-count] \{\
.    ie \n[.$] \{\
.      ie        "\$1"-nosplit" \
.        nr doc-in-authors-section 0
.      el \{ .ie "\$1"-split" \
.        nr doc-in-authors-section 1
.      el \{\
.        ds doc-macro-name An
.        doc-parse-args \$@
.    \}\}\}
.    el \{\
.      tm1 "Usage: .An {-nosplit | -split}
.      tm1 "       .An author_name ... (#\n[.c])
.  \}\}
.
.  if \n[doc-in-authors-section] \{\
.    ie \n[doc-have-author] \
.      br
.    el \
.      nr doc-have-author 1
.  \}
.
.  if \n[doc-arg-count] \{\
.    nr doc-arg-ptr +1
.    ie (\n[doc-arg-count] >= \n[doc-arg-ptr]) \{\
.      nr doc-curr-font \n[.f]
.      doc-print-recursive
.    \}
.    el \{\
.      tm Usage: .An author_name ... (#\n[.c])
.      doc-reset-args
.  \}\}
..
.ec
.
.
.\" NS Rv user macro
.\" NS   return values
.\" NS
.\" NS width register 'Rv' set in doc-common
.\" NS
.\" NS local variables:
.\" NS   doc-str-Rv-std-prefix
.\" NS   doc-str-Rv-std-suffix
.\" NS   doc-str-Rv-stds-prefix
.\" NS   doc-str-Rv-stds-and
.\" NS   doc-str-Rv-stds-suffix
.\" NS   doc-str-Rv-std0
.
.eo
.ds doc-str-Rv-std-prefix "The
.ds doc-str-Rv-std-suffix "function returns the value\~0 if successful;
.as doc-str-Rv-std-suffix " otherwise the value\~\-1 is returned and
.as doc-str-Rv-std-suffix " the global variable \*[doc-Va-font]errno\f[]
.as doc-str-Rv-std-suffix " is set to indicate the error.
.
.ds doc-str-Rv-stds-prefix "The
.ds doc-str-Rv-stds-and    "and
.ds doc-str-Rv-stds-suffix "functions return the value\~0 if successful;
.as doc-str-Rv-stds-suffix " otherwise the value\~\-1 is returned and
.as doc-str-Rv-stds-suffix " the global variable \*[doc-Va-font]errno\f[]
.as doc-str-Rv-stds-suffix " is set to indicate the error.
.
.ds doc-str-Rv-std0 "Upon successful completion, the value\~0 is returned;
.as doc-str-Rv-std0 " otherwise the value\~\-1 is returned and
.as doc-str-Rv-std0 " the global variable \*[doc-Va-font]errno\f[]
.as doc-str-Rv-std0 " is set to indicate the error.
.ec
.
.eo
.de Rv
.
.\" XXX: what does this function without '-std'?
.
.  if \n[doc-arg-count] \{\
.    tm Usage: .Rv not callable by other macros (#\n[.c])
.    doc-reset-args
.    return
.  \}
.
.  if !\n[.$] \{\
.    tm Usage: .Rv [-std] [<function> ...] (#\n[.c])
.    return
.  \}
.
.  if "\$1"-std" \{\
.    nr doc-reg-Rv \*[doc-section]
.    if ((\n[doc-reg-Rv] < 2) : (\n[doc-reg-Rv] > 3)) \
.      tm Usage: .Rv -std in sections 2 and 3 only (#\n[.c])
.    br
.    shift
.    ie (\n[.$] > 1) \{\
.      nop \)\*[doc-str-Rv-stds-prefix]
.      nr doc-reg-Rv 1
.      while (\n[doc-reg-Rv] < \n[.$]) \{\
.        ie (\n[.$] > 2) \
.          Fn \$\n[doc-reg-Rv] ,
.        el \
.          Fn \$\n[doc-reg-Rv]
.        nr doc-reg-Rv +1
.      \}
.      nop \)\*[doc-str-Rv-stds-and]
.      Fn \$\n[.$]
.      nop \)\*[doc-str-Rv-stds-suffix]
.    \}
.    el \{ .ie (\n[.$] == 1) \{\
.      nop \)\*[doc-str-Rv-std-prefix]
.      Fn \$1
.      nop \)\*[doc-str-Rv-std-suffix]
.    \}
.    el \{\
.      nop \)\*[doc-str-Rv-std0]
.  \}\}\}
..
.ec
.
.
.\" NS Ex user macro
.\" NS   exit status
.\" NS
.\" NS width register 'Ex' set in doc-common
.\" NS
.\" NS local variables:
.\" NS   doc-str-Ex-std-prefix
.\" NS   doc-str-Ex-std-suffix
.
.ds doc-str-Ex-std-prefix "The
.ds doc-str-Ex-std-suffix "utility exits\~0 on success,
.as doc-str-Ex-std-suffix " and\~>0 if an error occurs.
.
.ds doc-str-Ex-stds-prefix "The
.als doc-str-Ex-stds-and doc-str-Rv-stds-and
.ds doc-str-Ex-stds-suffix "utilities exit\~0 on success,
.as doc-str-Ex-stds-suffix " and\~>0 if an error occurs.
.
.eo
.de Ex
.
.\" XXX: what does this function without '-std'?
.
.  if \n[doc-arg-count] \{\
.    tm Usage: .Ex not callable by other macros (#\n[.c])
.    doc-reset-args
.    return
.  \}
.
.  if !\n[.$] \{\
.    tm Usage: .Ex [-std] [<utility> ...] (#\n[.c])
.    return
.  \}
.
.  if "\$1"-std" \{\
.    nr doc-reg-Ex \*[doc-section]
.    if !((\n[doc-reg-Ex] == 1) : (\n[doc-reg-Ex] == 6) : (\n[doc-reg-Ex] == 8)) \
.      tm Usage: .Ex -std in sections 1, 6 and 8 only (#\n[.c])
.    br
.    shift
.    ie (\n[.$] > 1) \{\
.      nop \)\*[doc-str-Ex-stds-prefix]
.      nr doc-reg-Ex 1
.      while (\n[doc-reg-Ex] < \n[.$]) \{\
.        ie (\n[.$] > 2) \
.          Nm \$\n[doc-reg-Ex] ,
.        el \
.          Nm \$\n[doc-reg-Ex]
.        nr doc-reg-Ex +1
.      \}
.      nop \)\*[doc-str-Ex-stds-and]
.      Nm \$\n[.$]
.      nop \)\*[doc-str-Ex-stds-suffix]
.    \}
.    el \{\
.      nop \)\*[doc-str-Ex-std-prefix]
.      Nm \$1
.      nop \)\*[doc-str-Ex-std-suffix]
.  \}\}
..
.ec
.
.
.\" NS Mt user macro
.\" NS   mailto (for conversion to HTML)
.
.eo
.de Mt
.  \" XXX: error handling missing
.  Pa \$@
..
.ec
.
.
.\" NS Lk user macro
.\" NS   link (for conversion to HTML)
.\" NS
.\" NS modifies:
.\" NS   doc-arg-ptr
.\" NS   doc-curr-font
.\" NS   doc-macro-name
.\" NS
.\" NS local variables:
.\" NS   doc-lasttext-Lk
.\" NS   doc-target-Lk
.
.eo
.de Lk
.  if !\n[doc-arg-count] \{\
.    ds doc-macro-name Lk
.    doc-parse-args \$@
.  \}
.
.  if !\n[doc-arg-count] \
.    return
.
.  \" The first argument is the target URI.
.  nr doc-arg-ptr +1
.  ds doc-target-Lk "\*[doc-arg\n[doc-arg-ptr]]
.  nr doc-arg-ptr +1
.
.  \" Search backwards for the first closing punctuation.
.  nr doc-lasttext-Lk \n[doc-arg-count]
.  while (\n[doc-lasttext-Lk] >= \n[doc-arg-ptr]) \{\
.    if !(\n[doc-type\n[doc-lasttext-Lk]] == 3) \
.      break
.    nr doc-lasttext-Lk -1
.  \}
.
.  \" Format the link text, if any.
.  \" XXX: The forced use of the emphasis font and a trailing colon
.  \" seems intrusive.
.  nr doc-curr-font \n[.f]
.  if (\n[doc-arg-ptr] <= \n[doc-lasttext-Lk]) \{\
.    nop \*[doc-Em-font]\c
.    while (\n[doc-arg-ptr] < \n[doc-lasttext-Lk]) \{\
.      nop \&\*[doc-arg\n[doc-arg-ptr]]
.      nr doc-arg-ptr +1
.    \}
.    nop \&\*[doc-arg\n[doc-arg-ptr]]\c
.    nop \f[\n[doc-curr-font]]:
.    nr doc-arg-ptr +1
.  \}
.
.  \" Format the link target.
.  nop \*[doc-Lk-font]\*[doc-target-Lk]\c
.  nop \f[\n[doc-curr-font]]\c
.
.  \" Format trailing arguments, like punctuation, if any.
.  ie (\n[doc-arg-ptr] <= \n[doc-arg-count]) \
.    doc-print-recursive
.  el \{\
.    nop \&
.    doc-reset-args
.  \}
..
.ec
.
.
.\" NS doc-defunct-macro macro
.\" NS   this is the skeleton for defunct macros
.\" NS
.
.eo
.de doc-defunct-macro
.  tmc mdoc error: .\$0 defunct
.  if d doc-\$0-usage \
.    tmc , \*[doc-\$0-usage]
.  tm1 " (#\n[.c])
..
.ec
.
.
.\" obsolete macros
.
.als Db doc-defunct-macro
.
.als Ds doc-defunct-macro
.
.als Or doc-defunct-macro
.ds doc-Or-usage use '|'
.
.als Sf doc-defunct-macro
.ds doc-Sf-usage use .Pf or .Ns
.
.
.rn em e@
.
.eo
.de em
.  tm1 "mdoc error: end-macro (.em) respecification is not allowed. (#\n[.c])
.  tm1 "            Should this have been '.Em ...'?
.  ab
..
.ec
.
.
.\" NS doc-empty-line macro
.\" NS   emit warning and print empty line
.
.eo
.de doc-empty-line
.  if !\n[doc-display-depth] \
.    tm mdoc warning: Empty input line #\n[.c]
.  sp
..
.ec
.
.blm doc-empty-line
.
.
.ec
.
.
.\" For UTF-8, map the minus sign to the hyphen-minus to facilitate
.\" copy and paste of code examples, file names, and URLs embedding it.
.if '\*[.T]'utf8' \
.  char \- \N'45'
.
.
.\" load local modifications
.mso mdoc.local
.
.\" Local Variables:
.\" mode: nroff
.\" fill-column: 72
.\" End:
.\" vim: set filetype=groff textwidth=72: