summaryrefslogtreecommitdiff
path: root/lib/libc
diff options
context:
space:
mode:
authorwiz <wiz@NetBSD.org>2002-10-01 17:22:00 +0000
committerwiz <wiz@NetBSD.org>2002-10-01 17:22:00 +0000
commit6569c5c50996a3ffc19fc4b63fa6d74cd573f4f3 (patch)
treeb640f9cbe5bf5ee4b28d53fc73216174300f972e /lib/libc
parent45dfd29508988be493867313533f1d1c7652a81b (diff)
New sentence, new line. From Robert Elz.
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/rpc/getnetpath.38
-rw-r--r--lib/libc/rpc/getrpcent.35
-rw-r--r--lib/libc/rpc/getrpcport.35
-rw-r--r--lib/libc/rpc/rpc_clnt_create.38
-rw-r--r--lib/libc/rpc/rpc_soc.3179
-rw-r--r--lib/libc/rpc/rpc_svc_calls.312
-rw-r--r--lib/libc/rpc/rpc_svc_create.314
-rw-r--r--lib/libc/rpc/rpc_svc_reg.35
-rw-r--r--lib/libc/rpc/rpc_xdr.35
-rw-r--r--lib/libc/rpc/rpcbind.35
-rw-r--r--lib/libc/rpc/xdr.389
-rw-r--r--lib/libc/stdio/fopen.35
-rw-r--r--lib/libc/stdio/mktemp.36
-rw-r--r--lib/libc/stdio/printf.322
-rw-r--r--lib/libc/stdio/putc.35
-rw-r--r--lib/libc/stdio/putwc.35
-rw-r--r--lib/libc/stdio/scanf.36
-rw-r--r--lib/libc/stdio/stdio.325
-rw-r--r--lib/libc/stdlib/a64l.37
-rw-r--r--lib/libc/stdlib/exit.35
-rw-r--r--lib/libc/stdlib/getopt_long.356
-rw-r--r--lib/libc/stdlib/hcreate.318
-rw-r--r--lib/libc/stdlib/malloc.324
-rw-r--r--lib/libc/stdlib/random.38
-rw-r--r--lib/libc/stdlib/tsearch.38
-rw-r--r--lib/libc/string/memcpy.35
-rw-r--r--lib/libc/string/strmode.311
27 files changed, 302 insertions, 249 deletions
diff --git a/lib/libc/rpc/getnetpath.3 b/lib/libc/rpc/getnetpath.3
index badd382ed9e..4916cf0f5a7 100644
--- a/lib/libc/rpc/getnetpath.3
+++ b/lib/libc/rpc/getnetpath.3
@@ -1,5 +1,5 @@
.\" @(#)getnetpath.3n 1.26 93/05/07 SMI; from SVr4
-.\" $NetBSD: getnetpath.3,v 1.3 2002/02/07 07:00:23 ross Exp $
+.\" $NetBSD: getnetpath.3,v 1.4 2002/10/01 17:22:00 wiz Exp $
.\" Copyright 1989 AT&T
.Dd April 22, 2000
.Dt GETNETPATH 3
@@ -59,7 +59,8 @@ NETPATH.
.Fn setnetpath
must be called before the first call to
.Fn getnetpath
-and may be called at any other time. It returns a handle that is used by
+and may be called at any other time.
+It returns a handle that is used by
.Fn getnetpath .
.Pp
.Fn getnetpath
@@ -113,7 +114,8 @@ See
When first called,
.Fn getnetpath
returns a pointer to the netconfig database entry corresponding to the first
-valid NETPATH component. When NETPATH has been exhausted,
+valid NETPATH component.
+When NETPATH has been exhausted,
.Fn getnetpath
returns NULL.
.Sh SEE ALSO
diff --git a/lib/libc/rpc/getrpcent.3 b/lib/libc/rpc/getrpcent.3
index 50c2294aa61..4b1f69de77e 100644
--- a/lib/libc/rpc/getrpcent.3
+++ b/lib/libc/rpc/getrpcent.3
@@ -1,5 +1,5 @@
.\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
-.\" $NetBSD: getrpcent.3,v 1.9 2002/02/07 07:00:23 ross Exp $
+.\" $NetBSD: getrpcent.3,v 1.10 2002/10/01 17:22:01 wiz Exp $
.\"
.Dd December 14, 1987
.Dt GETRPCENT 3
@@ -57,7 +57,8 @@ The rpc program number for this service.
reads the next line of the file, opening the file if necessary.
.Pp
.Fn setrpcent
-opens and rewinds the file. If the
+opens and rewinds the file.
+If the
.Fa stayopen
flag is non-zero,
the net data base will not be closed after each call to
diff --git a/lib/libc/rpc/getrpcport.3 b/lib/libc/rpc/getrpcport.3
index db3160b8002..65d96d2a395 100644
--- a/lib/libc/rpc/getrpcport.3
+++ b/lib/libc/rpc/getrpcport.3
@@ -1,5 +1,5 @@
.\" @(#)getrpcport.3r 2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
-.\" $NetBSD: getrpcport.3,v 1.3 1998/02/05 18:49:08 perry Exp $
+.\" $NetBSD: getrpcport.3,v 1.4 2002/10/01 17:22:01 wiz Exp $
.\"
.Dd October 6, 1987
.Dt GETRPCPORT 3
@@ -24,7 +24,8 @@ and using protocol
.Fa proto .
It returns 0 if it cannot contact the portmapper, or if
.Fa prognum
-is not registered. If
+is not registered.
+If
.Fa prognum
is registered but not with version
.Fa versnum ,
diff --git a/lib/libc/rpc/rpc_clnt_create.3 b/lib/libc/rpc/rpc_clnt_create.3
index 82b5e6f36ec..23e2b0685ae 100644
--- a/lib/libc/rpc/rpc_clnt_create.3
+++ b/lib/libc/rpc/rpc_clnt_create.3
@@ -2,7 +2,7 @@
.\" Copyright 1989 AT&T
.\" @(#)rpc_clnt_create 1.5 89/07/24 SMI;
.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
-.\" $NetBSD: rpc_clnt_create.3,v 1.5 2002/02/07 07:00:23 ross Exp $
+.\" $NetBSD: rpc_clnt_create.3,v 1.6 2002/10/01 17:22:01 wiz Exp $
.Dd May 7, 1993
.Dt RPC_CLNT_CREATE 3
.Os
@@ -324,7 +324,8 @@ If
is
.Dv NULL
and it is connection-oriented, it is assumed that the file descriptor
-is connected. For connectionless transports, if
+is connected.
+For connectionless transports, if
.Fa svcaddr
is
..Dv NULL ,
@@ -431,7 +432,8 @@ does not consult the remote rpcbind service for this information.
.It struct rpc_createerr rpc_createerr;
A global variable whose value is set by any RPC
client handle creation routine
-that fails. It is used by the routine
+that fails.
+It is used by the routine
.Fn clnt_pcreateerror
to print the reason for the failure.
.El
diff --git a/lib/libc/rpc/rpc_soc.3 b/lib/libc/rpc/rpc_soc.3
index 538d0c9a1a8..bf621ea04b3 100644
--- a/lib/libc/rpc/rpc_soc.3
+++ b/lib/libc/rpc/rpc_soc.3
@@ -1,5 +1,5 @@
.\" @(#)rpc.3n 2.4 88/08/08 4.0 RPCSRC; from 1.19 88/06/24 SMI
-.\" $NetBSD: rpc_soc.3,v 1.5 2002/07/31 01:46:02 soren Exp $
+.\" $NetBSD: rpc_soc.3,v 1.6 2002/10/01 17:22:01 wiz Exp $
.\"
.TH RPC_SOC 3 "16 February 1988"
.SH NAME
@@ -106,8 +106,8 @@ auth_destroy(auth)
.IP
A macro that destroys the authentication information associated with
.IR auth .
-Destruction usually involves deallocation of private data
-structures. The use of
+Destruction usually involves deallocation of private data structures.
+The use of
.I auth
is undefined after calling
.BR auth_destroy(\|) .
@@ -125,8 +125,8 @@ authnone_create(\|)
Create and returns an
.SM RPC
authentication handle that passes nonusable authentication
-information with each remote procedure call. This is the
-default authentication used by
+information with each remote procedure call.
+This is the default authentication used by
.SM RPC.
.if t .ne 10
.LP
@@ -237,8 +237,8 @@ resultproc_t eachresult;
Like
.BR callrpc(\|) ,
except the call message is broadcast to all locally
-connected broadcast nets. Each time it receives a
-response, this routine calls
+connected broadcast nets.
+Each time it receives a response, this routine calls
.BR eachresult(\|) ,
whose form is:
.IP
@@ -269,8 +269,8 @@ waits for more replies; otherwise it returns with appropriate
status.
.IP
Warning: broadcast sockets are limited in size to the
-maximum transfer unit of the data link. For ethernet,
-this value is 1500 bytes.
+maximum transfer unit of the data link.
+For ethernet, this value is 1500 bytes.
.br
.if t .ne 13
.LP
@@ -320,10 +320,12 @@ clnt_destroy(clnt)
.IP
A macro that destroys the client's
.SM RPC
-handle. Destruction usually involves deallocation
+handle.
+Destruction usually involves deallocation
of private data structures, including
.I clnt
-itself. Use of
+itself.
+Use of
.I clnt
is undefined after calling
.BR clnt_destroy(\|) .
@@ -350,15 +352,16 @@ Generic client creation routine.
identifies the name of the remote host where the server
is located.
.I proto
-indicates which kind of transport protocol to use. The
-currently supported values for this field are \(lqudp\(rq
+indicates which kind of transport protocol to use.
+The currently supported values for this field are \(lqudp\(rq
and \(lqtcp\(rq.
Default timeouts are set, but can be modified using
.BR clnt_control(\|) .
.IP
Warning: Using
.SM UDP
-has its shortcomings. Since
+has its shortcomings.
+Since
.SM UDP\s0-based
.SM RPC
messages can only hold up to 8 Kbytes of encoded data,
@@ -382,7 +385,8 @@ about a client object.
.I req
indicates the type of operation, and
.I info
-is a pointer to the information. For both
+is a pointer to the information.
+For both
.SM UDP
and
.SM TCP\s0,
@@ -439,8 +443,8 @@ A macro that frees any data allocated by the
.SM RPC/XDR
system when it decoded the results of an
.SM RPC
-call. The
-parameter
+call.
+The parameter
.I out
is the address of the results, and
.I outproc
@@ -648,7 +652,8 @@ This allows simulation of
and acquisition of
.SM RPC
overheads, such as round trip times, without any
-kernel interference. This routine returns
+kernel interference.
+This routine returns
.SM NULL
if it fails.
.br
@@ -674,8 +679,8 @@ version
.IR versnum ;
the client uses
.SM TCP/IP
-as a transport. The remote program is located at Internet
-address
+as a transport.
+The remote program is located at Internet address
.IR *addr .
If
.\"The following in-line font conversion is necessary for the hyphen indicator
@@ -683,7 +688,8 @@ If
is zero, then it is set to the actual port that the remote
program is listening on (the remote
.B portmap
-service is consulted for this information). The parameter
+service is consulted for this information).
+The parameter
.I sockp
is a socket; if it is
.BR \s-1RPC_ANYSOCK\s0 ,
@@ -726,15 +732,16 @@ version
.IR versnum ;
the client uses use
.SM UDP/IP
-as a transport. The remote program is located at Internet
-address
+as a transport.
+The remote program is located at Internet address
.IR addr .
If
\fB\%addr\-\*[Gt]sin_port\fR
is zero, then it is set to actual port that the remote
program is listening on (the remote
.B portmap
-service is consulted for this information). The parameter
+service is consulted for this information).
+The parameter
.I sockp
is a socket; if it is
.BR \s-1RPC_ANYSOCK\s0 ,
@@ -744,8 +751,7 @@ The
.SM UDP
transport resends the call message in intervals of
.B wait
-time until a response is received or until the call times
-out.
+time until a response is received or until the call times out.
The total time for the call to time out is specified by
.BR clnt_call(\|) .
.IP
@@ -780,15 +786,16 @@ on
.IR versnum ;
the client uses use
.SM UDP/IP
-as a transport. The remote program is located at Internet
-address
+as a transport.
+The remote program is located at Internet address
.IR addr .
If
\fB\%addr\-\*[Gt]sin_port\fR
is zero, then it is set to actual port that the remote
program is listening on (the remote
.B portmap
-service is consulted for this information). The parameter
+service is consulted for this information).
+The parameter
.I sockp
is a socket; if it is
.BR \s-1RPC_ANYSOCK\s0 ,
@@ -798,8 +805,7 @@ The
.SM UDP
transport resends the call message in intervals of
.B wait
-time until a response is received or until the call times
-out.
+time until a response is received or until the call times out.
The total time for the call to time out is specified by
.BR clnt_call(\|) .
.IP
@@ -885,12 +891,12 @@ is most likely
or
.BR \s-1IPPROTO_TCP\s0 .
A return value of zero means that the mapping does not exist
-or that
-the
+or that the
.SM RPC
system failured to contact the remote
.B portmap
-service. In the latter case, the global variable
+service.
+In the latter case, the global variable
.B rpc_createerr(\|)
contains the
.SM RPC
@@ -926,14 +932,12 @@ call on your behalf to a procedure on that host.
The parameter
.I *portp
will be modified to the program's port number if the
-procedure
-succeeds. The definitions of other parameters are discussed
-in
+procedure succeeds.
+The definitions of other parameters are discussed in
.B callrpc(\|)
and
.BR clnt_call(\|) .
-This procedure should be used for a \(lqping\(rq and nothing
-else.
+This procedure should be used for a \(lqping\(rq and nothing else.
See also
.BR clnt_broadcast(\|) .
.br
@@ -956,7 +960,8 @@ and
.I port
on the machine's
.B portmap
-service. The value of
+service.
+The value of
.I protocol
is most likely
.B
@@ -985,8 +990,8 @@ and
.B ports
on the machine's
.B portmap
-service. This routine returns one if it succeeds, zero
-otherwise.
+service.
+This routine returns one if it succeeds, zero otherwise.
.br
.if t .ne 15
.LP
@@ -1004,7 +1009,8 @@ Register procedure
.I procname
with the
.SM RPC
-service package. If a request arrives for program
+service package.
+If a request arrives for program
.IR prognum ,
version
.IR versnum ,
@@ -1039,8 +1045,8 @@ struct rpc_createerr rpc_createerr;
.IP
A global variable whose value is set by any
.SM RPC
-client creation routine
-that does not succeed. Use the routine
+client creation routine that does not succeed.
+Use the routine
.B clnt_pcreateerror(\|)
to print the reason why.
.if t .ne 7
@@ -1061,7 +1067,8 @@ service transport handle,
Destruction usually involves deallocation
of private data structures, including
.I xprt
-itself. Use of
+itself.
+Use of
.I xprt
is undefined after calling this routine.
.br
@@ -1080,7 +1087,8 @@ service side's
read file descriptor bit mask; it is suitable as a parameter
to the
.B select
-system call. This is only of interest
+system call.
+This is only of interest
if a service implementor does not call
.BR svc_run(\|) ,
but rather does his own asynchronous event processing.
@@ -1101,8 +1109,8 @@ int svc_fds;
.IP
Similar to
.BR svc_fedset(\|) ,
-but limited to 32 descriptors. This
-interface is obsoleted by
+but limited to 32 descriptors.
+This interface is obsoleted by
.BR svc_fdset(\|) .
.br
.if t .ne 9
@@ -1119,11 +1127,9 @@ char *in;
.IP
A macro that frees any data allocated by the
.SM RPC/XDR
-system when it decoded the arguments to a service procedure
-using
+system when it decoded the arguments to a service procedure using
.BR svc_getargs(\|) .
-This routine returns 1 if the results were successfully
-freed,
+This routine returns 1 if the results were successfully freed,
and zero otherwise.
.br
.if t .ne 10
@@ -1140,8 +1146,7 @@ char *in;
.IP
A macro that decodes the arguments of an
.SM RPC
-request
-associated with the
+request associated with the
.SM RPC
service transport handle,
.IR xprt .
@@ -1152,8 +1157,7 @@ is the address where the arguments will be placed;
is the
.SM XDR
routine used to decode the arguments.
-This routine returns one if decoding succeeds, and zero
-otherwise.
+This routine returns one if decoding succeeds, and zero otherwise.
.br
.if t .ne 9
.LP
@@ -1212,7 +1216,8 @@ int rdfds;
.IP
Similar to
.BR svc_getreqset(\|) ,
-but limited to 32 descriptors. This interface is obsoleted by
+but limited to 32 descriptors.
+This interface is obsoleted by
.BR svc_getreqset(\|) .
.br
.if t .ne 17
@@ -1238,7 +1243,8 @@ If
.I protocol
is zero, the service is not registered with the
.B portmap
-service. If
+service.
+If
.I protocol
is non-zero, then a mapping of the triple
.RI [ prognum , versnum , protocol\fR]
@@ -1281,12 +1287,14 @@ svc_run(\|)
.fi
.ft R
.IP
-This routine never returns. It waits for
+This routine never returns.
+It waits for
.SM RPC
requests to arrive, and calls the appropriate service
procedure using
.B svc_getreq(\|)
-when one arrives. This procedure is usually waiting for a
+when one arrives.
+This procedure is usually waiting for a
.B select(\|)
system call to return.
.br
@@ -1305,7 +1313,8 @@ char *out;
Called by an
.SM RPC
service's dispatch routine to send the results of a
-remote procedure call. The parameter
+remote procedure call.
+The parameter
.I xprt
is the request's associated transport handle;
.I outproc
@@ -1360,7 +1369,8 @@ svcerr_decode(xprt)
.ft R
.IP
Called by a service dispatch routine that cannot successfully
-decode its parameters. See also
+decode its parameters.
+See also
.BR svc_getargs(\|) .
.br
.if t .ne 7
@@ -1390,7 +1400,8 @@ svcerr_noprog(xprt)
.IP
Called when the desired program is not registered with the
.SM RPC
-package. Service implementors usually do not need this routine.
+package.
+Service implementors usually do not need this routine.
.br
.if t .ne 7
.LP
@@ -1406,7 +1417,8 @@ svcerr_progvers(xprt)
Called when the desired version of a program is not registered
with the
.SM RPC
-package. Service implementors usually do not need this routine.
+package.
+Service implementors usually do not need this routine.
.br
.if t .ne 7
.LP
@@ -1438,7 +1450,8 @@ svcerr_weakauth(xprt)
.IP
Called by a service dispatch routine that refuses to perform
a remote procedure call due to insufficient
-authentication parameters. The routine calls
+authentication parameters.
+The routine calls
.BR "svcerr_auth(xprt, \s-1AUTH_TOOWEAK\s0)" .
.br
.if t .ne 11
@@ -1453,9 +1466,8 @@ svcraw_create(\|)
.IP
This routine creates a toy
.SM RPC
-service transport, to which it returns a pointer. The
-transport
-is really a buffer within the process's address space,
+service transport, to which it returns a pointer.
+The transport is really a buffer within the process's address space,
so the corresponding
.SM RPC
client should live in the same
@@ -1495,15 +1507,16 @@ which may be
in which case a new socket is created.
If the socket is not bound to a local
.SM TCP
-port, then this routine binds it to an arbitrary port. Upon
-completion,
+port, then this routine binds it to an arbitrary port.
+Upon completion,
\fB\%xprt\-\*[Gt]xp_sock\fR
is the transport's socket descriptor, and
\fB\%xprt\-\*[Gt]xp_port\fR
is the transport's port number.
This routine returns
.SM NULL
-if it fails. Since
+if it fails.
+Since
.SM TCP\s0-based
.SM RPC
uses buffered
@@ -1524,16 +1537,15 @@ u_int recvsize;
.fi
.ft R
.IP
-Create a service on top of any open descriptor. Typically,
-this
-descriptor is a connected socket for a stream protocol such
-as
+Create a service on top of any open descriptor.
+Typically, this descriptor is a connected socket
+for a stream protocol such as
.SM TCP\s0.
.I sendsize
and
.I recvsize
-indicate sizes for the send and receive buffers. If they are
-zero, a reasonable default is chosen.
+indicate sizes for the send and receive buffers.
+If they are zero, a reasonable default is chosen.
.br
.if t .ne 10
.LP
@@ -1557,8 +1569,8 @@ which may be
in which case a new socket is created.
If the socket is not bound to a local
.SM UDP
-port, then this routine binds it to an arbitrary port. Upon
-completion,
+port, then this routine binds it to an arbitrary port.
+Upon completion,
\fB\%xprt\-\*[Gt]xp_sock\fR
is the transport's socket descriptor, and
\fB\%xprt\-\*[Gt]xp_port\fR
@@ -1585,8 +1597,8 @@ struct accepted_reply *ar;
.IP
Used for encoding
.SM RPC
-reply messages. This routine is useful for users who
-wish to generate
+reply messages.
+This routine is useful for users who wish to generate
\s-1RPC\s0-style
messages without using the
.SM RPC
@@ -1605,7 +1617,8 @@ struct authunix_parms *aupp;
.IP
Used for describing
.SM UNIX
-credentials. This routine is useful for users
+credentials.
+This routine is useful for users
who wish to generate these credentials without using the
.SM RPC
authentication package.
diff --git a/lib/libc/rpc/rpc_svc_calls.3 b/lib/libc/rpc/rpc_svc_calls.3
index 177af5ca084..c0f72636197 100644
--- a/lib/libc/rpc/rpc_svc_calls.3
+++ b/lib/libc/rpc/rpc_svc_calls.3
@@ -2,7 +2,7 @@
.\" Copyright 1989 AT&T
.\" @(#)rpc_svc_calls 1.5 89/07/25 SMI;
.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
-.\" $NetBSD: rpc_svc_calls.3,v 1.4 2002/02/07 07:00:23 ross Exp $
+.\" $NetBSD: rpc_svc_calls.3,v 1.5 2002/10/01 17:22:02 wiz Exp $
.Dd May 3, 1993
.Dt RPC_SVC_CALLS 3
.Os
@@ -95,7 +95,8 @@ As currently implemented,
.Fn svc_exit
zeroes the
.Dv svc_fdset
-global variable. If RPC server activity is to be resumed,
+global variable.
+If RPC server activity is to be resumed,
services must be reregistered with the RPC library
either through one of the
.Fn rpc_svc_create
@@ -201,8 +202,8 @@ RPC service transport handle
and thus not portable.
This macro returns a pointer to a sockcred structure, defined in
.Fd \*[Lt]sys/socket.h\*[Gt] ,
-identifying the calling client. This only works if the client is
-calling the server over an
+identifying the calling client.
+This only works if the client is calling the server over an
.Dv AF_LOCAL
socket.
.It Fa struct pollfd svc_pollset[FD_SETSIZE];
@@ -238,7 +239,8 @@ system call to return.
.Pp
.It Fn svc_sendreply
Called by an RPC service's dispatch routine to send the results of a
-remote procedure call. The parameter
+remote procedure call.
+The parameter
.Fa xprt
is the request's associated transport handle;
.Fa outproc
diff --git a/lib/libc/rpc/rpc_svc_create.3 b/lib/libc/rpc/rpc_svc_create.3
index b187f6cb944..2df71ad6e04 100644
--- a/lib/libc/rpc/rpc_svc_create.3
+++ b/lib/libc/rpc/rpc_svc_create.3
@@ -2,7 +2,7 @@
.\" Copyright 1989 AT&T
.\" @(#)rpc_svc_create 1.3 89/06/28 SMI;
.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
-.\" $NetBSD: rpc_svc_create.3,v 1.4 2002/02/07 07:00:24 ross Exp $
+.\" $NetBSD: rpc_svc_create.3,v 1.5 2002/10/01 17:22:02 wiz Exp $
.Dd May 3, 1993
.Dt RPC_SVC_CREATE 3
.Sh NAME
@@ -74,8 +74,8 @@ an
error will normally
be returned.
.Fa info
-should be a pointer to an
-integer. Upon successful completion of the
+should be a pointer to an integer.
+Upon successful completion of the
.Dv SVCGET_VERSQUIET
request,
.Fa *info
@@ -94,9 +94,8 @@ served by this server but the version number
is outside the range registered with the server,
an
.Dv RPC_PROGVERSMISMATCH
-error will normally
-be returned. It is sometimes desirable to
-change this behavior.
+error will normally be returned.
+It is sometimes desirable to change this behavior.
.Fa info
should be a
pointer to an integer which is either 0
@@ -154,7 +153,8 @@ Destruction usually involves deallocation
of private data structures,
including
.Fa xprt
-itself. Use of
+itself.
+Use of
.Fa xprt
is undefined after calling this routine.
.Pp
diff --git a/lib/libc/rpc/rpc_svc_reg.3 b/lib/libc/rpc/rpc_svc_reg.3
index 991c796063f..cf3ea0b06db 100644
--- a/lib/libc/rpc/rpc_svc_reg.3
+++ b/lib/libc/rpc/rpc_svc_reg.3
@@ -2,7 +2,7 @@
.\" Copyright 1989 AT&T
.\" @(#)rpc_svc_call 1.6 89/07/20 SMI;
.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
-.\" $NetBSD: rpc_svc_reg.3,v 1.4 2002/02/07 07:00:24 ross Exp $
+.\" $NetBSD: rpc_svc_reg.3,v 1.5 2002/10/01 17:22:02 wiz Exp $
.Dd May 3, 1993
.Dt RPC_SVC_REG 3
.Sh NAME
@@ -167,7 +167,8 @@ and -1 otherwise.
After RPC service transport handle
.Fa xprt
is created, it is registered with the RPC
-service package. This routine modifies the global variable
+service package.
+This routine modifies the global variable
.Va svc_fdset
(see
.Xr rpc_svc_calls 3 ) .
diff --git a/lib/libc/rpc/rpc_xdr.3 b/lib/libc/rpc/rpc_xdr.3
index ef41e7d2253..68b8c0487b2 100644
--- a/lib/libc/rpc/rpc_xdr.3
+++ b/lib/libc/rpc/rpc_xdr.3
@@ -2,7 +2,7 @@
.\" Copyright 1989 AT&T
.\" @(#)rpc_xdr.new 1.1 89/04/06 SMI;
.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
-.\" $NetBSD: rpc_xdr.3,v 1.4 2002/02/07 07:00:24 ross Exp $
+.\" $NetBSD: rpc_xdr.3,v 1.5 2002/10/01 17:22:02 wiz Exp $
.Dd May 3, 1993
.Dt RPC_XDR 3
.Os
@@ -90,7 +90,8 @@ number mis-match or because of authentication errors.
.Pp
.It Fn xdr_replymsg
Used for describing RPC
-reply messages. It translates between the
+reply messages.
+It translates between the
RPC reply message and its external representation.
This reply could be either an acceptance,
rejection or
diff --git a/lib/libc/rpc/rpcbind.3 b/lib/libc/rpc/rpcbind.3
index d00e753c47c..156669d3120 100644
--- a/lib/libc/rpc/rpcbind.3
+++ b/lib/libc/rpc/rpcbind.3
@@ -1,7 +1,7 @@
.\" @(#)rpcbind.3n 1.25 93/05/07 SMI; from SVr4
.\" Copyright 1989 AT&T
.\" Copyright (c) 1988 Sun Microsystem's, Inc. - All Right's Reserved.
-.\" $NetBSD: rpcbind.3,v 1.5 2002/02/07 07:00:24 ross Exp $
+.\" $NetBSD: rpcbind.3,v 1.6 2002/10/01 17:22:02 wiz Exp $
.Dd May 7, 1993
.Dt RPCBIND 3
.Os
@@ -68,7 +68,8 @@ The address found is returned in
should be preallocated.
This routine returns
.Dv TRUE
-if it succeeds. A return value of
+if it succeeds.
+A return value of
.Dv FALSE
means that the mapping does not exist
or that the RPC
diff --git a/lib/libc/rpc/xdr.3 b/lib/libc/rpc/xdr.3
index 3928eab0d2b..58411cdee9a 100644
--- a/lib/libc/rpc/xdr.3
+++ b/lib/libc/rpc/xdr.3
@@ -1,5 +1,5 @@
.\" @(#)xdr.3n 2.2 88/08/03 4.0 RPCSRC; from 1.16 88/03/14 SMI
-.\" $NetBSD: xdr.3,v 1.6 2001/09/16 02:17:41 wiz Exp $
+.\" $NetBSD: xdr.3,v 1.7 2002/10/01 17:22:03 wiz Exp $
.\"
.TH XDR 3 "16 February 1988"
.SH NAME
@@ -59,9 +59,8 @@ xdrproc_t elproc;
.ft R
.IP
A filter primitive that translates between variable-length
-arrays
-and their corresponding external representations. The
-parameter
+arrays and their corresponding external representations.
+The parameter
.I arrp
is the address of the pointer to the array, while
.I sizep
@@ -77,8 +76,7 @@ each of the array's elements, and
is an
.SM XDR
filter that translates between
-the array elements' C form, and their external
-representation.
+the array elements' C form, and their external representation.
This routine returns one if it succeeds, zero otherwise.
.br
.if t .ne 8
@@ -94,7 +92,8 @@ bool_t *bp;
.IP
A filter primitive that translates between booleans (C
integers)
-and their external representations. When encoding data, this
+and their external representations.
+When encoding data, this
filter produces values of either one or zero.
This routine returns one if it succeeds, zero otherwise.
.br
@@ -114,8 +113,8 @@ A filter primitive that translates between counted byte
strings and their external representations.
The parameter
.I sp
-is the address of the string pointer. The length of the
-string is located at address
+is the address of the string pointer.
+The length of the string is located at address
.IR sizep ;
strings cannot be longer than
.IR maxsize .
@@ -135,9 +134,8 @@ char *cp;
A filter primitive that translates between C characters
and their external representations.
This routine returns one if it succeeds, zero otherwise.
-Note: encoded characters are not packed, and occupy 4 bytes
-each. For arrays of characters, it is worthwhile to
-consider
+Note: encoded characters are not packed, and occupy 4 bytes each.
+For arrays of characters, it is worthwhile to consider
.BR xdr_bytes(\|) ,
.B xdr_opaque(\|)
or
@@ -159,7 +157,8 @@ A macro that invokes the destroy routine associated with the
stream,
.IR xdrs .
Destruction usually involves freeing private data structures
-associated with the stream. Using
+associated with the stream.
+Using
.I xdrs
after invoking
.B xdr_destroy(\|)
@@ -225,11 +224,12 @@ char *objp;
.fi
.ft R
.IP
-Generic freeing routine. The first argument is the
+Generic freeing routine.
+The first argument is the
.SM XDR
-routine for the object being freed. The second argument
-is a pointer to the object itself. Note: the pointer passed
-to this routine is
+routine for the object being freed.
+The second argument is a pointer to the object itself.
+Note: the pointer passed to this routine is
.I not
freed, but what it points to
.I is
@@ -379,7 +379,8 @@ a chunk of memory at location
.I addr
whose length is no more than
.I size
-bytes long. The
+bytes long.
+The
.I op
determines the direction of the
.SM XDR
@@ -431,7 +432,8 @@ execpt that it serializes
.SM NULL
pointers, whereas
.B xdr_reference(\|)
-does not. Thus,
+does not.
+Thus,
.B xdr_pointer(\|)
can represent
recursive data structures, such as binary trees or
@@ -458,17 +460,19 @@ stream object pointed to by
The stream's data is written to a buffer of size
.IR sendsize ;
a value of zero indicates the system should use a suitable
-default. The stream's data is read from a buffer of size
+default.
+The stream's data is read from a buffer of size
.IR recvsize ;
it too can be set to a suitable default by passing a zero
value.
When a stream's output buffer is full,
.I writeit
-is called. Similarly, when a stream's input buffer is empty,
+is called.
+Similarly, when a stream's input buffer is empty,
.I readit
-is called. The behavior of these two routines is similar to
-the
-system calls
+is called.
+The behavior of these two routines is similar to
+the system calls
.B read
and
.BR write ,
@@ -505,8 +509,8 @@ The data in the output buffer is marked as a completed
record,
and the output buffer is optionally written out if
.I sendnow
-is non-zero. This routine returns one if it succeeds, zero
-otherwise.
+is non-zero.
+This routine returns one if it succeeds, zero otherwise.
.br
.if t .ne 8
.LP
@@ -519,8 +523,7 @@ int empty;
.fi
.ft R
.IP
-This routine can be invoked only on
-streams created by
+This routine can be invoked only on streams created by
.BR xdrrec_create(\|) .
After consuming the rest of the current record in the stream,
this routine returns one if the stream has no more input,
@@ -536,8 +539,7 @@ xdrrec_skiprecord(xdrs)
.fi
.ft R
.IP
-This routine can be invoked only on
-streams created by
+This routine can be invoked only on streams created by
.BR xdrrec_create(\|) .
It tells the
.SM XDR
@@ -577,7 +579,8 @@ This routine returns one if it succeeds, zero otherwise.
.IP
Warning: this routine does not understand
.SM NULL
-pointers. Use
+pointers.
+Use
.B xdr_pointer(\|)
instead.
.br
@@ -683,8 +686,7 @@ u_int maxsize;
.ft R
.IP
A filter primitive that translates between C strings and
-their
-corresponding external representations.
+their corresponding external representations.
Strings cannot be longer than
.IR maxsize .
Note:
@@ -802,24 +804,27 @@ bool_t (*defaultarm) (\|); /* may equal \s-1NULL\s0 */
.IP
A filter primitive that translates between a discriminated C
.B union
-and its corresponding external representation. It first
-translates the discriminant of the union located at
+and its corresponding external representation.
+It first translates the discriminant of the union located at
.IR dscmp .
This discriminant is always an
.BR enum_t .
Next the union located at
.I unp
-is translated. The parameter
+is translated.
+The parameter
.I choices
is a pointer to an array of
.B xdr_discrim(\|)
-structures. Each structure contains an ordered pair of
+structures.
+Each structure contains an ordered pair of
.RI [ value , proc ].
If the union's discriminant is equal to the associated
.IR value ,
then the
.I proc
-is called to translate the union. The end of the
+is called to translate the union.
+The end of the
.B xdr_discrim(\|)
structure array is denoted by a routine of value
.SM NULL\s0.
@@ -845,13 +850,13 @@ xdrproc_t elproc;
.ft R
.IP
A filter primitive that translates between fixed-length
-arrays
-and their corresponding external representations. The
-parameter
+arrays and their corresponding external representations.
+The parameter
.I arrp
is the address of the pointer to the array, while
.I size
-is the element count of the array. The parameter
+is the element count of the array.
+The parameter
.I elsize
is the
.I sizeof
diff --git a/lib/libc/stdio/fopen.3 b/lib/libc/stdio/fopen.3
index dcb9bf88fb8..31bcd5cdb5b 100644
--- a/lib/libc/stdio/fopen.3
+++ b/lib/libc/stdio/fopen.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: fopen.3,v 1.17 2002/07/10 14:37:16 yamt Exp $
+.\" $NetBSD: fopen.3,v 1.18 2002/10/01 17:24:05 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -97,7 +97,8 @@ and has no effect; the ``b'' is ignored.
The letter ``f'' in the mode string restricts fopen to regular
files; if the file opened is not a regular file,
.Fn fopen
-will fail. This is a non
+will fail.
+This is a non
.St -ansiC
extension.
.Pp
diff --git a/lib/libc/stdio/mktemp.3 b/lib/libc/stdio/mktemp.3
index 400f29e26ec..b86e1d7b1ca 100644
--- a/lib/libc/stdio/mktemp.3
+++ b/lib/libc/stdio/mktemp.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: mktemp.3,v 1.16 2002/08/10 09:32:19 yamt Exp $
+.\" $NetBSD: mktemp.3,v 1.17 2002/10/01 17:24:05 wiz Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -101,8 +101,8 @@ but it creates a mode 0700 directory instead and returns the path.
Please note that the permissions of the file or directory being created are
subject to the restrictions imposed by the
.Xr umask 2
-system call. It may thus happen that the created file is unreadable and/or
-unwritable.
+system call.
+It may thus happen that the created file is unreadable and/or unwritable.
.Sh RETURN VALUES
The
.Fn mktemp
diff --git a/lib/libc/stdio/printf.3 b/lib/libc/stdio/printf.3
index 567b41e7792..2b483d4b233 100644
--- a/lib/libc/stdio/printf.3
+++ b/lib/libc/stdio/printf.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: printf.3,v 1.26 2002/07/10 14:37:16 yamt Exp $
+.\" $NetBSD: printf.3,v 1.27 2002/10/01 17:24:06 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -286,14 +286,13 @@ overrides a space if both are used.
An optional decimal digit string specifying a minimum field width.
If the converted value has fewer characters than the field width, it will
be padded with spaces on the left (or right, if the left-adjustment
-flag has been given) to fill out
-the field width.
+flag has been given) to fill out the field width.
.It
An optional precision, in the form of a period
.Sq Cm \&.
-followed by an
-optional digit string. If the digit string is omitted, the precision
-is taken as zero. This gives the minimum number of digits to appear for
+followed by an optional digit string.
+If the digit string is omitted, the precision is taken as zero.
+This gives the minimum number of digits to appear for
.Cm d ,
.Cm i ,
.Cm o ,
@@ -460,8 +459,7 @@ A character that specifies the type of conversion to be applied.
A field width or precision, or both, may be indicated by
an asterisk
.Ql *
-instead of a
-digit string.
+instead of a digit string.
In this case, an
.Em int
argument supplies the field width or precision.
@@ -486,7 +484,8 @@ or unsigned hexadecimal
.Pf ( Cm x
and
.Cm X )
-notation. The letters
+notation.
+The letters
.Cm abcdef
are used for
.Cm x
@@ -632,8 +631,9 @@ No argument is converted.
.It Cm %
A
.Ql %
-is written. No argument is converted. The complete conversion specification
-is
+is written.
+No argument is converted.
+The complete conversion specification is
.Ql %% .
.El
.Pp
diff --git a/lib/libc/stdio/putc.3 b/lib/libc/stdio/putc.3
index f3bfcd52f6a..212930121ec 100644
--- a/lib/libc/stdio/putc.3
+++ b/lib/libc/stdio/putc.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: putc.3,v 1.7 2002/02/07 07:00:26 ross Exp $
+.\" $NetBSD: putc.3,v 1.8 2002/10/01 17:24:06 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -77,7 +77,8 @@ to the output stream pointed to by
.Fn putc
acts essentially identically to
.Fn fputc ,
-but is a macro that expands in-line. It may evaluate
+but is a macro that expands in-line.
+It may evaluate
.Fa stream
more than once, so arguments given to
.Fn putc
diff --git a/lib/libc/stdio/putwc.3 b/lib/libc/stdio/putwc.3
index 99577f9353a..e362dc01106 100644
--- a/lib/libc/stdio/putwc.3
+++ b/lib/libc/stdio/putwc.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: putwc.3,v 1.2 2002/02/07 07:00:26 ross Exp $
+.\" $NetBSD: putwc.3,v 1.3 2002/10/01 17:24:07 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -68,7 +68,8 @@ to the output stream pointed to by
.Fn putwc
acts essentially identically to
.Fn fputwc ,
-but is a macro that expands in-line. It may evaluate
+but is a macro that expands in-line.
+It may evaluate
.Fa stream
more than once, so arguments given to
.Fn putwc
diff --git a/lib/libc/stdio/scanf.3 b/lib/libc/stdio/scanf.3
index f086f9ee82f..d2157a2ef00 100644
--- a/lib/libc/stdio/scanf.3
+++ b/lib/libc/stdio/scanf.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: scanf.3,v 1.14 2002/02/07 07:00:26 ross Exp $
+.\" $NetBSD: scanf.3,v 1.15 2002/10/01 17:24:07 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -399,8 +399,8 @@ conversion.
The value
.Dv EOF
is returned if an input failure occurs before any conversion such as an
-end-of-file occurs. If an error or end-of-file occurs after conversion
-has begun,
+end-of-file occurs.
+If an error or end-of-file occurs after conversion has begun,
the number of conversions which were successfully completed is returned.
.Sh SEE ALSO
.Xr getc 3 ,
diff --git a/lib/libc/stdio/stdio.3 b/lib/libc/stdio/stdio.3
index cc169283adf..c1af481e563 100644
--- a/lib/libc/stdio/stdio.3
+++ b/lib/libc/stdio/stdio.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: stdio.3,v 1.14 2002/02/07 07:00:27 ross Exp $
+.\" $NetBSD: stdio.3,v 1.15 2002/10/01 17:24:08 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -55,22 +55,25 @@ interface.
Input and output is mapped into logical data streams
and the physical
.Tn I/O
-characteristics are concealed. The functions and macros are listed
-below; more information is available from the individual man pages.
+characteristics are concealed.
+The functions and macros are listed below;
+more information is available from the individual man pages.
.Pp
A stream is associated with an external file (which may be a physical
device) by
.Em opening
-a file, which may involve creating a new file. Creating an
-existing file causes its former contents to be discarded.
+a file, which may involve creating a new file.
+Creating an existing file causes its former contents to be discarded.
If a file can support positioning requests (such as a disk file, as opposed
to a terminal) then a
.Em file position indicator
associated with the stream is positioned at the start of the file (byte
-zero), unless the file is opened with append mode. If append mode
+zero), unless the file is opened with append mode.
+If append mode
is used, the position indicator will be placed the end-of-file.
The position indicator is maintained by subsequent reads, writes
-and positioning requests. All input occurs as if the characters
+and positioning requests.
+All input occurs as if the characters
were read by successive calls to the
.Xr fgetc 3
function; all output takes place as if all characters were
@@ -89,12 +92,12 @@ object is indeterminate after a file is closed (garbage).
.Pp
A file may be subsequently reopened, by the same or another program
execution, and its contents reclaimed or modified (if it can be repositioned
-at the start). If the main function returns to its original caller, or
-the
+at the start).
+If the main function returns to its original caller, or the
.Xr exit 3
function is called, all open files are closed (hence all output
-streams are flushed) before program termination. Other methods
-of program termination, such as
+streams are flushed) before program termination.
+Other methods of program termination, such as
.Xr abort 3
do not bother about closing files properly.
.Pp
diff --git a/lib/libc/stdlib/a64l.3 b/lib/libc/stdlib/a64l.3
index a440e87b6ac..0b59293640a 100644
--- a/lib/libc/stdlib/a64l.3
+++ b/lib/libc/stdlib/a64l.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: a64l.3,v 1.6 2002/02/07 07:00:27 ross Exp $
+.\" $NetBSD: a64l.3,v 1.7 2002/10/01 17:29:22 wiz Exp $
.\"
.\" Copyright (c) 1998, 1999 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -128,8 +128,9 @@ Multithreading Extension.
.Sh BUGS
The
.Fn l64a
-function is not reentrant. The value returned by it points into a
-static buffer area; subsequent calls to
+function is not reentrant.
+The value returned by it points into a static buffer area;
+subsequent calls to
.Fn la64a
may overwrite this buffer.
In multi-threaded applications,
diff --git a/lib/libc/stdlib/exit.3 b/lib/libc/stdlib/exit.3
index d77d22fd0fa..2805e0a1866 100644
--- a/lib/libc/stdlib/exit.3
+++ b/lib/libc/stdlib/exit.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: exit.3,v 1.10 2002/08/10 17:10:11 yamt Exp $
+.\" $NetBSD: exit.3,v 1.11 2002/10/01 17:29:22 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -51,7 +51,8 @@
.Fn exit "int status"
.Sh DESCRIPTION
.Fn exit
-terminates a process. The
+terminates a process.
+The
.Fa status
values
.Dv EXIT_SUCCESS
diff --git a/lib/libc/stdlib/getopt_long.3 b/lib/libc/stdlib/getopt_long.3
index a2e08a778c6..c5c3dbfc265 100644
--- a/lib/libc/stdlib/getopt_long.3
+++ b/lib/libc/stdlib/getopt_long.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: getopt_long.3,v 1.8 2002/06/03 12:01:43 wiz Exp $
+.\" $NetBSD: getopt_long.3,v 1.9 2002/10/01 17:29:22 wiz Exp $
.\"
.\" Copyright (c) 1988, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -50,15 +50,17 @@ The
.Fn getopt_long
function is similar to
.Xr getopt 3
-but it accepts options in two forms: words and characters. The
+but it accepts options in two forms: words and characters.
+The
.Fn getopt_long
function provides a superset of of the functionality of
.Xr getopt 3 .
.Fn getopt_long
-can be used in two ways. In the first way, every long option understood
-by the program has a corresponding short option, and the option
-structure is only used to translate from long options to short
-options. When used in this fashion,
+can be used in two ways.
+In the first way, every long option understood by the program has a
+corresponding short option, and the option structure is only used to
+translate from long options to short options.
+When used in this fashion,
.Fn getopt_long
behaves identically to
.Xr getopt 3 .
@@ -70,27 +72,28 @@ In the second mechanism, a long option sets a flag in the
structure passed, or will store a pointer to the command line argument
in the
.Fa option
-structure passed to it for options that take arguments. Additionally,
-the long option's argument may be specified as a single argument with
-an equal sign, e.g.
+structure passed to it for options that take arguments.
+Additionally, the long option's argument may be specified as a single
+argument with an equal sign, e.g.
.Bd -literal
myprogram --myoption=somevalue
.Ed
.Pp
When a long option is processed the call to
.Fn getopt_long
-will return 0. For this reason, long option processing without
+will return 0.
+For this reason, long option processing without
shortcuts is not backwards compatible with
.Xr getopt 3 .
.Pp
It is possible to combine these methods, providing for long options
-processing with short option equivalents for some options. Less
-frequently used options would be processed as long options only.
+processing with short option equivalents for some options.
+Less frequently used options would be processed as long options only.
.Pp
The
.Fn getopt_long
-call requires a structure to be initialized describing the long
-options. The structure is:
+call requires a structure to be initialized describing the long options.
+The structure is:
.Bd -literal
struct option {
char *name;
@@ -121,11 +124,13 @@ If
is non-NULL, then the integer pointed to by it will be set to the
value in the
.Fa val
-field. If the
+field.
+If the
.Fa flag
field is NULL, then the
.Fa val
-field will be returned. Setting
+field will be returned.
+Setting
.Fa flag
to NULL and setting
.Fa val
@@ -209,8 +214,8 @@ handling of --a in getopt:
.It Li GNU
parses this as option '-', option 'a'.
.It Li NetBSD
-parses this as '--', and returns -1 (ignoring the a). (Because
-the original getopt does.)
+parses this as '--', and returns -1 (ignoring the a).
+(Because the original getopt does.)
.El
.It Li o
setting of optopt for long options with flag != NULL:
@@ -248,24 +253,25 @@ long option (W; in option string):
returns -W with optarg set to the unknown option.
.It Li NetBSD
treats this as an error (unknown option) and returns '?' with
-optopt set to 0 and optarg set to NULL (as GNU's man page
-documents).
+optopt set to 0 and optarg set to NULL (as GNU's man page documents).
.El
.It Li o
The error messages are different.
.It Li o
NetBSD does not permute the argument vector at the same points in
-the calling sequence as GNU does. The aspects normally used by
-the caller (ordering after -1 is returned, value of optind relative
-to current positions) are the same, though. (We do fewer variable
-swaps.)
+the calling sequence as GNU does.
+The aspects normally used by the caller
+(ordering after -1 is returned, value of optind relative
+to current positions) are the same, though.
+(We do fewer variable swaps.)
.El
.Sh SEE ALSO
.Xr getopt 3
.Sh HISTORY
The
.Fn getopt_long
-function first appeared in GNU libiberty. The first
+function first appeared in GNU libiberty.
+The first
.Nx
implementation appeared in 1.5.
.Sh BUGS
diff --git a/lib/libc/stdlib/hcreate.3 b/lib/libc/stdlib/hcreate.3
index cca71fd0cb7..ee49f5a9b75 100644
--- a/lib/libc/stdlib/hcreate.3
+++ b/lib/libc/stdlib/hcreate.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: hcreate.3,v 1.4 2002/02/07 07:00:29 ross Exp $
+.\" $NetBSD: hcreate.3,v 1.5 2002/10/01 17:29:23 wiz Exp $
.\"
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -66,8 +66,8 @@ function allocates and initializes the table.
The
.Fa nel
argument specifies an estimate of the maximum number of entries to be held
-by the table. Unless further memory allocation fails, supplying an
-insufficient
+by the table.
+Unless further memory allocation fails, supplying an insufficient
.Fa nel
value will not result in functional harm, although a performance degradation
may occur.
@@ -86,8 +86,10 @@ the data can no longer be accessed.
.Pp
The
.Fn hsearch
-function is used to search to the hash table. It returns a pointer into the
-hash table indicating the address of an item. The
+function is used to search to the hash table.
+It returns a pointer into the
+hash table indicating the address of an item.
+The
.Fa item
argument is of type
.Dv ENTRY ,
@@ -122,7 +124,8 @@ and
.Fa data
elements of
.Fa item
-are used directly by the new table entry. The storage for the
+are used directly by the new table entry.
+The storage for the
key must not be modified during the lifetime of the hash table.
.It Dv FIND
Search the hash table without inserting
@@ -131,7 +134,8 @@ Search the hash table without inserting
.Sh RETURN VALUES
If successful, the
.Fn hcreate
-function returns a non-zero value. Otherwise, a value of 0 is returned and
+function returns a non-zero value.
+Otherwise, a value of 0 is returned and
.Va errno
is set to indicate the error.
.Pp
diff --git a/lib/libc/stdlib/malloc.3 b/lib/libc/stdlib/malloc.3
index 09d8026d324..6631fe635f3 100644
--- a/lib/libc/stdlib/malloc.3
+++ b/lib/libc/stdlib/malloc.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: malloc.3,v 1.17 2002/08/20 16:15:38 wiz Exp $
+.\" $NetBSD: malloc.3,v 1.18 2002/10/01 17:29:23 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -214,8 +214,8 @@ option.
This is intended for debugging and will impact performance negatively.
.It H
Pass a hint to the kernel about pages unused by the allocation functions.
-This will help performance if the system is paging excessively. This
-option is off by default.
+This will help performance if the system is paging excessively.
+This option is off by default.
.It R
Causes the
.Fn realloc
@@ -356,8 +356,8 @@ done by a process.
.Ed
.Pp
A side effect of this architecture is that many minor transgressions on
-the interface which would traditionally not be detected are in fact
-detected. As a result, programs that have been running happily for
+the interface which would traditionally not be detected are in fact detected.
+As a result, programs that have been running happily for
years may suddenly start to complain loudly, when linked with this
allocation implementation.
.Pp
@@ -371,9 +371,9 @@ It is probably also a good idea to recompile the program with suitable
options and symbols for debugger support.
.Pp
If the program starts to give unusual results, coredump or generally behave
-differently without emitting any of the messages listed in the next
-section, it is likely because it depends on the storage being filled with
-nul bytes. Try running it with
+differently without emitting any of the messages listed in the next section,
+it is likely because it depends on the storage being filled with nul bytes.
+Try running it with
.Dq Z
option set;
if that improves the situation, this diagnosis has been confirmed.
@@ -459,8 +459,8 @@ or
is trying to free does not reference a possible page.
.It "recursive call
A process has attempted to call an allocation function recursively.
-This is not permitted. In particular, signal handlers should not
-attempt to allocate memory.
+This is not permitted.
+In particular, signal handlers should not attempt to allocate memory.
.It "out of memory
The
.Dq X
@@ -489,8 +489,8 @@ functions conform to
.Sh HISTORY
The present allocation implementation started out as a filesystem for a
drum attached to a 20bit binary challenged computer which was built
-with discrete germanium transistors. It has since graduated to
-handle primary storage rather than secondary.
+with discrete germanium transistors.
+It has since graduated to handle primary storage rather than secondary.
It first appeared in its new shape and ability in
.Fx 2.2 , and then in
.Nx 1.5 .
diff --git a/lib/libc/stdlib/random.3 b/lib/libc/stdlib/random.3
index 867244d99ef..e0b745b214d 100644
--- a/lib/libc/stdlib/random.3
+++ b/lib/libc/stdlib/random.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: random.3,v 1.15 2002/02/07 09:24:07 ross Exp $
+.\" $NetBSD: random.3,v 1.16 2002/10/01 17:29:23 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -112,9 +112,11 @@ the nearest known amount.
Using less than 8 bytes will cause an error).
The seed for the initialization (which specifies a starting point for
the random number sequence, and provides for restarting at the same
-point) is also an argument. The state array passed to
+point) is also an argument.
+The state array passed to
.Fn initstate
-must be aligned to a 32-bit boundary. This can be achieved by using
+must be aligned to a 32-bit boundary.
+This can be achieved by using
a suitably-sized array of ints, and casting the array to char * when
passing it to
.Fn initstate .
diff --git a/lib/libc/stdlib/tsearch.3 b/lib/libc/stdlib/tsearch.3
index 620c237e92d..d6b1711594c 100644
--- a/lib/libc/stdlib/tsearch.3
+++ b/lib/libc/stdlib/tsearch.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: tsearch.3,v 1.3 2002/02/07 07:00:30 ross Exp $
+.\" $NetBSD: tsearch.3,v 1.4 2002/10/01 17:29:24 wiz Exp $
.\" Copyright (c) 1997 Todd C. Miller <Todd.Miller@courtesan.com>
.\" All rights reserved.
.\"
@@ -50,7 +50,8 @@ The
and
.Fn twalk
functions manage binary search trees based on algorithms T and D
-from Knuth (6.2.2). The comparison function passed in by
+from Knuth (6.2.2).
+The comparison function passed in by
the user has the same style of return values as
.Xr strcmp 3 .
.Pp
@@ -67,7 +68,8 @@ is identical to
.Fn tfind
except that if no match is found,
.Fa key
-is inserted into the tree and a pointer to it is returned. If
+is inserted into the tree and a pointer to it is returned.
+If
.Fa rootp
points to a NULL value a new binary search tree is created.
.Pp
diff --git a/lib/libc/string/memcpy.3 b/lib/libc/string/memcpy.3
index 9bba2239275..57613f706cf 100644
--- a/lib/libc/string/memcpy.3
+++ b/lib/libc/string/memcpy.3
@@ -34,7 +34,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)memcpy.3 8.1 (Berkeley) 6/4/93
-.\" $NetBSD: memcpy.3,v 1.9 2002/02/07 07:00:31 ross Exp $
+.\" $NetBSD: memcpy.3,v 1.10 2002/10/01 17:29:59 wiz Exp $
.\"
.Dd June 4, 1993
.Dt MEMCPY 3
@@ -59,7 +59,8 @@ bytes from string
to string
.Fa dst .
The arguments must not overlap -- behavior if the arguments overlap is
-undefined. To copy byte strings that overlap, use
+undefined.
+To copy byte strings that overlap, use
.Xr memmove 3 .
.Sh RETURN VALUES
The
diff --git a/lib/libc/string/strmode.3 b/lib/libc/string/strmode.3
index 29e79eb72a1..4b0211204ce 100644
--- a/lib/libc/string/strmode.3
+++ b/lib/libc/string/strmode.3
@@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)strmode.3 8.3 (Berkeley) 7/28/94
-.\" $NetBSD: strmode.3,v 1.13 2002/02/07 07:00:32 ross Exp $
+.\" $NetBSD: strmode.3,v 1.14 2002/10/01 17:30:00 wiz Exp $
.\"
.Dd July 28, 1994
.Dt STRMODE 3
@@ -141,12 +141,13 @@ or additional access control methods associated with the inode, otherwise
it will be a space.
.Pp
Archive state 1 and archive state 2 represent file system dependent
-archive state for a file. Most file systems do not retain file archive
+archive state for a file.
+Most file systems do not retain file archive
state, and so will not report files in either archive state.
msdosfs will report a file in archive state 1 if it has been
-archived more recently than modified. Hierarchical storage systems
-may have multiple archive states for a file and may define archive
-states 1 and 2 as appropriate.
+archived more recently than modified.
+Hierarchical storage systems may have multiple archive states for a
+file and may define archive states 1 and 2 as appropriate.
.Sh SEE ALSO
.Xr chmod 1 ,
.Xr find 1 ,