ssingh
d04860d55a
Reviewed-on: http://13.234.246.121:3000/Neominds/ossl35vx69/pulls/1 Reviewed-by: Jayesh Babu <jayesh@neominds.in> Co-authored-by: siddhant <siddhant.singh@neominds.in> Co-committed-by: siddhant <siddhant.singh@neominds.in>
3451 lines
85 KiB
Plaintext
3451 lines
85 KiB
Plaintext
.\" 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]]\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
|