first round of repairs on stdlib

src/lib/libc/stdlib/a64l.3

@@ -24,7 +24,7 @@
 .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $OpenBSD: a64l.3,v 1.3 1999/02/27 21:55:53 deraadt Exp $
+.\" $OpenBSD: a64l.3,v 1.4 1999/06/29 18:36:15 aaron Exp $
 .\"
 .Dd August 17, 1997
 .Dt A64L 3
@@ -45,19 +45,36 @@ The
 and
 .Fn l64a
 functions are used to maintain numbers stored in radix-64
-ASCII characters.  This is a notation by which 32-bit integers
+.Tn ASCII
+characters.  This is a notation by which 32-bit integers
 can be represented by up to six characters; each character
-represents a "digit" in a radix-64 notation.
+represents a
+.Dq digit
+in a radix-64 notation.
 .Pp
-The characters used to represent "digits" are '.' for 0, '/' for 1,
-'0' through '9' for 2-11, 'A' through 'Z' for 12-37, and 'a' through
-'z' for 38-63.
+The characters used to represent digits are
+.Ql \&.
+for 0,
+.Ql /
+for 1,
+.Ql 0
+through
+.Ql 9
+for 2-11,
+.Ql A
+through
+.Ql Z
+for 12-37, and
+.Ql a
+through
+.Ql z
+for 38-63.
 .Pp
 The
 .Fn a64l
 function takes a pointer to a null-terminated radix-64 representation
 and returns a corresponding 32-bit value.  If the string pointed to by
-.Ar s
+.Fa s
 contains more than six characters,
 .Fn a64l
 will use the first six.
@@ -68,35 +85,39 @@ larger than 32 bits, the return value will be sign-extended.
 .Pp
 .Fn l64a
 takes a long integer argument
-.Ar l
+.Fa l
 and returns a pointer to the corresponding radix-64 representation.
 .Sh RETURN VALUES
 On success,
 .Fn a64l
 returns a 32-bit representation of
-.Ar s .
+.Fa s .
 If
-.Ar s
-is a NULL pointer or if it contains "digits" other than those described above,
+.Fa s
+is a null pointer or if it contains digits other than those described above.
 .Fn a64l
-returns -1L and sets the global variable errno to
-.Va EINVAL .
+returns \-1 and sets the global variable
+.Va errno
+to
+.Er EINVAL .
 .Pp
 On success,
 .Fn l64a
 returns a pointer to a string containing the radix-64 representation of
-.Ar l .
+.Fa l .
 If
-.Ar l
+.Fa l
 is 0,
 .Fn l64a
 returns a pointer to the empty string.
 If
-.Ar l
+.Fa l
 is negative,
 .Fn l64a
-returns a NULL pointer and sets the global variable errno to
-.Va EINVAL .
+returns a null pointer and sets the global variable
+.Va errno
+to
+.Er EINVAL .
 .Sh WARNINGS
 The value returned by
 .Fn l64a
@@ -115,7 +136,7 @@ If a long integer is larger than 32 bits, only the low-order
 32 bits are used.
 .Sh STANDARDS
 The
-.Fn a64l                                                           
+.Fn a64l
 and
 .Fn l64a
 functions conform to

src/lib/libc/stdlib/abort.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: abort.3,v 1.4 1997/07/17 07:39:41 deraadt Exp $
+.\"	$OpenBSD: abort.3,v 1.5 1999/06/29 18:36:17 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt ABORT 3
@@ -56,7 +56,7 @@ is being caught and the signal handler does not return.
 Any open streams are flushed and closed.
 .Sh RETURN VALUES
 The
-.Nm abort
+.Fn abort
 function
 never returns.
 .Sh SEE ALSO

src/lib/libc/stdlib/abs.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: abs.3,v 1.3 1999/05/16 19:55:12 alex Exp $
+.\"	$OpenBSD: abs.3,v 1.4 1999/06/29 18:36:17 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt ABS 3
@@ -51,7 +51,7 @@ The
 function
 computes
 the absolute value of the integer
-.Ar j .
+.Fa j .
 .Sh RETURN VALUES
 The
 .Fn abs

src/lib/libc/stdlib/alloca.3

@@ -29,7 +29,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: alloca.3,v 1.6 1999/05/23 14:11:03 aaron Exp $
+.\"	$OpenBSD: alloca.3,v 1.7 1999/06/29 18:36:18 aaron Exp $
 .\"
 .Dd May 2, 1991
 .Dt ALLOCA 3
@@ -45,7 +45,7 @@
 The
 .Fn alloca
 function
-allocates 
+allocates
 .Fa size
 bytes of space in the stack frame of the caller.
 This temporary space is automatically freed on
@@ -70,6 +70,6 @@ is machine dependent; its use is discouraged.
 .\" .Fn alloca
 .\" function appeared in
 .\" .Bx ?? .
-.\" The function appeared in 32v, pwb and pwb.2 and in 3bsd 4bsd 
+.\" The function appeared in 32v, pwb and pwb.2 and in 3bsd 4bsd
 .\" The first man page (or link to a man page that I can find at the
 .\" moment is 4.3...

src/lib/libc/stdlib/atexit.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: atexit.3,v 1.2 1996/08/19 08:33:22 tholo Exp $
+.\"	$OpenBSD: atexit.3,v 1.3 1999/06/29 18:36:18 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt ATEXIT 3
@@ -50,11 +50,11 @@ The
 .Fn atexit
 function
 registers the given
-.Ar function
+.Fa function
 to be called at program exit, whether via
 .Xr exit 3
 or via return from the program's
-.Em main .
+.Fn main .
 Functions so registered are called in reverse order;
 no arguments are passed.
 At least 32 functions can always be registered,

src/lib/libc/stdlib/atof.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: atof.3,v 1.2 1996/08/19 08:33:23 tholo Exp $
+.\"	$OpenBSD: atof.3,v 1.3 1999/06/29 18:36:18 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt ATOF 3
@@ -51,9 +51,9 @@ string to double
 The
 .Fn atof
 function converts the initial portion of the string pointed to by
-.Ar nptr
+.Fa nptr
 to
-.Ar double
+.Li double
 representation.
 .Pp
 It is equivalent to:

src/lib/libc/stdlib/atoi.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: atoi.3,v 1.2 1996/08/10 04:51:31 tholo Exp $
+.\"	$OpenBSD: atoi.3,v 1.3 1999/06/29 18:36:18 aaron Exp $
 .\"
 .Dd June 4, 1993
 .Dt ATOI 3
@@ -51,9 +51,9 @@ string to integer
 The
 .Fn atoi
 function converts the initial portion of the string pointed to by
-.Em nptr
+.Fa nptr
 to
-.Em integer
+.Li integer
 representation.
 .Pp
 It is equivalent to:

src/lib/libc/stdlib/atol.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: atol.3,v 1.2 1996/08/19 08:33:25 tholo Exp $
+.\"	$OpenBSD: atol.3,v 1.3 1999/06/29 18:36:19 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt ATOL 3
@@ -51,9 +51,9 @@ string to long integer
 The
 .Fn atol
 function converts the initial portion of the string pointed to by
-.Ar nptr
+.Fa nptr
 to
-.Em long integer
+.Li long integer
 representation.
 .Pp
 It is equivalent to:

src/lib/libc/stdlib/bsearch.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: bsearch.3,v 1.3 1997/06/13 23:41:35 deraadt Exp $
+.\"	$OpenBSD: bsearch.3,v 1.4 1999/06/29 18:36:19 aaron Exp $
 .\"
 .Dd April 19, 1994
 .Dt BSEARCH 3
@@ -50,12 +50,12 @@ The
 .Fn bsearch
 function searches an array of
 .Fa nmemb
-objects, the initial member of which is 
+objects, the initial member of which is
 pointed to by
 .Fa base ,
 for a member that matches the object pointed to by
 .Fa key .
-The size of each member of the array is specified by 
+The size of each member of the array is specified by
 .Fa size .
 .Pp
 The contents of the array should be in ascending sorted order according

src/lib/libc/stdlib/calloc.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: calloc.3,v 1.4 1999/05/16 19:55:13 alex Exp $
+.\"	$OpenBSD: calloc.3,v 1.5 1999/06/29 18:36:19 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt CALLOC 3
@@ -48,7 +48,7 @@
 .Sh DESCRIPTION
 The
 .Fn calloc
-function allocates space for an array of 
+function allocates space for an array of
 .Fa nmemb
 objects, each of whose size is
 .Fa size .

src/lib/libc/stdlib/div.3

@@ -31,7 +31,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: div.3,v 1.3 1999/05/16 19:55:14 alex Exp $
+.\"	$OpenBSD: div.3,v 1.4 1999/06/29 18:36:19 aaron Exp $
 .\"
 .Dd April 19, 1991
 .Dt DIV 3
@@ -48,11 +48,11 @@ The
 .Fn div
 function
 computes the value
-.Fa num/denom
+.Fa num Ns No / Ns Fa denom
 and returns the quotient and remainder in a structure named
 .Fa div_t
 that contains two
-.Em int
+.Li int
 members named
 .Fa quot
 and

src/lib/libc/stdlib/getenv.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: getenv.3,v 1.4 1999/05/25 13:06:46 aaron Exp $
+.\"	$OpenBSD: getenv.3,v 1.5 1999/06/29 18:36:20 aaron Exp $
 .\"
 .Dd December 11, 1993
 .Dt GETENV 3
@@ -60,10 +60,10 @@ host
 .Em environment list .
 For compatibility with differing environment conventions,
 the given arguments
-.Ar name
+.Fa name
 and
-.Ar value
-may be appended and prepended, 
+.Fa value
+may be appended and prepended,
 respectively,
 with an equal sign
 .Dq Li \&= .
@@ -71,30 +71,30 @@ with an equal sign
 The
 .Fn getenv
 function obtains the current value of the environment variable,
-.Ar name .
+.Fa name .
 If the variable
-.Ar name
+.Fa name
 is not in the current environment,
 a null pointer is returned.
 .Pp
 The
 .Fn setenv
 function inserts or resets the environment variable
-.Ar name
+.Fa name
 in the current environment list.
 If the variable
-.Ar name
+.Fa name
 does not exist in the list,
 it is inserted with the given
-.Ar value .
+.Fa value .
 If the variable does exist, the argument
-.Ar overwrite
+.Fa overwrite
 is tested; if
-.Ar overwrite is
-zero, the
-variable is not reset, otherwise it is reset
+.Fa overwrite
+is zero,
+the variable is not reset, otherwise it is reset
 to the given
-.Ar value .
+.Fa value .
 .Pp
 The
 .Fn putenv
@@ -122,7 +122,7 @@ is set to indicate the error and a
 .Pp
 If
 .Fn getenv
-is succesful, the string returned should be considered read-only. 
+is succesful, the string returned should be considered read-only.
 .Sh ERRORS
 .Bl -tag -width [ENOMEM]
 .It Bq Er ENOMEM

src/lib/libc/stdlib/getopt.3

@@ -29,7 +29,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: getopt.3,v 1.8 1999/05/27 13:09:09 aaron Exp $
+.\"	$OpenBSD: getopt.3,v 1.9 1999/06/29 18:36:20 aaron Exp $
 .\"
 .Dd April 19, 1994
 .Dt GETOPT 3
@@ -132,22 +132,25 @@ When all options have been processed (i.e., up to the first non-option
 argument),
 .Fn getopt
 returns \-1.
+.Sh SEE ALSO
+.Xr getopt 1 ,
+.Xr getsubopt 3
 .Sh DIAGNOSTICS
 If the
 .Fn getopt
 function encounters a character not found in the string
 .Va optstring
 or detects
-a missing option argument it writes an error message to 
-.Em stderr 
+a missing option argument it writes an error message to
+.Em stderr
 and returns
 .Ql ? .
 Setting
 .Va opterr
 to a zero will disable these error messages.
 If
-.Va optstring 
-has a leading 
+.Va optstring
+has a leading
 .Ql \&:
 then a missing option argument causes a
 .Ql \&:
@@ -202,17 +205,17 @@ function appeared
 The
 .Fn getopt
 function was once specified to return
-.Dv EOF 
+.Dv EOF
 instead of \-1.
 This was changed by
 .St -p1003.2-92
-to decouple 
+to decouple
 .Fn getopt
-from 
+from
 .Pa <stdio.h> .
 .Pp
 A single dash
-.Dq Li -
+.Pq Ql -
 may be specified as a character in
 .Fa optstring ,
 however it should
@@ -221,7 +224,7 @@ have an argument associated with it.
 This allows
 .Fn getopt
 to be used with programs that expect
-.Dq Li -
+.Ql -
 as an option flag.
 This practice is wrong, and should not be used in any current development.
 It is provided for backward compatibility

src/lib/libc/stdlib/getsubopt.3

@@ -1,4 +1,4 @@
-.\" $OpenBSD: getsubopt.3,v 1.2 1998/06/15 17:55:07 mickey Exp $
+.\" $OpenBSD: getsubopt.3,v 1.3 1999/06/29 18:36:20 aaron Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -60,8 +60,7 @@ The argument
 is a pointer to a pointer to the string.
 The argument
 .Fa tokens
-is a pointer to a
-.Dv NULL Ns -terminated
+is a pointer to a null-terminated
 array of pointers to strings.
 .Pp
 The

src/lib/libc/stdlib/labs.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: labs.3,v 1.3 1999/05/16 19:55:14 alex Exp $
+.\"	$OpenBSD: labs.3,v 1.4 1999/06/29 18:36:20 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt LABS 3
@@ -50,7 +50,7 @@ The
 .Fn labs
 function
 returns the absolute value of the long integer
-.Ar j .
+.Fa j .
 .Sh SEE ALSO
 .Xr abs 3 ,
 .Xr cabs 3 ,

src/lib/libc/stdlib/ldiv.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: ldiv.3,v 1.3 1999/05/16 19:55:15 alex Exp $
+.\"	$OpenBSD: ldiv.3,v 1.4 1999/06/29 18:36:21 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt LDIV 3
@@ -50,15 +50,15 @@ The
 .Fn ldiv
 function
 computes the value
-.Ar num/denom
+.Fa num Ns No / Ns Fa denom
 and returns the quotient and remainder in a structure named
-.Ar ldiv_t
+.Li ldiv_t
 that contains two
-.Em long integer
+.Li long integer
 members named
-.Ar quot
+.Fa quot
 and
-.Ar rem .
+.Fa rem .
 .Sh SEE ALSO
 .Xr div 3 ,
 .Xr math 3 ,

src/lib/libc/stdlib/malloc.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: malloc.3,v 1.14 1999/05/27 20:49:35 aaron Exp $
+.\"	$OpenBSD: malloc.3,v 1.15 1999/06/29 18:36:21 aaron Exp $
 .\"
 .Dd August 27, 1996
 .Dt MALLOC 3
@@ -113,9 +113,9 @@ If
 is a null pointer, the
 .Fn realloc
 function behaves like the
-.Fn malloc 
+.Fn malloc
 function for the specified size.
-If the space cannot be allocated, the object 
+If the space cannot be allocated, the object
 pointed to by
 .Fa ptr
 is unchanged.
@@ -137,7 +137,7 @@ if ((p = realloc(p, nsize)) == NULL)
 .Pp
 In most cases, this will result in a leak of memory.
 As stated earlier, a return value of
-.Fa NULL
+.Dv NULL
 indicates that the old object still remains allocated.
 Better code looks like this:
 .Bd -literal -offset indent
@@ -163,7 +163,7 @@ Flags are single letters, uppercase means on, lowercase means off.
 ``abort'' malloc will coredump the process, rather than tolerate failure.
 This is a very handy debugging aid, since the core file will represent the
 time of failure,
-rather than when the NULL pointer was accessed.
+rather than when the null pointer was accessed.
 .Pp
 .It D
 ``dump'' malloc will dump statistics in a file called ``malloc.out'' at exit.
@@ -195,7 +195,7 @@ for all operations.
 Consult the source for this one.
 .Pp
 .It X
-``xmalloc'' 
+``xmalloc''
 rather than return failure,
 .Xr abort 3
 the program with a diagnostic message on stderr.
@@ -244,15 +244,15 @@ The
 function a pointer to the possibly moved allocated space;
 otherwise a null pointer is returned.
 .Sh MESSAGES
-If 
+If
 .Fn malloc ,
 .Fn free
-or 
+or
 .Fn realloc
 detects an error or warning condition,
 a message will be printed to filedescriptor
 2 (not using stdio).
-Errors will always result in the process being 
+Errors will always result in the process being
 .Xr abort 3 'ed.
 If the ``A'' option has been specified, warnings will also
 .Xr abort 3
@@ -267,9 +267,10 @@ fishy in there.  Consult sources and or wizards.
 ``allocation failed''
 if the ``A'' option is specified it is an error for
 .Fn malloc
-or 
+or
 .Fn realloc
-to return NULL.
+to return
+.Dv NULL .
 .Pp
 ``mmap(2) failed, check limits.''
 This is a rather weird condition that is most likely to mean that
@@ -287,7 +288,7 @@ A pointer to a free chunk is attempted freed again.
 The pointer doesn't make sense.  It's above the area of memory that
 malloc knows something about.
 This could be a pointer from some
-.Xr mmap 2 'ed 
+.Xr mmap 2 'ed
 memory.
 .Pp
 ``junk pointer, too low to make sense.''
@@ -344,7 +345,7 @@ secondary.
 .Pp
 The main difference from other malloc implementations are believed to be that
 the free pages are not accessed until allocated.
-Most malloc implementations will store a data structure containing a, 
+Most malloc implementations will store a data structure containing a,
 possibly double-, linked list in the free chunks of memory, used to tie
 all the free memory together.
 That is a quite suboptimal thing to do.

src/lib/libc/stdlib/qabs.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: qabs.3,v 1.3 1999/05/16 19:55:16 alex Exp $
+.\"	$OpenBSD: qabs.3,v 1.4 1999/06/29 18:36:21 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt QABS 3
@@ -50,7 +50,7 @@ The
 .Fn qabs
 function
 returns the absolute value of the quad integer
-.Ar j .
+.Fa j .
 .Sh SEE ALSO
 .Xr abs 3 ,
 .Xr cabs 3 ,

src/lib/libc/stdlib/qdiv.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: qdiv.3,v 1.2 1996/08/19 08:33:41 tholo Exp $
+.\"	$OpenBSD: qdiv.3,v 1.3 1999/06/29 18:36:21 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt QDIV 3
@@ -50,15 +50,15 @@ The
 .Fn qdiv
 function
 computes the value
-.Ar num/denom
+.Fa num Ns No / Ns Fa denom
 and returns the quotient and remainder in a structure named
-.Ar qdiv_t
+.Li qdiv_t
 that contains two
-.Em quad integer
+.Li quad integer
 members named
-.Ar quot
+.Fa quot
 and
-.Ar rem .
+.Fa rem .
 .Sh SEE ALSO
 .Xr div 3 ,
 .Xr ldiv 3 ,

src/lib/libc/stdlib/qsort.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: qsort.3,v 1.3 1999/02/27 21:56:00 deraadt Exp $
+.\"	$OpenBSD: qsort.3,v 1.4 1999/06/29 18:36:22 aaron Exp $
 .\"
 .Dd June 4, 1993
 .Dt QSORT 3
@@ -131,7 +131,7 @@ The function
 .Fn mergesort
 requires additional memory of size
 .Fa nmemb *
-.Fa size 
+.Fa size
 bytes; it should be used only when space is not at a premium.
 .Fn mergesort
 is optimized for data with pre-existing order; its worst case

src/lib/libc/stdlib/radixsort.3

@@ -29,7 +29,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: radixsort.3,v 1.4 1998/06/15 17:55:08 mickey Exp $
+.\"	$OpenBSD: radixsort.3,v 1.5 1999/06/29 18:36:22 aaron Exp $
 .\"
 .Dd January 27, 1994
 .Dt RADIXSORT 3
@@ -62,8 +62,7 @@ is denoted by the user-specified value
 Applications may specify a sort order by providing the
 .Fa table
 argument.
-If
-.Pf non- Dv NULL , 
+If non-null,
 .Fa table
 must reference an array of
 .Dv UCHAR_MAX
@@ -80,7 +79,9 @@ equally, for example, providing a table with the same weights
 for A-Z as for a-z will result in a case-insensitive sort.
 If
 .Fa table
-is NULL, the contents of the array are sorted in ascending order
+is
+.Dv NULL ,
+the contents of the array are sorted in ascending order
 according to the
 .Tn ASCII
 order of the byte strings they reference and
@@ -106,7 +107,7 @@ particular, see D.E. Knuth's Algorithm R and section 5.2.5, exercise 10.
 They take linear time relative to the number of bytes in the strings.
 .Sh RETURN VALUES
 Upon successful completion 0 is returned.
-Otherwise, \-1 is returned and the global variable 
+Otherwise, \-1 is returned and the global variable
 .Va errno
 is set to indicate the error.
 .Sh ERRORS

src/lib/libc/stdlib/rand.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: rand.3,v 1.5 1998/11/20 11:18:50 d Exp $
+.\"	$OpenBSD: rand.3,v 1.6 1999/06/29 18:36:22 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt RAND 3
@@ -81,7 +81,7 @@ The
 is a thread-safe version of
 .Fn rand .
 Storage for the seed must be provided through the
-.Ar seed
+.Fa seed
 argument, and needs to have been initialized by the caller.
 .Sh SEE ALSO
 .Xr arc4random 3 ,

src/lib/libc/stdlib/rand48.3

@@ -9,7 +9,7 @@
 .\" of any kind. I shall in no event be liable for anything that happens
 .\" to anyone/anything when using this software.
 .\"
-.\"	$OpenBSD: rand48.3,v 1.4 1999/03/11 01:35:01 pjanzen Exp $
+.\"	$OpenBSD: rand48.3,v 1.5 1999/06/29 18:36:22 aaron Exp $
 .\"
 .Dd October 8, 1993
 .Dt RAND48 3
@@ -27,7 +27,7 @@
 .Nd pseudo random number generators and initialization routines
 .Sh SYNOPSIS
 .Fd #include <stdlib.h>
-.Ft double 
+.Ft double
 .Fn drand48 void
 .Ft double
 .Fn erand48 "unsigned short xseed[3]"

src/lib/libc/stdlib/random.3

@@ -29,7 +29,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: random.3,v 1.7 1999/05/23 14:11:03 aaron Exp $
+.\"	$OpenBSD: random.3,v 1.8 1999/06/29 18:36:23 aaron Exp $
 .\"
 .Dd April 19, 1991
 .Dt RANDOM 3
@@ -42,7 +42,7 @@
 .Nd better random number generator; routines for changing generators
 .Sh SYNOPSIS
 .Fd #include <stdlib.h>
-.Ft long 
+.Ft long
 .Fn random void
 .Ft void
 .Fn srandom "unsigned int seed"
@@ -96,7 +96,7 @@ however,
 will by default produce a sequence of numbers that can be duplicated
 by calling
 .Fn srandom
-with 
+with
 .Ql 1
 as the seed.
 .Pp
@@ -167,16 +167,16 @@ messages are printed on the standard error output.
 .Xr rand 3
 .Sh STANDARDS
 The
-.Fn random ,                                                           
-.Fn srandom ,                                                           
-.Fn initstate ,                                                           
+.Fn random ,
+.Fn srandom ,
+.Fn initstate ,
 and
 .Fn setstate
 functions conform to
 .St -xpg4.2 .
 .Sh HISTORY
 These
-functions appeared in 
+functions appeared in
 .Bx 4.2 .
 .Sh BUGS
 About 2/3 the speed of

src/lib/libc/stdlib/realpath.3

@@ -32,7 +32,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: realpath.3,v 1.4 1999/05/28 01:57:36 aaron Exp $
+.\"	$OpenBSD: realpath.3,v 1.5 1999/06/29 18:36:23 aaron Exp $
 .\"
 .Dd February, 16, 1994
 .Dt REALPATH 3
@@ -67,7 +67,7 @@ refer to a buffer capable of storing at least
 .Dv MAXPATHLEN
 characters.
 .Pp
-The 
+The
 .Fn realpath
 function will resolve both absolute and relative paths
 and return the absolute pathname corresponding to

src/lib/libc/stdlib/strtod.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: strtod.3,v 1.3 1999/05/27 20:49:35 aaron Exp $
+.\"	$OpenBSD: strtod.3,v 1.4 1999/06/29 18:36:23 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt STRTOD 3
@@ -50,11 +50,11 @@ string to double
 .Sh DESCRIPTION
 The
 .Fn strtod
-function converts the initial portion of the string 
+function converts the initial portion of the string
 pointed to by
 .Fa nptr
 to
-.Em double
+.Li double
 representation.
 .Pp
 The expected form of the string is an optional plus (``+'') or minus
@@ -93,7 +93,7 @@ is stored in
 If the correct value would cause underflow, zero is
 returned and
 .Dv ERANGE
-is stored in 
+is stored in
 .Va errno .
 .Sh ERRORS
 .Bl -tag -width Er

src/lib/libc/stdlib/strtol.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: strtol.3,v 1.3 1996/08/19 08:33:51 tholo Exp $
+.\"	$OpenBSD: strtol.3,v 1.4 1999/06/29 18:36:23 aaron Exp $
 .\"
 .Dd June 25, 1992
 .Dt STRTOL 3
@@ -59,7 +59,7 @@ function
 converts the string in
 .Fa nptr
 to a
-.Em long
+.Li long
 value.
 The
 .Fn strtoq
@@ -67,7 +67,7 @@ function
 converts the string in
 .Fa nptr
 to a
-.Em quad_t
+.Li quad_t
 value.
 The conversion is done according to the given
 .Fa base ,
@@ -95,7 +95,7 @@ is taken as 10 (decimal) unless the next character is
 in which case it is taken as 8 (octal).
 .Pp
 The remainder of the string is converted to a
-.Em long
+.Li long
 value in the obvious manner,
 stopping at the first character which is not a valid digit
 in the given base.

src/lib/libc/stdlib/strtoul.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: strtoul.3,v 1.2 1996/08/19 08:33:52 tholo Exp $
+.\"	$OpenBSD: strtoul.3,v 1.3 1999/06/29 18:36:24 aaron Exp $
 .\"
 .Dd June 25, 1992
 .Dt STRTOUL 3
@@ -59,7 +59,7 @@ function
 converts the string in
 .Fa nptr
 to an
-.Em unsigned long
+.Li unsigned long
 value.
 The
 .Fn strtouq
@@ -67,7 +67,7 @@ function
 converts the string in
 .Fa nptr
 to a
-.Em u_quad_t
+.Li u_quad_t
 value.
 The conversion is done according to the given
 .Fa base ,
@@ -95,7 +95,7 @@ is taken as 10 (decimal) unless the next character is
 in which case it is taken as 8 (octal).
 .Pp
 The remainder of the string is converted to an
-.Em unsigned long
+.Li unsigned long
 value in the obvious manner,
 stopping at the end of the string
 or at the first character that does not produce a valid digit

src/lib/libc/stdlib/system.3

@@ -33,7 +33,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     $OpenBSD: system.3,v 1.5 1996/12/11 23:09:53 tholo Exp $
+.\"     $OpenBSD: system.3,v 1.6 1999/06/29 18:36:24 aaron Exp $
 .\"
 .Dd June 29, 1991
 .Dt SYSTEM 3
@@ -70,18 +70,18 @@ pointer,
 will return non-zero.
 Otherwise,
 .Fn system
-returns the termination status of the shell in the format specified by 
+returns the termination status of the shell in the format specified by
 .Xr waitpid 2 .
-.Sh RETURN VALUES 
+.Sh RETURN VALUES
 If a child process cannot be created, or the termination status of
-the shell cannot be obtained, 
+the shell cannot be obtained,
 .Fn system
-returns -1 and sets
+returns \-1 and sets
 .Va errno
 to indicate the error.
-If execution of the shell fails, 
+If execution of the shell fails,
 .Fn system
-returns the termination status for a program that terminates with a call of 
+returns the termination status for a program that terminates with a call of
 .Fn exit 127 .
 .Sh SEE ALSO
 .Xr sh 1 ,
@@ -93,6 +93,6 @@ The
 .Fn system
 function
 conforms to
-.St -ansiC 
+.St -ansiC
 and
 .St -p1003.2-92 .

src/lib/libc/stdlib/tsearch.3

@@ -23,7 +23,7 @@
 .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: tsearch.3,v 1.4 1999/05/10 17:56:28 aaron Exp $
+.\"	$OpenBSD: tsearch.3,v 1.5 1999/06/29 18:36:24 aaron Exp $
 .\"
 .Dd June 15, 1997
 .Dt TSEARCH 3
@@ -58,7 +58,8 @@ searches for the datum matched by the argument
 .Fa key
 in the binary tree rooted at
 .Fa rootp ,
-returning a pointer to the datum if it is found and NULL
+returning a pointer to the datum if it is found and
+.Dv NULL
 if it is not.
 .Pp
 .Fn tsearch
@@ -68,7 +69,7 @@ except that if no match is found,
 .Fa key
 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.
+points to a null value a new binary search tree is created.
 .Pp
 .Fn tdelete
 deletes a node from the specified binary search tree and returns
@@ -89,7 +90,7 @@ and calls the function
 on each node.
 .Fa action
 is called with three arguments: a pointer to the current node,
-a value from the enum 
+a value from the enum
 .Sy "typedef enum { preorder, postorder, endorder, leaf } VISIT;"
 specifying the traversal type, and a node level (where level
 zero is the root of the tree).
@@ -99,16 +100,22 @@ zero is the root of the tree).
 .Sh RETURN VALUES
 The
 .Fn tsearch
-function returns NULL if allocation of a new node fails (usually
+function returns
+.Dv NULL
+if allocation of a new node fails (usually
 due to a lack of free memory).
 .Pp
 .Fn tfind ,
 .Fn tsearch ,
 and
 .Fn tdelete
-return NULL if
+return
+.Dv NULL
+if
 .Fa rootp
-is NULL or the datum cannot be found.
+is
+.Dv NULL
+or the datum cannot be found.
 .Pp
 The
 .Fn twalk