1998-02-15 03:40:07 +03:00
|
|
|
|
.\" $NetBSD: doc-ditroff,v 1.4 1998/02/15 00:40:12 thorpej Exp $
|
|
|
|
|
.\"
|
1997-07-02 06:55:38 +04:00
|
|
|
|
.\" Copyright (c) 1991, 1993
|
|
|
|
|
.\" The Regents of the University of California. All rights reserved.
|
1993-03-21 12:45:37 +03:00
|
|
|
|
.\"
|
|
|
|
|
.\" 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. All advertising materials mentioning features or use of this software
|
|
|
|
|
.\" must display the following acknowledgement:
|
|
|
|
|
.\" This product includes software developed by the University of
|
|
|
|
|
.\" California, Berkeley and its contributors.
|
|
|
|
|
.\" 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.
|
|
|
|
|
.\"
|
1997-07-02 06:55:38 +04:00
|
|
|
|
.\" @(#)doc-ditroff 8.1 (Berkeley) 6/8/93
|
1993-03-21 12:45:37 +03:00
|
|
|
|
.\"
|
|
|
|
|
.\" tmac.mdoc-ditroff
|
|
|
|
|
.\" %beginstrip%
|
|
|
|
|
.\"
|
|
|
|
|
.ds aD \fI\s10
|
|
|
|
|
.ds aR \f(CO\s10
|
|
|
|
|
.ds cM \f(CB\s10
|
|
|
|
|
.ds dF \fR\s10
|
|
|
|
|
.ds eM \fI\s10
|
|
|
|
|
.ds eR \fC\s10
|
|
|
|
|
.ds eV \fC\s10
|
|
|
|
|
.ds fA \f(CO\s10
|
|
|
|
|
.ds fD \f(CB\s10
|
|
|
|
|
.ds fL \f(CB\s10
|
|
|
|
|
.ds fN \f(CB\s10
|
|
|
|
|
.ds fP \fP\s0
|
|
|
|
|
.ds fS \s0
|
|
|
|
|
.ds fT \f(CO\s10
|
|
|
|
|
.ds Hs \fR\s10
|
|
|
|
|
.ds iC \f(CB\s10
|
|
|
|
|
.ds lI \fC
|
|
|
|
|
.ds lP \fR\|(\|\fP\s10
|
|
|
|
|
.ds lp \fR(\fP\s10
|
|
|
|
|
.ds rP \fR\|)\|\fP\s10
|
|
|
|
|
.ds rp \fR)\fP\s10
|
|
|
|
|
.ds lB \fR\^[\^\fP\s10
|
|
|
|
|
.ds rB \fR\^]\fP\s10
|
|
|
|
|
.ds mL \fB\s10
|
|
|
|
|
.ds nM \f(CB\s10
|
|
|
|
|
.ds nO \fR\s10
|
|
|
|
|
.ds nT \s0
|
|
|
|
|
.ds pA \fC\s10
|
|
|
|
|
.ds Pu \fR{\ .\ ,\ :\ ;\ (\ )\ [\ ]\ \fR}
|
|
|
|
|
.ds rA \fR\s10
|
|
|
|
|
.ds rT \f(CO\s10
|
|
|
|
|
.ds sH \fB\s10
|
|
|
|
|
.ds sP \s0
|
|
|
|
|
.ds sY \fB\s10
|
|
|
|
|
.ds sX \fR\s10
|
|
|
|
|
.ds tF \fR
|
|
|
|
|
.ds tN \s9
|
|
|
|
|
.ds vA \fI\s10
|
|
|
|
|
.ds Vs \fR\s10
|
|
|
|
|
.ds vT \f(CB\s10
|
|
|
|
|
.ds xR \fC\s10
|
|
|
|
|
.tr *\(**
|
|
|
|
|
.nr sI \w\fC,u*5
|
|
|
|
|
.nr Ti \n(sIu
|
|
|
|
|
.nr Pp .5v
|
|
|
|
|
.ds lS \0
|
|
|
|
|
.nr lS \w'\0'u
|
|
|
|
|
.nr dI 6n
|
|
|
|
|
.de pL
|
|
|
|
|
.nr Hm .5i
|
|
|
|
|
.nr Fm .5i
|
|
|
|
|
.nr ll 6.5i
|
|
|
|
|
.ll 6.5i
|
|
|
|
|
.nr lt 6.5i
|
|
|
|
|
.lt 6.5i
|
|
|
|
|
.nr po 1i
|
|
|
|
|
.po 1.i
|
|
|
|
|
.nr dV .5v
|
|
|
|
|
..
|
|
|
|
|
.ds <= \(<=
|
|
|
|
|
.ds >= \(>=
|
|
|
|
|
.ds Lq \&``
|
|
|
|
|
.ds Rq \&''
|
|
|
|
|
.ds ua \(ua
|
|
|
|
|
.ds aa \(aa
|
|
|
|
|
.ds ga \(ga
|
|
|
|
|
.ds sR \&'
|
|
|
|
|
.ds sL \&`
|
|
|
|
|
.ds q \&"
|
|
|
|
|
.\" Math stuff
|
|
|
|
|
.ds Pi \(*p
|
|
|
|
|
.ds Ne \(!=
|
|
|
|
|
.ds Le \(<=
|
|
|
|
|
.ds Ge \(>=
|
|
|
|
|
.ds Lt <
|
|
|
|
|
.ds Gt >
|
|
|
|
|
.ds Pm \(+-
|
|
|
|
|
.ds If \(if
|
|
|
|
|
.ds Na \fINaN\fP
|
|
|
|
|
.ds Ba \fR\&|\fP
|
|
|
|
|
.\"
|
|
|
|
|
.nr gX 0
|
|
|
|
|
.de hK
|
|
|
|
|
.ds hT \\*(dT
|
|
|
|
|
.if !"\\*(cH"Null" \{\
|
|
|
|
|
. ie !"\\*(gP"Null" .as hT \|(\|\\*(cH\\*(gP\|)
|
|
|
|
|
. el .as hT \\|(\\|\\*(cH\\|)
|
|
|
|
|
.\}
|
|
|
|
|
.if "\\*(cH"Null" \{\
|
|
|
|
|
. if !"\\*(gP"Null" .as hT \&\|(\|\\*(gP\|)
|
|
|
|
|
.\}
|
|
|
|
|
.wh 0 hM
|
|
|
|
|
.wh -1.25i fM
|
|
|
|
|
.\" .tm Here is gX == \\n(gX
|
|
|
|
|
.ie \\n(gX==1 \{\
|
|
|
|
|
. rm n1
|
|
|
|
|
. if \\n(.g .br
|
|
|
|
|
. if !\\n(.g .bp
|
|
|
|
|
.\}
|
|
|
|
|
.el \{\
|
|
|
|
|
. if \\n(.g .br
|
|
|
|
|
. if !\\n(.g 'bp
|
|
|
|
|
.\}
|
|
|
|
|
.nr % 1
|
|
|
|
|
.nr gX 0
|
|
|
|
|
.em lM
|
|
|
|
|
..
|
|
|
|
|
.\"
|
|
|
|
|
.nr fW \w\fC0
|
|
|
|
|
.de sW
|
|
|
|
|
.nr sW \w\fC\\$1
|
|
|
|
|
.ie \\n(sW>=\\n(fW \{\
|
|
|
|
|
. ie \\n(sW%\\n(fW .nr sW (\\n(sW/\\n(fW)+1
|
|
|
|
|
. el .nr sW \\n(sW/\\n(fW
|
|
|
|
|
.\}
|
|
|
|
|
.el \{\
|
|
|
|
|
. ie \\n(sW>0 .nr sW 1
|
|
|
|
|
. el .nr sW 0
|
|
|
|
|
.\}
|
|
|
|
|
..
|
|
|
|
|
.\"
|
|
|
|
|
.de aW
|
|
|
|
|
.nr sW \w\fC\\*(A\\$1
|
|
|
|
|
.ie \\n(sW>=\\n(fW \{\
|
|
|
|
|
. ie \\n(sW%\\n(fW .nr sW (\\n(sW/\\n(fW)+1
|
|
|
|
|
. el .nr sW \\n(sW/\\n(fW
|
|
|
|
|
.\}
|
|
|
|
|
.el \{\
|
|
|
|
|
. ie \\n(sW>0 .nr sW 1
|
|
|
|
|
. el .nr sW 0
|
|
|
|
|
.\}
|
|
|
|
|
..
|
|
|
|
|
.\" NS Ql macro - Quoted literal define
|
|
|
|
|
.de Ql
|
|
|
|
|
.if \\n(aC==0 \{\
|
|
|
|
|
. ds mN Ql
|
|
|
|
|
. ds A1 \\$1
|
|
|
|
|
. ds A2 \\$2
|
|
|
|
|
. ds A3 \\$3
|
|
|
|
|
. ds A4 \\$4
|
|
|
|
|
. ds A5 \\$5
|
|
|
|
|
. ds A6 \\$6
|
|
|
|
|
. ds A7 \\$7
|
|
|
|
|
. ds A8 \\$8
|
|
|
|
|
. nr fV \\n(.$
|
|
|
|
|
. fV
|
|
|
|
|
.\}
|
|
|
|
|
.nr aP \\n(aP+1
|
|
|
|
|
.aW \\n(aP
|
|
|
|
|
.nr aP \\n(aP-1
|
|
|
|
|
.if \\n(sW>2 .Li
|
|
|
|
|
.if \\n(sW<=2 \{\
|
|
|
|
|
.\" Db on
|
|
|
|
|
. if (\\n(aP>0) \{\
|
|
|
|
|
. ds A\\n(aP Li
|
|
|
|
|
. nr aP \\n(aP -1
|
1997-07-02 06:55:38 +04:00
|
|
|
|
. \}
|
1993-03-21 12:45:37 +03:00
|
|
|
|
. if (\\n(aP==0) \{\
|
|
|
|
|
. rm C0 C1 C2 C3 C4 C5 C6 C7 C8 C9
|
|
|
|
|
. rm S1 S2 S3 S4 S5 S6 S7 S8 S9
|
|
|
|
|
. rn A8 A9
|
|
|
|
|
. rn A7 A8
|
|
|
|
|
. rn A6 A7
|
|
|
|
|
. rn A5 A6
|
|
|
|
|
. rn A4 A5
|
|
|
|
|
. rn A3 A4
|
|
|
|
|
. rn A2 A3
|
|
|
|
|
. rn A1 A2
|
|
|
|
|
. ds A1 Li
|
|
|
|
|
. nr fV \\n(aC+1
|
|
|
|
|
. nr aC 0
|
|
|
|
|
. fV
|
|
|
|
|
. \}
|
|
|
|
|
. ds qL \&\\*(sL
|
|
|
|
|
. ds qR \&\\*(sR
|
|
|
|
|
. En
|
|
|
|
|
.\" Db off
|
|
|
|
|
.\}
|
|
|
|
|
..
|
|
|
|
|
.\" NS Sh macro - Section Headers
|
|
|
|
|
.\" NS nS register - Section Header SYNOPSIS flag
|
|
|
|
|
.\" NS nF register - Section Header FILES flag
|
|
|
|
|
.\" NS nA register - Section Header SEE ALSO flag
|
|
|
|
|
.\" NS nT register - Section Header STANDARDS flag
|
|
|
|
|
.de Sh
|
|
|
|
|
.nr nS 0
|
|
|
|
|
.nr sE 0
|
|
|
|
|
.nr iS 0
|
|
|
|
|
'ad
|
|
|
|
|
.ie "\\$1"NAME" \{\
|
|
|
|
|
. hK
|
|
|
|
|
' in 0
|
|
|
|
|
.\}
|
|
|
|
|
.el \{\
|
|
|
|
|
. nr nS 0
|
|
|
|
|
. nr nA 0
|
|
|
|
|
. nr nF 0
|
|
|
|
|
. nr nT 0
|
|
|
|
|
. nr nY 0
|
|
|
|
|
. nr oT 0
|
|
|
|
|
. if "\\$1"SYNOPSIS" \{\
|
|
|
|
|
. na
|
|
|
|
|
. nr nS 1
|
|
|
|
|
. \}
|
|
|
|
|
. if "\\$1"DESCRIPTION" \{\
|
|
|
|
|
. nr fY 0
|
|
|
|
|
. nr fZ 0
|
|
|
|
|
. nr fB 0
|
|
|
|
|
. nr Fb 0
|
|
|
|
|
. ds Fb
|
|
|
|
|
. \}
|
|
|
|
|
. if "\\$1"SEE" \{\
|
|
|
|
|
. nr nA 1
|
|
|
|
|
. na
|
|
|
|
|
. \}
|
|
|
|
|
. if "\\$1"FILES" .nr nF 1
|
|
|
|
|
. if "\\$1"STANDARDS" .nr nT 1
|
|
|
|
|
. if "\\$1"AUTHORS" .nr nY 1
|
|
|
|
|
. if "\\$1"SEE" .nr sE 1
|
|
|
|
|
. in 0
|
|
|
|
|
. nr aN 0
|
|
|
|
|
.\}
|
|
|
|
|
.pL
|
|
|
|
|
'sp
|
|
|
|
|
.ns
|
|
|
|
|
.ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
|
|
|
|
|
.if !\\n(cR .ne 3
|
|
|
|
|
'fi
|
|
|
|
|
\&\\*(sH\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6 \|\\$7 \|\\$8 \|\\$9
|
|
|
|
|
\&\fP\s0\&
|
|
|
|
|
.in \\n(.iu+\\n(Tiu
|
|
|
|
|
.ns
|
|
|
|
|
..
|