.\" 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.
.\"
.\" This is a generated file, created by 'tmac/strip.sed' in groff's
.\" source distribution from a file having '-u' appended to its name.
.if !\n(.g \
.ab This version of mdoc can be run with GNU troff only!
.do if d Dd .nx
.cp 0
.if (\n[.x]\n[.y] < 118) \
.ab You need GNU troff version 1.18 or higher to run this version of mdoc!
.ie t \
.mso mdoc/doc-ditroff
.el \
.mso mdoc/doc-nroff
.mso mdoc/doc-common
.mso mdoc/doc-syms
.eo
.ds doc-macro-name
.als doc-arg0 doc-macro-name
.nr doc-arg-limit 0
.nr doc-num-args 0
.nr doc-arg-ptr 0
.ds doc-arg1
.nr doc-type1 0
.ds doc-space1
.de doc-parse-args
.if !\n[doc-arg-limit] \
.doc-set-spacing-1
.nr doc-have-space 0
.if !\n[.$] \
.return
.nr doc-arg-limit +1
.ie        "\$1"|" \
.ds doc-arg\n[doc-arg-limit] \f[R]|\f[]
.el \{ .ie "\$1"..." \
.ds doc-arg\n[doc-arg-limit] \|.\|.\|.
.el \
.ds doc-arg\n[doc-arg-limit] "\$1
.\}
.doc-get-arg-type* \n[doc-arg-limit]
.nr doc-type\n[doc-arg-limit] \n[doc-arg-type]
.doc-set-spacing-\n[doc-arg-type]
.ie (\n[.$] == 1) \
.nr doc-arg-ptr 0
.el \{\
.shift
.doc-parse-args \$@
.\}
.nh
..
.de doc-parse-arg-vector
.if !\n[doc-arg-limit] \
.doc-set-spacing-1
.nr doc-arg-limit +1
.ie        "\*[doc-arg\n[doc-arg-limit]]"|" \
.ds doc-arg\n[doc-arg-limit] \f[R]|\f[]
.el \{ .if "\*[doc-arg\n[doc-arg-limit]]"..." \
.ds doc-arg\n[doc-arg-limit] \|.\|.\|.
.\}
.doc-get-arg-type* \n[doc-arg-limit]
.nr doc-type\n[doc-arg-limit] \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
..
.de doc-parse-space-vector
.nr doc-arg-limit +1
.doc-set-spacing-\n[doc-type\n[doc-arg-limit]]
.ie (\n[doc-num-args] == 1) \
.nr doc-num-args 0
.el \{\
.nr doc-num-args -1
.doc-parse-space-vector
.\}
..
.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
.\}
..
.de doc-append-arg
.nr doc-arg-limit +1
.ds doc-arg\n[doc-arg-limit] "\$1
.nr doc-type\n[doc-arg-limit] \$2
.doc-set-spacing-\$2
..
.de doc-print-and-reset
.if \n[doc-space-mode] \
.nop \)
.doc-reset-args
..
.de doc-reset-args
.nr doc-arg-limit 0
.nr doc-arg-ptr 0
.nr doc-have-slot 0
.hy \n[doc-hyphen-flags]
..
.ec
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.eo
.de Fl
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.nop \*[doc-Fl-font]\c
.if !\n[doc-arg-limit] \{\
.ds doc-macro-name Fl
.doc-parse-args \$@
.if !\n[.$] \
.nop \|\-\|\f[]\s[0]
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.ie (\n[doc-arg-limit] < \n[doc-arg-ptr]) \{\
.nop \|\-\f[]\s[0]\c
.doc-print-and-reset
.\}
.el \{\
.ie (\n[doc-type\n[doc-arg-ptr]] == 1) \{\
.nop \|\-\f[]\s[0]\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
.\}\}
..
.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[]\s[0]\c
.\*[doc-str-dfr]
.\}
.el \{\
.nr doc-reg-dfr \n[doc-arg-ptr]
.ie (\n[doc-reg-dfr1] == 2) \{\
.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 \{\
.ie "\*[doc-str-dfr]"-" \
.nop \|\-\^\-\|\c
.el \
.nop \|\%\-\*[doc-str-dfr]\&\c
.\}\}\}
.el \{\
.nop \f[\n[doc-curr-font]]\s[\n[doc-curr-size]u]\c
.nop \)\*[doc-str-dfr]\f[]\s[0]\c
.\}
.ie (\n[doc-arg-limit] == \n[doc-arg-ptr]) \{\
.if (\n[doc-reg-dfr1] == 4) \
.nop \|\-\c
.nop \f[\n[doc-curr-font]]\s[\n[doc-curr-size]u]\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 \$@
.\}\}
..
.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]]
.ie (\n[doc-reg-dpr1] == 1) \{\
.nop \f[\n[doc-curr-font]]\s[\n[doc-curr-size]u]\c
.\*[doc-str-dpr]
.\}
.el \{\
.nr doc-reg-dpr \n[doc-arg-ptr]
.ie (\n[doc-reg-dpr1] == 2) \
.nop \%\*[doc-str-dpr]\&\c
.el \{\
.nop \f[\n[doc-curr-font]]\s[\n[doc-curr-size]u]\c
.nop \)\*[doc-str-dpr]\f[]\s[0]\c
.\}
.nr doc-arg-ptr +1
.ie (\n[doc-arg-limit] < \n[doc-arg-ptr]) \{\
.nop \f[\n[doc-curr-font]]\s[\n[doc-curr-size]u]\c
.doc-print-and-reset
.\}
.el \{\
.nop \)\*[doc-space\n[doc-reg-dpr]]\c
.doc-print-recursive
.\}\}
..
.de doc-print-prefixes
.while (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \{\
.if !(\n[doc-type\n[doc-arg-ptr]] == 4) \
.break
.nop \f[\n[doc-curr-font]]\s[\n[doc-curr-size]u]\c
.nop \)\*[doc-arg\n[doc-arg-ptr]]\f[]\s[0]\c
.nr doc-arg-ptr +1
.\}
..
.de doc-generic-macro
.if !\n[doc-arg-limit] \{\
.ie \n[.$] \{\
.ds doc-macro-name \$0
.doc-parse-args \$@
.\}
.el \
.tm Usage: .\$0 \*[doc-\$0-usage] ... (#\n[.c])
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.ie (\n[doc-arg-limit] >= \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])
.\}
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.nop \*[doc-\$0-font]\c
.doc-print-recursive
.\}
.el \{\
.tm Usage: .\$0 \*[doc-\$0-usage] ... (#\n[.c])
.doc-reset-args
.\}
..
.ds doc-str-Ar-default "file\ .\|.\|.
.de Ar
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.nop \*[doc-Ar-font]\c
.if !\n[doc-arg-limit] \{\
.ds doc-macro-name Ar
.doc-parse-args \$@
.if !\n[.$] \
.nop \)\*[doc-str-Ar-default]\&\f[]\s[0]
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.doc-print-prefixes
.ie (\n[doc-arg-limit] < \n[doc-arg-ptr]) \{\
.nop \)\*[doc-str-Ar-default]\&\f[]\s[0]\c
.doc-print-and-reset
.\}
.el \{\
.if !(\n[doc-type\n[doc-arg-ptr]] == 2) \{\
.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]
.nr doc-num-args (\n[doc-arg-limit] - \n[doc-arg-ptr])
.nr doc-arg-limit \n[doc-arg-ptr]
.doc-parse-space-vector
.\}
.doc-print-recursive
.\}
..
.als Ad doc-generic-macro
.ds doc-Ad-usage address
.nr doc-indent-synopsis 0
.nr doc-indent-synopsis-active 0
.de Cd
.if !\n[doc-arg-limit] \{\
.ie \n[.$] \{\
.ds doc-macro-name Cd
.doc-parse-args \$@
.\}
.el \
.tm Usage: .Cd configuration_file_declaration ... (#\n[.c])
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.ie (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \{\
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.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
.\}
..
.als Cm doc-generic-macro
.ds doc-Cm-usage interactive_command_modifier
.als Dv doc-generic-macro
.ds doc-Dv-usage defined_variable
.als doc-Dv-font doc-Er-font
.als Em doc-generic-macro
.ds doc-Em-usage text
.als Er doc-generic-macro
.ds doc-Er-usage text
.als Ev doc-generic-macro
.ds doc-Ev-usage text
.nr doc-have-decl 0
.nr doc-have-var 0
.de doc-do-func-decl
.if \n[doc-in-synopsis-section] \{\
.if \n[doc-have-var] \{\
.doc-paragraph
.nr doc-have-var 0
.\}
.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]
.nr doc-curr-size \n[.ps]
..
.de Fd
.ie ((\n[.$] >= 1) & (\n[doc-arg-limit] == 0)) \{\
.doc-do-func-decl
.nop \*[doc-Fd-font]\$*
.br
.ft \n[doc-curr-font]
.ps \n[doc-curr-size]u
.\}
.el \{\
.tm Usage: .Fd function_declaration -- Fd is not callable (#\n[.c])
.doc-reset-args
.\}
..
.de In
.if !\n[doc-arg-limit] \{\
.ie \n[.$] \{\
.ds doc-macro-name In
.doc-parse-args \$@
.\}
.el \
.tm Usage: .In include_file ... (#\n[.c])
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.doc-print-prefixes
.ie ((\n[doc-arg-limit] >= \n[doc-arg-ptr]) & (\n[doc-type\n[doc-arg-ptr]] == 2)) \{\
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.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]
.ps \n[doc-curr-size]u
.br
.nr doc-arg-ptr +1
.ie (\n[doc-arg-limit] >= \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]]\s[\n[doc-curr-size]u]>
.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]]\s[\n[doc-curr-size]u]>
.doc-print-recursive
.\}\}
.el \{\
.tm Usage: .In include_file ... (#\n[.c])
.doc-reset-args
.\}
..
.als Fr doc-generic-macro
.ds doc-Fr-usage function_return_value
.als doc-Fr-font doc-Ar-font
.als Ic doc-generic-macro
.ds doc-Ic-usage interactive_command
.als Li doc-generic-macro
.ds doc-Li-usage argument
.als Ms doc-generic-macro
.ds doc-Ms-usage math_symbol
.als doc-Ms-font doc-Sy-font
.ds doc-command-name
.de Nm
.if !\n[doc-arg-limit] \{\
.ds doc-macro-name Nm
.ie \n[.$] \
.doc-parse-args \$@
.el \{\
.ie "\*[doc-command-name]"" \
.tm Usage: .Nm name ... (#\n[.c])
.el \
.doc-parse-args \*[doc-command-name]
.\}\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.doc-print-prefixes
.ie (\n[doc-arg-limit] < \n[doc-arg-ptr]) \{\
.ie "\*[doc-command-name]"" \{\
.tm Usage: .Nm name ... (#\n[.c])
.doc-reset-args
.\}
.el \{\
.nop \*[doc-Nm-font]\*[doc-command-name]\f[]\s[0]\c
.doc-print-and-reset
.\}\}
.el \{\
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.ie !(\n[doc-type\n[doc-arg-ptr]] == 2) \{\
.ie "\*[doc-command-name]"" \
.tm Usage: .Nm name ... (#\n[.c])
.el \{\
.nr doc-arg-ptr -1
.ds doc-arg\n[doc-arg-ptr] "\*[doc-Nm-font]\*[doc-command-name]\f[]\s[0]
.nr doc-type\n[doc-arg-ptr] 2
.ds doc-space\n[doc-arg-ptr] "\*[doc-space]
.nr doc-num-args (\n[doc-arg-limit] - \n[doc-arg-ptr])
.nr doc-arg-limit \n[doc-arg-ptr]
.doc-parse-space-vector
.\}\}
.el \{\
.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
.\}\}
.if "\*[doc-command-name]"" \
.ds doc-command-name "\*[doc-arg\n[doc-arg-ptr]]
.nop \*[doc-Nm-font]\c
.\}
.doc-print-recursive
.\}
..
.de Pa
.if !\n[doc-arg-limit] \{\
.ds doc-macro-name Pa
.doc-parse-args \$@
.if !\n[.$] \
.nop \*[doc-Pa-font]~\f[]\s[0]
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.doc-print-prefixes
.ie (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \{\
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.nop \*[doc-Pa-font]\c
.if !(\n[doc-type\n[doc-arg-ptr]] == 2) \{\
.nr doc-arg-ptr -1
.ds doc-arg\n[doc-arg-ptr] ~
.nr doc-type\n[doc-arg-ptr] 2
.ds doc-space\n[doc-arg-ptr] "\*[doc-space]
.nr doc-num-args (\n[doc-arg-limit] - \n[doc-arg-ptr])
.nr doc-arg-limit \n[doc-arg-ptr]
.doc-parse-space-vector
.\}
.doc-print-recursive
.\}
.el \{\
.nop \*[doc-Pa-font]~\f[]\s[0]\c
.doc-print-and-reset
.\}
..
.als Sy doc-generic-macro
.ds doc-Sy-usage symbolic_text
.als Me doc-generic-macro
.ds doc-Me-usage menu_entry
.de Tn
.if !\n[doc-arg-limit] \{\
.ie \n[.$] \{\
.ds doc-macro-name Tn
.doc-parse-args \$@
.\}
.el \
.tm Usage: .Tn trade_name ... (#\n[.c])
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.ie (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \{\
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.nop \)\*[doc-Tn-font-size]\c
.ie !\n[doc-is-reference] \{\
.nop \)\*[doc-Tn-font-shape]\c
.doc-print-recursive
.\}
.el \
.doc-do-references
.\}
.el \{\
.tm Usage: .Tn trade_name ... (#\n[.c])
.doc-reset-args
.\}
..
.als Va doc-generic-macro
.ds doc-Va-usage variable_name
.als No doc-generic-macro
.ds doc-No-usage normal_text
.ds doc-quote-left
.ds doc-quote-right
.de Op
.if !\n[doc-arg-limit] \
.ds doc-macro-name Op
.ds doc-quote-left "\*[doc-left-bracket]
.ds doc-quote-right "\*[doc-right-bracket]
.doc-enclose-string \$@
..
.de Aq
.if !\n[doc-arg-limit] \
.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 \$@
..
.de Bq
.if !\n[doc-arg-limit] \
.ds doc-macro-name Bq
.ds doc-quote-left "\*[doc-left-bracket]
.ds doc-quote-right "\*[doc-right-bracket]
.doc-enclose-string \$@
..
.de Brq
.if !\n[doc-arg-limit] \
.ds doc-macro-name Brq
.ds doc-quote-left {
.ds doc-quote-right }
.doc-enclose-string \$@
..
.de Dq
.if !\n[doc-arg-limit] \
.ds doc-macro-name Dq
.ds doc-quote-left "\*[Lq]
.ds doc-quote-right "\*[Rq]
.doc-enclose-string \$@
..
.de Eq
.if !\n[doc-arg-limit] \
.ds doc-macro-name Eq
.ds doc-quote-left "\$1
.ds doc-quote-right "\$2
.shift 2
.doc-enclose-string \$@
..
.de Pq
.if !\n[doc-arg-limit] \
.ds doc-macro-name Pq
.ds doc-quote-left "\*[doc-left-parenthesis]
.ds doc-quote-right "\*[doc-right-parenthesis]
.doc-enclose-string \$@
..
.de Qq
.if !\n[doc-arg-limit] \
.ds doc-macro-name Qq
.ds doc-quote-left "\*[q]
.ds doc-quote-right "\*[q]
.doc-enclose-string \$@
..
.de Sq
.if !\n[doc-arg-limit] \
.ds doc-macro-name Sq
.ds doc-quote-left "\*[doc-left-singlequote]
.ds doc-quote-right "\*[doc-right-singlequote]
.doc-enclose-string \$@
..
.de Es
.if !\n[doc-arg-limit] \{\
.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-limit] \
.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-limit] >= \n[doc-arg-ptr]) \
.doc-do-\n[doc-type\n[doc-arg-ptr]]
.el \
.doc-print-and-reset
..
.nr doc-have-slot 0
.de doc-enclose-string
.if \n[doc-in-synopsis-section] \
.doc-set-hard-space
.if !\n[doc-arg-limit] \{\
.ie \n[.$] \
.doc-parse-args \$@
.el \{\
.nop \)\*[doc-quote-left]\*[doc-quote-right]
.\}\}
.if !\n[doc-arg-limit] \
.return
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.nr doc-arg-ptr +1
.doc-print-prefixes
.nop \)\*[doc-quote-left]\)\c
.ie (\n[doc-arg-limit] < \n[doc-arg-ptr]) \{\
.nop \)\*[doc-quote-right]\)\c
.doc-print-and-reset
.\}
.el \{\
.ie (\n[doc-type\n[doc-arg-limit]] == 3) \{\
.nr doc-reg-des (\n[doc-arg-limit] - 1)
.while (\n[doc-type\n[doc-reg-des]] == 3) \
.nr doc-reg-des -1
.nr doc-reg-des +1
.ds doc-arg\n[doc-reg-des] "\*[doc-quote-right]\)\*[doc-arg\n[doc-reg-des]]
.\}
.el \{\
.nr doc-reg-des \n[doc-arg-limit]
.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
.\}
.ie (\n[doc-reg-des] == \n[doc-arg-limit]) \
.doc-append-arg "\)\*[doc-quote-right]\)" 3
.el \{\
.ie \n[doc-have-slot] \
.ds doc-arg\n[doc-reg-des] "\*[doc-quote-right]\)\*[doc-arg\n[doc-reg-des]]
.el \{\
.nr doc-reg-des +1
.nr doc-reg-des1 \n[doc-arg-limit]
.nr doc-reg-des2 (\n[doc-arg-limit] + 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-limit +1
.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-limit] - \n[doc-reg-des] + 1)
.nr doc-arg-limit (\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
..
.als En doc-enclose-string
.de Ao
.if !\n[doc-arg-limit] \
.ds doc-macro-name Ao
.ie "\*[doc-macro-name]"An" \
.ds doc-quote-left <
.el \
.ds doc-quote-left \[la]
.doc-enclose-open \$@
..
.de Ac
.if !\n[doc-arg-limit] \
.ds doc-macro-name Ac
.ie "\*[doc-macro-name]"An" \
.ds doc-quote-right >
.el \
.ds doc-quote-right \[ra]
.doc-enclose-close \$@
..
.de Bo
.if !\n[doc-arg-limit] \
.ds doc-macro-name Bo
.ds doc-quote-left "\*[doc-left-bracket]
.doc-enclose-open \$@
..
.de Bc
.if !\n[doc-arg-limit] \
.ds doc-macro-name Bc
.ds doc-quote-right "\*[doc-right-bracket]
.doc-enclose-close \$@
..
.de Bro
.if !\n[doc-arg-limit] \
.ds doc-macro-name Bo
.ds doc-quote-left {
.doc-enclose-open \$@
..
.de Brc
.if !\n[doc-arg-limit] \
.ds doc-macro-name Bc
.ds doc-quote-right }
.doc-enclose-close \$@
..
.de Do
.if !\n[doc-arg-limit] \
.ds doc-macro-name Do
.ds doc-quote-left "\*[Lq]
.doc-enclose-open \$@
..
.de Dc
.if !\n[doc-arg-limit] \
.ds doc-macro-name Dc
.ds doc-quote-right "\*[Rq]
.doc-enclose-close \$@
..
.de Eo
.if !\n[doc-arg-limit] \
.ds doc-macro-name Eo
.ds doc-quote-left "\$1
.shift
.doc-enclose-open \$@
..
.de Ec
.if !\n[doc-arg-limit] \
.ds doc-macro-name Ec
.ds doc-quote-right "\$1
.shift
.doc-enclose-close \$@
..
.de Oo
.if !\n[doc-arg-limit] \
.ds doc-macro-name Oo
.ds doc-quote-left [
.doc-enclose-open \$@
..
.de Oc
.if !\n[doc-arg-limit] \
.ds doc-macro-name Oc
.ds doc-quote-right ]
.doc-enclose-close \$@
..
.de Po
.if !\n[doc-arg-limit] \
.ds doc-macro-name Po
.ds doc-quote-left "\*[doc-left-parenthesis]
.doc-enclose-open \$@
..
.de Pc
.if !\n[doc-arg-limit] \
.ds doc-macro-name Pc
.ds doc-quote-right "\*[doc-right-parenthesis]
.doc-enclose-close \$@
..
.de Qo
.if !\n[doc-arg-limit] \
.ds doc-macro-name Qo
.ds doc-quote-left "\*[q]
.doc-enclose-open \$@
..
.de Qc
.if !\n[doc-arg-limit] \
.ds doc-macro-name Qc
.ds doc-quote-right "\*[q]
.doc-enclose-close \$@
..
.de So
.if !\n[doc-arg-limit] \
.ds doc-macro-name So
.ds doc-quote-left "\*[doc-left-singlequote]
.doc-enclose-open \$@
..
.de Sc
.if !\n[doc-arg-limit] \
.ds doc-macro-name Sc
.ds doc-quote-right "\*[doc-right-singlequote]
.doc-enclose-close \$@
..
.de Xo
.if !\n[doc-arg-limit] \
.ds doc-macro-name Xo
.ds doc-quote-left
.doc-enclose-open \$@
..
.de Xc
.if !\n[doc-arg-limit] \
.ds doc-macro-name Xc
.ds doc-quote-right
.doc-enclose-close \$@
..
.nr doc-nesting-level 0
.nr doc-in-list 0
.de doc-enclose-open
.if !\n[doc-arg-limit] \
.doc-parse-args \$@
.nr doc-arg-ptr +1
.doc-print-prefixes
.nr doc-arg-ptr -1
.nop \)\*[doc-quote-left]\)\c
.box doc-enclosure-box\n[doc-nesting-level]
.ev doc-enclosure-env\n[doc-nesting-level]
.evc 0
.in 0
.nf
.nop \&\c
.nr doc-nesting-level +1
.if \n[doc-arg-limit] \{\
.nr doc-arg-ptr +1
.ie (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \
.doc-print-recursive
.el \
.doc-reset-args
.\}
..
.de doc-enclose-close
.nr doc-nesting-level -1
.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-limit] \{\
.doc-parse-args \$@
.if !\n[.$] \
.doc-print-and-reset
.\}
.if \n[doc-arg-limit] \{\
.ie (\n[doc-arg-limit] > \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
.\}
.if !"\*[doc-macro-name]"It" \
.if \n[doc-in-list] \
.if !\n[doc-nesting-level] \
.doc-\*[doc-list-type-stack\n[doc-list-depth]]
..
.de Pf
.if !\n[doc-arg-limit] \
.ds doc-macro-name Pf
.ie \n[doc-arg-limit] \{\
.ie ((\n[doc-arg-limit] - \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-limit] \{\
.nr doc-arg-ptr +1
.ie (\n[doc-arg-limit] < \n[doc-arg-ptr]) \
.doc-print-and-reset
.el \
.doc-do-\n[doc-type\n[doc-arg-ptr]]
.\}
..
.de Ns
.if !\n[doc-arg-limit] \{\
.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-limit] \{\
.nr doc-arg-ptr +1
.ie (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \
.doc-print-recursive
.el \
.doc-reset-args
.\}
..
.de Ap
.ie !\n[doc-arg-limit] \
.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-limit] >= \n[doc-arg-ptr]) \
.doc-print-recursive
.el \
.doc-reset-args
.\}
..
.ds doc-space "\*[doc-soft-space]
.de doc-set-hard-space
.ie "\*[doc-space]"" \
.ds doc-saved-space "\*[doc-hard-space]
.el \
.ds doc-space "\*[doc-hard-space]
..
.de doc-set-soft-space
.ie "\*[doc-space]"" \
.ds doc-saved-space "\*[doc-soft-space]
.el \
.ds doc-space "\*[doc-soft-space]
..
.nr doc-space-mode 1
.ds doc-saved-space "\*[doc-space]
.nr doc-have-space 0
.de Sm
.ie \n[doc-have-space] \
.nr doc-reg-Sm 0
.el \
.nr doc-reg-Sm 1
.if !\n[doc-arg-limit] \{\
.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
.if \n[doc-reg-Sm] \
.if \n[.int] \
.nop \)
.\}
.\}\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.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 \{\
.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] \{\
.nr doc-num-args (\n[doc-arg-limit] - \n[doc-arg-ptr])
.nr doc-arg-limit \n[doc-arg-ptr]
.if \n[doc-num-args] \
.doc-parse-space-vector
.if \n[doc-reg-Sm] \
.if \n[.int] \
.nop \)
.\}
.el \{\
.nr doc-reg-Sm (\n[doc-arg-ptr] + 1)
.while (\n[doc-reg-Sm] <= \n[doc-arg-limit]) \{\
.ds doc-space\n[doc-reg-Sm]
.nr doc-reg-Sm +1
.\}
.\}
.ie (\n[doc-arg-limit] > \n[doc-arg-ptr]) \{\
.nr doc-arg-ptr +1
.doc-print-recursive
.\}
.el \
.doc-reset-args
..
.nr doc-arg-type 0
.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
.\}
..
.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
.\}
..
.de doc-set-spacing-1
.nr doc-reg-dssfm1 \n[\*[doc-arg\n[doc-arg-limit]]]
.ie (\n[doc-reg-dssfm1] == 3) \{\
.if \n[doc-arg-limit] \{\
.nr doc-reg-dssfm (\n[doc-arg-limit] - 1)
.ds doc-space\n[doc-reg-dssfm]
.\}
.ds doc-space\n[doc-arg-limit] "\*[doc-space]
.\}
.el \{\
.ie (\n[doc-reg-dssfm1] == 2) \{\
.if \n[doc-arg-limit] \{\
.nr doc-reg-dssfm (\n[doc-arg-limit] - 1)
.ds doc-space\n[doc-reg-dssfm]
.\}
.ds doc-space\n[doc-arg-limit]
.\}
.el \
.ds doc-space\n[doc-arg-limit]
.\}
..
.de doc-set-spacing-2
.ds doc-space\n[doc-arg-limit] "\*[doc-space]
..
.de doc-set-spacing-3
.if \n[doc-arg-limit] \{\
.nr doc-reg-dssfps (\n[doc-arg-limit] - 1)
.ds doc-space\n[doc-reg-dssfps]
.\}
.ds doc-space\n[doc-arg-limit] "\*[doc-space]
..
.de doc-set-spacing-4
.ds doc-space\n[doc-arg-limit]
..
.de doc-do-1
.\*[doc-arg\n[doc-arg-ptr]]
..
.als doc-do-2 doc-print-recursive
.als doc-do-3 doc-print-recursive
.als doc-do-4 doc-print-recursive
.nr doc-fontmode-depth 0
.nr doc-fontmode-font-stack0 0
.nr doc-fontmode-size-stack0 0
.de Bf
.ds doc-macro-name Bf
.ie \n[.$] \{\
.nr doc-fontmode-depth +1
.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])
..
.de Ef
.ds doc-macro-name Ef
.ie \n[doc-fontmode-depth] \{\
.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-curr-size \n[.ps]
.nr doc-fontmode-depth -1
.\}
.el \
.tm mdoc warning: Extraneous .Ef (#\n[.c])
..
.nr doc-keep-type 0
.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"" \{\
.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
.\}\}\}
..
.de Ek
.ds doc-macro-name Ek
.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
..
.nr doc-display-depth 0
.nr doc-is-compact 0
.ds doc-display-type-stack0
.nr doc-display-indent-stack0 0
.nr doc-display-ad-stack0 0
.nr doc-display-fi-stack0 0
.nr doc-display-ft-stack0 0
.nr doc-display-ps-stack0 0
.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
.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
.\}\}\}\}\}
.if \n[doc-reg-Bd] \{\
.shift
.if \n[.$] \
.doc-do-Bd-args \$@
.\}
.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
..
.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
.\}\}\}\}
.if (\n[doc-reg-ddBa] == 1) \{\
.nr doc-reg-ddBa 2
.nr doc-reg-ddBa1 0
.if \B(\$2) \{\
.nr doc-reg-ddBa2 \n[.warn]
.warn (\n[.warn] - (\n[.warn] / 32 % 2 * 32))
.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
.\}
.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) \{\
.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 \$@
.\}
..
.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
.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
..
.ds doc-list-type-stack1
.nr doc-list-indent-stack1 0
.nr doc-list-have-indent-stack1 0
.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
.\}\}\}\}\}\}\}\}\}\}\}
.if !\n[doc-arg-ptr] \{\
.doc-Bl-usage
.doc-reset-args
.nr doc-list-depth -1
.return
.\}
.shift
.nr doc-reg-Bl 1
.while (\n[doc-reg-Bl] <= \n[.$]) \{\
.ds doc-arg\n[doc-reg-Bl] "\$[\n[doc-reg-Bl]]
.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-limit \n[.$]
.nr doc-arg-ptr 0
.doc-do-Bl-args
.in +\n[doc-list-offset-stack\n[doc-list-depth]]u
.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
..
.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])
..
.de doc-do-Bl-args
.nr doc-arg-ptr +1
.if (\n[doc-arg-limit] < \n[doc-arg-ptr]) \
.return
.nr doc-reg-dBla (\n[doc-arg-ptr] + 1)
.if (\n[doc-arg-limit] < \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] \{\
.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 \{\
.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-indent-stack\n[doc-list-depth] (\*[doc-str-dBla])
.el \{\
.doc-get-arg-width \n[doc-arg-ptr]
.ie (\n[doc-width] == 2) \{\
.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) \{\
.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
.\}\}\}
.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] \{\
.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-limit] > \n[doc-arg-ptr]) \
.doc-do-Bl-args
..
.de doc-save-global-vars
.ds doc-macro-name-saved "\*[doc-macro-name]
.nr doc-arg-limit-saved \n[doc-arg-limit]
.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-limit]) \{\
.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-curr-size-saved \n[doc-curr-size]
.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-command-name-saved "\*[doc-command-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
.\}
.ds doc-saved-Pa-font-saved "\*[doc-saved-Pa-font]
.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-document-title-saved "\*[doc-document-title]
.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-header-space-saved \n[doc-header-space]
.nr doc-footer-space-saved \n[doc-footer-space]
.nr doc-display-vertical-saved \n[doc-display-vertical]
.ds doc-header-string-saved "\*[doc-header-string]
.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]
..
.de doc-restore-global-vars
.ds doc-macro-name "\*[doc-macro-name-saved]
.nr doc-arg-limit \n[doc-arg-limit-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-limit]) \{\
.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-curr-size \n[doc-curr-size-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-command-name "\*[doc-command-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
.\}
.ds doc-saved-Pa-font "\*[doc-saved-Pa-font-saved]
.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-document-title "\*[doc-document-title-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-header-space \n[doc-header-space-saved]
.nr doc-footer-space \n[doc-footer-space-saved]
.nr doc-display-vertical \n[doc-display-vertical-saved]
.ds doc-header-string "\*[doc-header-string-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]
..
.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
..
.ds doc-saved-Pa-font
.nr doc-curr-type 0
.ds doc-curr-arg
.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
.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
.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] \{\
.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) \{\
.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]
.if \n[doc-in-files-section] \{\
.ds doc-saved-Pa-font "\*[doc-Pa-font]
.if n \
.ds doc-Pa-font "\*[doc-No-font]
.\}
.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])
.\}
.\}
.if !\n[doc-nesting-level] \
.doc-\*[doc-str-It]
..
.de doc-inset-list
.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]
.if \n[doc-in-files-section] \
.if n \
.ds doc-Pa-font "\*[doc-saved-Pa-font]
.nr doc-in-list 0
.doc-reset-args
..
.de doc-hang-list
.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
.\}
.if \n[doc-in-files-section] \
.if n \
.ds doc-Pa-font "\*[doc-saved-Pa-font]
.nr doc-in-list 0
.doc-reset-args
..
.de doc-ohang-list
.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
.if \n[doc-in-files-section] \
.if n \
.ds doc-Pa-font "\*[doc-saved-Pa-font]
.nr doc-in-list 0
.doc-reset-args
..
.de doc-item-list
.br
.ev
.box
.doc-set-vertical-and-indent 0
.br
.doc-reset-args
..
.nr doc-enum-list-count-stack1 0
.de doc-enum-list
.nr doc-in-list 1
.nr doc-enum-list-count-stack\n[doc-list-depth] +1
.nop \*[doc-tag-prefix-stack\n[doc-list-depth]]\c
.nop \n[doc-enum-list-count-stack\n[doc-list-depth]].\&
.doc-do-list
..
.de doc-bullet-list
.nr doc-in-list 1
.nop \)\*[doc-Sy-font]\[bu]\f[]
.doc-do-list
..
.de doc-dash-list
.nr doc-in-list 1
.nop \)\*[doc-Sy-font]\-\f[]
.doc-do-list
..
.als doc-do-list doc-hang-list
.nr doc-diag-list-input-line-count 0
.de doc-diag-list
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.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]]\s[\n[doc-curr-size]u]\*[doc-hard-space]\c
.doc-print-and-reset
..
.de doc-tag-list
.br
.ev
.box
.unformat doc-item-box\n[doc-list-depth]
.box doc-box-dtl
.ev doc-env-dtl
.evc 0
.fi
.ad 0
.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 \{\
.vpt 0
.br
.sp -1
.vpt 1
.nop \&\c
.nr doc-have-space 1
.\}
.if \n[doc-in-files-section] \
.if n \
.ds doc-Pa-font "\*[doc-saved-Pa-font]
.nr doc-in-list 0
.doc-reset-args
..
.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
..
.nr doc-list-depth 0
.nr doc-num-columns 0
.nr doc-compact-list-stack1 0
.ds doc-tag-prefix-stack1
.nr doc-list-offset-stack1 0
.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
..
.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
..
.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
..
.de Xr
.if !\n[doc-arg-limit] \{\
.ie \n[.$] \{\
.ds doc-macro-name Xr
.doc-parse-args \$@
.\}
.el \
.doc-Xr-usage
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.doc-print-prefixes
.ie (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \{\
.ie (\n[doc-type\n[doc-arg-ptr]] == 2) \{\
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.ds doc-arg\n[doc-arg-ptr] \*[doc-Xr-font]\*[doc-arg\n[doc-arg-ptr]]\f[]\s[0]
.if (\n[doc-arg-limit] > \n[doc-arg-ptr]) \{\
.nr doc-reg-Xr (\n[doc-arg-ptr] + 1)
.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
..
.de doc-Xr-usage
.tm Usage: .Xr manpage_name [section#] ... (#\n[.c])
.doc-reset-args
..
.als Sx doc-generic-macro
.ds doc-Sx-usage section_header
.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
..
.nr doc-column-indent-width 0
.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 \{\
.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
..
.de doc-column-list
.if \n[doc-num-args] \
.doc-parse-arg-vector
.nr doc-arg-ptr +1
.if (\n[doc-arg-limit] < \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]]
..
.de Ta
.ie \n[doc-arg-limit] \{\
.nr doc-arg-ptr +1
.nop \*[doc-tab]\c
.ie (\n[doc-arg-limit] >= \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])
.\}
..
.de Dl
.ta T .5i
.in +\n[doc-display-indent]u
.ie \n[doc-arg-limit] \{\
.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]
.nr doc-curr-size \n[.ps]
.nop \*[doc-Li-font]\c
.doc-print-recursive
.\}
.el \
.tm Usage: .Dl argument ... (#\n[.c])
.\}
.in -\n[doc-display-indent]u
..
.de D1
.ta T .5i
.in +\n[doc-display-indent]u
.ie \n[doc-arg-limit] \{\
.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
..
.de Vt
.if !\n[doc-arg-limit] \{\
.ie \n[.$] \{\
.ds doc-macro-name Vt
.doc-parse-args \$@
.\}
.el \
.tm Usage: .Vt variable_type ... (#\n[.c])
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.if (\n[doc-arg-limit] < \n[doc-arg-ptr]) \{\
.tm Usage: .Vt variable_type ... (#\n[.c])
.doc-reset-args
.return
.\}
.if \n[doc-in-synopsis-section] \{\
.if \n[doc-have-decl] \{\
.doc-paragraph
.nr doc-have-decl 0
.\}
.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]
.nr doc-curr-size \n[.ps]
.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
.\}
..
.nr doc-is-func 0
.de Ft
.if !\n[doc-arg-limit] \{\
.ie \n[.$] \{\
.ds doc-macro-name Ft
.doc-parse-args \$@
.\}
.el \
.tm Usage: .Ft function_type ... (#\n[.c])
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.if (\n[doc-arg-limit] < \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]
.nr doc-curr-size \n[.ps]
.nop \*[doc-Ft-font]\c
.doc-print-recursive
..
.nr doc-have-old-func 0
.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
..
.de Fa
.if !\n[doc-arg-limit] \{\
.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-limit] >= \n[doc-arg-ptr]) \{\
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.nop \*[doc-Fa-font]\c
.doc-print-recursive
.if \n[doc-in-synopsis-section] \
.if \n[doc-have-func] \
.br
.\}\}
..
.nr doc-func-arg-count 0
.ds doc-func-arg
.nr doc-num-func-args 0
.nr doc-func-args-processed 0
.de doc-do-func
.if (\n[doc-arg-limit] <= \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]]\s[\n[doc-curr-size]u]\|\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[]\s[0]\c
.\}
.if (\n[doc-func-arg-count] == 1) \{\
.nop \)\*[doc-Fa-font]\*[doc-arg\n[doc-arg-ptr]]\c
.nop \f[]\s[0]\c
.\}
.nr doc-func-arg-count +1
.doc-do-func
..
.nr doc-have-func 0
.de Fn
.if !\n[doc-arg-limit] \{\
.ie \n[.$] \{\
.ds doc-macro-name Fn
.doc-parse-args \$@
.\}
.el \
.tm Usage: .Fn function_name [function_arg] ... (#\n[.c])
.\}
.if !\n[doc-arg-limit] \
.return
.if \n[doc-in-synopsis-section] \{\
.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-limit] < \n[doc-arg-ptr]) \{\
.tm Usage: .Fn function_name [function_arg] ... (#\n[.c])
.doc-reset-args
.return
.\}
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.nop \*[doc-Fn-font]\*[doc-arg\n[doc-arg-ptr]]\c
.nop \f[]\s[0]\*[lp]\)\c
.nr doc-arg-ptr +1
.if (\n[doc-arg-limit] >= \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]]\s[\n[doc-curr-size]u]\c
.\}\}
.nop \)\*[rp]\)\c
.if \n[doc-in-synopsis-section] \
.nop \);\)\c
.ie (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \{\
.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
..
.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-limit] >= \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]]\s[\n[doc-curr-size]u]\|\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[]\s[0]\|\c
.doc-do-func-args
.\}\}
..
.nr doc-saved-nesting-level 0
.nr doc-in-func-enclosure 0
.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-limit] \{\
.ie \n[.$] \{\
.ds doc-macro-name Fo
.doc-parse-args \$@
.\}
.el \
.tm Usage: .Fo function_name (#\n[.c])
.\}
.if \n[doc-in-synopsis-section] \{\
.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)
.\}
.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-limit] >= \n[doc-arg-ptr]) \{\
.nr doc-func-arg-count 1
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.nop \*[doc-Fn-font]\*[doc-arg\n[doc-arg-ptr]]\c
.nop \f[]\s[0]\*[lp]\)\c
.doc-reset-args
.\}
..
.de Fc
.if !\n[doc-in-func-enclosure] \{\
.tm mdoc warning: Extraneous .Fc (#\n[.c])
.return
.\}
.if \n[.$] \{\
.ds doc-macro-name Fc
.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]\)
.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-limit] >= \n[doc-arg-ptr]) \{\
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.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
..
.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 \$@
.\}
..
.nr doc-is-reference 0
.nr doc-reference-count 0
.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
.\}
..
.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
.\}
..
.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
..
.de doc-finish-reference
.nr doc-reference-count -\$1
.ie \n[doc-reference-count] \
.nop \),
.el \
.nop \).
..
.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]
..
.ds doc-str-dpra "and
.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]],
..
.nr doc-author-count 0
.ds doc-author-name0
.de %A
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.box doc-author-name\n[doc-author-count]
.ev doc-env-%A
.evc 0
.in 0
.nf
.doc-do-references
..
.nr doc-book-count 0
.ds doc-book-name
.de %B
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.ie \n[doc-is-reference] \{\
.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
.\}
..
.nr doc-city-count 0
.ds doc-city-name
.de %C
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-city-name
.ev doc-env-%C
.evc 0
.in 0
.nf
.doc-do-references
..
.nr doc-date-count 0
.ds doc-date
.de %D
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-date
.ev doc-env-%D
.evc 0
.in 0
.nf
.doc-do-references
..
.nr doc-publisher-count 0
.ds doc-publisher-name
.de %I
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-publisher-name
.ev doc-env-%I
.evc 0
.in 0
.nf
.nop \*[doc-Em-font]\c
.doc-do-references
..
.nr doc-journal-count 0
.ds doc-journal-name
.de %J
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-journal-name
.ev doc-env-%J
.evc 0
.in 0
.nf
.nop \*[doc-Em-font]\c
.doc-do-references
..
.nr doc-issue-count 0
.ds doc-issue-name
.de %N
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-issue-name
.ev doc-env-%N
.evc 0
.in 0
.nf
.doc-do-references
..
.nr doc-optional-count 0
.ds doc-optional-string
.de %O
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-optional-string
.ev doc-env-%O
.evc 0
.in 0
.nf
.doc-do-references
..
.nr doc-page-number-count 0
.ds doc-page-number-string
.de %P
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-page-number-string
.ev doc-env-%P
.evc 0
.in 0
.nf
.doc-do-references
..
.nr doc-corporate-count 0
.ds doc-corporate-name
.de %Q
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-corporate-name
.ev doc-env-%Q
.evc 0
.in 0
.nf
.doc-do-references
..
.nr doc-report-count 0
.ds doc-report-name
.de %R
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-report-name
.ev doc-env-%R
.evc 0
.in 0
.nf
.doc-do-references
..
.nr doc-reference-title-count 0
.ds doc-reference-title-name
.ds doc-reference-title-name-for-book
.de %T
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.ie \n[doc-is-reference] \{\
.boxa doc-reference-title-name-for-book
.ev doc-env-%T
.evc 0
.in 0
.nf
.nop \*[doc-No-font]\c
.doc-do-references
.ds doc-macro-name %T
.doc-parse-args \$@
.nr doc-arg-ptr +1
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.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
.\}
..
.nr doc-url-count 0
.ds doc-url-name
.nr doc-volume-count 0
.ds doc-volume-name
.de %U
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-url-name
.ev doc-env-%U
.evc 0
.in 0
.nf
.doc-do-references
..
.de %V
.if (\n[doc-arg-limit] : (\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]
.nr doc-curr-size \n[.ps]
.boxa doc-volume-name
.ev doc-env-%V
.evc 0
.in 0
.nf
.doc-do-references
..
.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) \{\
.doc-append-arg \c 3
.\*[doc-arg\n[doc-arg-ptr]]
.\}
.el \{\
.nop \)\*[doc-arg\n[doc-arg-ptr]]\c
.ie (\n[doc-arg-limit] == \n[doc-arg-ptr]) \{\
.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
.\}\}
..
.de Hf
.ie ((\n[.$] == 1) & (\n[doc-arg-limit] == 0)) \{\
.doc-paragraph
.nop File:
.Pa \$1
.Bd -literal
.so \$1
.Ed
.doc-paragraph
.\}
.el \
.Usage: .Hf file (#\n[.c])
..
.nr doc-have-author 0
.de An
.if !\n[doc-arg-limit] \{\
.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-limit] \{\
.nr doc-arg-ptr +1
.ie (\n[doc-arg-limit] >= \n[doc-arg-ptr]) \{\
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.doc-print-recursive
.\}
.el \{\
.tm Usage: .An author_name ... (#\n[.c])
.doc-reset-args
.\}\}
..
.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.
.de Rv
.if \n[doc-arg-limit] \{\
.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]
.\}\}\}
..
.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.
.de Ex
.if \n[doc-arg-limit] \{\
.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]
.\}\}
..
.de Mt
.Pa \$@
..
.de Lk
.if !\n[doc-arg-limit] \{\
.ds doc-macro-name Lk
.doc-parse-args \$@
.\}
.if !\n[doc-arg-limit] \
.return
.nr doc-arg-ptr +1
.ds doc-target-Lk "\*[doc-arg\n[doc-arg-ptr]]
.nr doc-arg-ptr +1
.nr doc-lasttext-Lk \n[doc-arg-limit]
.while (\n[doc-lasttext-Lk] >= \n[doc-arg-ptr]) \{\
.if !(\n[doc-type\n[doc-lasttext-Lk]] == 3) \
.break
.nr doc-lasttext-Lk -1
.\}
.nr doc-curr-font \n[.f]
.nr doc-curr-size \n[.ps]
.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]]\s[\n[doc-curr-size]u]:
.nr doc-arg-ptr +1
.\}
.nop \*[doc-Sy-font]\*[doc-target-Lk]\c
.nop \f[\n[doc-curr-font]]\s[\n[doc-curr-size]u]\c
.while (\n[doc-arg-ptr] <= \n[doc-arg-limit]) \{\
.nop \&\*[doc-arg\n[doc-arg-ptr]]\c
.nr doc-arg-ptr +1
.\}
.nop \&
.doc-reset-args
..
.de doc-defunct-macro
.tmc mdoc error: .\$0 defunct
.if d doc-\$0-usage \
.tmc , \*[doc-\$0-usage]
.tm1 " (#\n[.c])
..
.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@
.de em
.tm1 "mdoc error: end-macro (.em) respecification is not allowed. (#\n[.c])
.tm1 "            Should this have been '.Em ...'?
.ab
..
.de doc-empty-line
.if !\n[doc-display-depth] \
.tm mdoc warning: Empty input line #\n[.c]
.sp
..
.blm doc-empty-line
.ec
.if '\*[.T]'utf8' \{\
.rchar \- - ' `
.char \- \N'45'
.char  - \N'45'
.char  ' \N'39'
.char  ` \N'96'
.\}
.mso mdoc.local