- typos, punctuation, layout, macro tweaks

- break long lines

ok jmc

9 files changed, 48 insertions, 34 deletions

diff --git a/src/lib/libc/stdlib/atoll.3 b/src/lib/libc/stdlib/atoll.3
index 40584e9d47..2b53e9b694 100644
--- a/src/lib/libc/stdlib/atoll.3
+++ b/src/lib/libc/stdlib/atoll.3
@@ -29,7 +29,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     $OpenBSD: atoll.3,v 1.3 2003/06/02 20:18:37 millert Exp $
+.\"     $OpenBSD: atoll.3,v 1.4 2005/07/26 04:20:23 jaredy Exp $
 .\"
 .Dd June 29, 1991
 .Dt ATOLL 3
@@ -49,7 +49,7 @@ The
 function converts the initial portion of the string pointed to by
 .Fa nptr
 to
-.Li long integer
+.Li long long integer
 representation.
 .Pp
 It is equivalent to:
diff --git a/src/lib/libc/stdlib/getenv.3 b/src/lib/libc/stdlib/getenv.3
index 8faf74c43d..f131bbf513 100644
--- a/src/lib/libc/stdlib/getenv.3
+++ b/src/lib/libc/stdlib/getenv.3
@@ -29,7 +29,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     $OpenBSD: getenv.3,v 1.10 2005/05/11 20:09:44 otto Exp $
+.\"     $OpenBSD: getenv.3,v 1.11 2005/07/26 04:20:23 jaredy Exp $
 .\"
 .Dd December 11, 1993
 .Dt GETENV 3
@@ -62,7 +62,7 @@ may be appended and prepended, respectively, with an equal sign
 .Pp
 The
 .Fn getenv
-function obtains the current value of the environment variable,
+function obtains the current value of the environment variable
 .Fa name .
 If the variable
 .Fa name
@@ -111,7 +111,7 @@ If
 .Fn getenv
 is successful, the string returned should be considered read-only.
 .Sh ERRORS
-.Bl -tag -width [ENOMEM]
+.Bl -tag -width Er
 .It Bq Er ENOMEM
 The function
 .Fn setenv
diff --git a/src/lib/libc/stdlib/getopt.3 b/src/lib/libc/stdlib/getopt.3
index ed4456f52f..2fb70b7260 100644
--- a/src/lib/libc/stdlib/getopt.3
+++ b/src/lib/libc/stdlib/getopt.3
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     $OpenBSD: getopt.3,v 1.34 2005/07/26 04:14:58 jaredy Exp $
+.\"     $OpenBSD: getopt.3,v 1.35 2005/07/26 04:20:23 jaredy Exp $
 .\"
 .Dd December 17, 2002
 .Dt GETOPT 3
@@ -207,7 +207,7 @@ If the
 function encounters a character not found in the string
 .Fa optstring
 or detects
-a missing option argument it writes an error message to
+a missing option argument, it writes an error message to
 .Em stderr
 and returns
 .Ql \&? .
diff --git a/src/lib/libc/stdlib/getsubopt.3 b/src/lib/libc/stdlib/getsubopt.3
index 6cb4975ced..d0308e2d50 100644
--- a/src/lib/libc/stdlib/getsubopt.3
+++ b/src/lib/libc/stdlib/getsubopt.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getsubopt.3,v 1.9 2005/02/25 03:12:44 cloder Exp $
+.\" $OpenBSD: getsubopt.3,v 1.10 2005/07/26 04:20:23 jaredy Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"     The Regents of the University of California.  All rights reserved.
@@ -44,7 +44,7 @@
 The
 .Fn getsubopt
 function parses a string containing tokens delimited by one or more
-tab, space or comma
+tab, space, or comma
 .Pq Ql \&,
 characters.
 It is intended for use in parsing groups of option arguments provided
@@ -90,7 +90,7 @@ will be set to point to the value portion of the token, or
 .Dv NULL
 if no value portion was present.
 .Sh EXAMPLES
-.Bd -literal -compact
+.Bd -literal
 char *tokens[] = {
         #define ONE     0
                 "one",
diff --git a/src/lib/libc/stdlib/hcreate.3 b/src/lib/libc/stdlib/hcreate.3
index d1d4e5c185..a1ad251487 100644
--- a/src/lib/libc/stdlib/hcreate.3
+++ b/src/lib/libc/stdlib/hcreate.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: hcreate.3,v 1.1 2004/06/24 04:43:33 millert Exp $
+.\"     $OpenBSD: hcreate.3,v 1.2 2005/07/26 04:20:23 jaredy Exp $
 .\"     $NetBSD: hcreate.3,v 1.6 2003/04/16 13:34:46 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
@@ -54,7 +54,7 @@
 .Sh DESCRIPTION
 The
 .Fn hcreate ,
-.Fn hdestroy
+.Fn hdestroy ,
 and
 .Fn hsearch
 functions manage hash search tables.
@@ -93,6 +93,7 @@ The
 argument is of type
 .Dv ENTRY ,
 a structural type which contains the following members:
+.Pp
 .Bl -tag -compact -offset indent -width voidX*dataXX
 .It Fa char *key
 comparison key.
@@ -111,7 +112,7 @@ The
 argument is of type
 .Dv ACTION ,
 an enumeration type which defines the following values:
-.Bl -tag -compact -offset indent -width ENTERXX
+.Bl -tag -offset indent -width ENTERXX
 .It Dv ENTER
 Insert
 .Fa item
@@ -145,7 +146,7 @@ returns no value.
 .Pp
 If successful, the
 .Fn hsearch
-function returns a pointer to hash table entry matching
+function returns a pointer to a hash table entry matching
 the provided key.
 If the action is
 .Dv FIND
@@ -178,7 +179,7 @@ Insufficient memory is available.
 .Sh STANDARDS
 The
 .Fn hcreate ,
-.Fn hdestroy
+.Fn hdestroy ,
 and
 .Fn hsearch
 functions conform to
diff --git a/src/lib/libc/stdlib/insque.3 b/src/lib/libc/stdlib/insque.3
index 33b193ca80..fb4f55112d 100644
--- a/src/lib/libc/stdlib/insque.3
+++ b/src/lib/libc/stdlib/insque.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: insque.3,v 1.5 2005/07/26 04:13:18 jaredy Exp $
+.\"     $OpenBSD: insque.3,v 1.6 2005/07/26 04:20:23 jaredy Exp $
 .\" Copyright (c) 1993 John Brezak
 .\" All rights reserved.
 .\"
@@ -52,11 +52,11 @@ and
 manipulate queues built from doubly linked lists.
 The queue can be either circular or linear.
 Each element in the queue must be of the following form:
-.Bd -literal
+.Bd -literal -offset indent
 struct qelem {
-    struct qelem   *q_forw;
-    struct qelem   *q_back;
-    char            q_data[];
+        struct qelem   *q_forw;
+        struct qelem   *q_back;
+        char            q_data[];
 };
 .Ed
 .Pp
@@ -77,7 +77,7 @@ The
 function removes
 .Fa elem
 from the queue.
-.Sh DIAGNOSTICS
+.Pp
 These functions are not atomic unless that machine architecture allows it.
 .Sh SEE ALSO
 .Xr queue 3
@@ -96,7 +96,11 @@ The
 .Fn insque
 and
 .Fn remque
-functions are derived from the insque and remque instructions on a
+functions are derived from the
+.Li insque
+and
+.Li remque
+instructions on the
 .Tn VAX .
 They first appeared in
 .Bx 4.2 .
diff --git a/src/lib/libc/stdlib/lsearch.3 b/src/lib/libc/stdlib/lsearch.3
index 051b1ef4c1..eda2aeb599 100644
--- a/src/lib/libc/stdlib/lsearch.3
+++ b/src/lib/libc/stdlib/lsearch.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: lsearch.3,v 1.5 2005/07/07 07:50:38 jmc Exp $
+.\"     $OpenBSD: lsearch.3,v 1.6 2005/07/26 04:20:23 jaredy Exp $
 .\"
 .\" Copyright (c) 1989, 1991, 1993
 .\"     The Regents of the University of California.  All rights reserved.
@@ -38,12 +38,14 @@
 .Nd linear searching routines
 .Sh SYNOPSIS
 .Ft char *
-.Fn lsearch "const void *key" "const void *base" "size_t *nelp" "size_t width" "int (*compar)(void *, void *)"
+.Fn lsearch "const void *key" "const void *base" "size_t *nelp" \
+    "size_t width" "int (*compar)(void *, void *)"
 .Ft char *
-.Fn lfind "const void *key" "const void *base" "size_t *nelp" "size_t width" "int (*compar)(void *, void *)"
+.Fn lfind "const void *key" "const void *base" "size_t *nelp" \
+    "size_t width" "int (*compar)(void *, void *)"
 .Sh DESCRIPTION
 The functions
-.Fn lsearch ,
+.Fn lsearch
 and
 .Fn lfind
 provide basic linear searching functionality.
@@ -86,7 +88,7 @@ will return a null pointer and
 .Fn lsearch
 will add it to the array.
 When an element is added to the array by
-.Fn lsearch
+.Fn lsearch ,
 the location referenced by the argument
 .Fa nelp
 is incremented by one.
diff --git a/src/lib/libc/stdlib/malloc.3 b/src/lib/libc/stdlib/malloc.3
index 8cf547251c..9c4d94db15 100644
--- a/src/lib/libc/stdlib/malloc.3
+++ b/src/lib/libc/stdlib/malloc.3
@@ -30,7 +30,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     $OpenBSD: malloc.3,v 1.40 2005/06/07 09:04:42 jmc Exp $
+.\"     $OpenBSD: malloc.3,v 1.41 2005/07/26 04:20:23 jaredy Exp $
 .\"
 .Dd August 27, 1996
 .Dt MALLOC 3
@@ -293,7 +293,10 @@ if successful; otherwise, a null pointer is returned and
 is set to
 .Er ENOMEM .
 .Sh ENVIRONMENT
+.Bl -tag -width Ev
+.It Ev MALLOC_OPTIONS
 See above.
+.El
 .Sh FILES
 .Bl -tag -width "/etc/malloc.conf"
 .It Pa /etc/malloc.conf
@@ -318,7 +321,7 @@ option has been specified, warnings will also
 the process.
 .Pp
 Here is a brief description of the error messages and what they mean:
-.Bl -tag -width Fl
+.Bl -tag -width Ds
 .It Dq (ES): mumble mumble mumble
 .Fn malloc
 has been compiled with
@@ -346,7 +349,7 @@ internal freelist has been stomped on.
 .El
 .Pp
 Here is a brief description of the warning messages and what they mean:
-.Bl -tag -width Fl
+.Bl -tag -width Ds
 .It Dq chunk/page is already free.
 There was an attempt to free a chunk that had already been freed.
 .It Dq junk pointer, too high to make sense.
@@ -367,7 +370,11 @@ This pointer probably came from your data or bss segments.
 Nothing has ever been allocated, yet something is being freed or
 realloc'ed.
 .It Dq modified (chunk-/page-) pointer.
-The pointer passed to free or realloc has been modified.
+The pointer passed to
+.Fn free
+or
+.Fn realloc
+has been modified.
 .It Dq pointer to wrong page.
 The pointer that
 .Fn malloc
diff --git a/src/lib/libc/stdlib/radixsort.3 b/src/lib/libc/stdlib/radixsort.3
index 028837d4d1..8a4f71641f 100644
--- a/src/lib/libc/stdlib/radixsort.3
+++ b/src/lib/libc/stdlib/radixsort.3
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     $OpenBSD: radixsort.3,v 1.9 2003/06/02 20:18:38 millert Exp $
+.\"     $OpenBSD: radixsort.3,v 1.10 2005/07/26 04:20:23 jaredy Exp $
 .\"
 .Dd January 27, 1994
 .Dt RADIXSORT 3
@@ -71,8 +71,8 @@ More than one byte may have the same sort weight.
 The
 .Fa table
 argument is useful for applications which wish to sort different characters
-equally, for example, providing a table with the same weights
-for A-Z as for a-z will result in a case-insensitive sort.
+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