[src/trunk]: src/lib/libc/stdlib Drop unnecessary whitespace and .Pp, sort SE...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/79ad5bb83664
branches:  trunk
changeset: 515024:79ad5bb83664
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sun Sep 16 01:31:51 2001 +0000

description:
Drop unnecessary whitespace and .Pp, sort SEE ALSO, sort sections,
and some minor fixes.

diffstat:

 lib/libc/stdlib/abs.3         |   6 +-
 lib/libc/stdlib/alloca.3      |   6 +-
 lib/libc/stdlib/atoll.3       |   4 +-
 lib/libc/stdlib/bsearch.3     |   8 ++--
 lib/libc/stdlib/div.3         |   6 +-
 lib/libc/stdlib/getenv.3      |   6 +-
 lib/libc/stdlib/getopt.3      |   4 +-
 lib/libc/stdlib/getopt_long.3 |  49 ++++++++++++------------
 lib/libc/stdlib/getsubopt.3   |   4 +-
 lib/libc/stdlib/hcreate.3     |   8 +--
 lib/libc/stdlib/labs.3        |   6 +-
 lib/libc/stdlib/ldiv.3        |   6 +-
 lib/libc/stdlib/llabs.3       |   6 +-
 lib/libc/stdlib/lldiv.3       |   6 +-
 lib/libc/stdlib/malloc.3      |  83 +++++++++++++++++++++---------------------
 lib/libc/stdlib/qabs.3        |   6 +-
 lib/libc/stdlib/qsort.3       |   8 ++--
 lib/libc/stdlib/rand48.3      |  10 ++--
 lib/libc/stdlib/random.3      |   6 +-
 lib/libc/stdlib/strtod.3      |   6 +-
 lib/libc/stdlib/strtol.3      |   8 ++--
 lib/libc/stdlib/strtoul.3     |  12 +++---
 lib/libc/stdlib/system.3      |  14 +++---
 lib/libc/stdlib/tsearch.3     |  14 +++---
 24 files changed, 144 insertions(+), 148 deletions(-)

diffs (truncated from 871 to 300 lines):

diff -r ac8005db5f7b -r 79ad5bb83664 lib/libc/stdlib/abs.3
--- a/lib/libc/stdlib/abs.3     Sun Sep 16 01:09:18 2001 +0000
+++ b/lib/libc/stdlib/abs.3     Sun Sep 16 01:31:51 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: abs.3,v 1.7 2000/03/06 18:32:29 kleink Exp $
+.\"    $NetBSD: abs.3,v 1.8 2001/09/16 01:31:51 wiz Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -63,11 +63,11 @@
 returns
 the absolute value.
 .Sh SEE ALSO
+.Xr cabs 3 ,
 .Xr floor 3 ,
+.Xr hypot 3 ,
 .Xr labs 3 ,
 .Xr llabs 3 ,
-.Xr cabs 3 ,
-.Xr hypot 3 ,
 .Xr math 3
 .Sh STANDARDS
 The
diff -r ac8005db5f7b -r 79ad5bb83664 lib/libc/stdlib/alloca.3
--- a/lib/libc/stdlib/alloca.3  Sun Sep 16 01:09:18 2001 +0000
+++ b/lib/libc/stdlib/alloca.3  Sun Sep 16 01:31:51 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: alloca.3,v 1.7 1999/03/22 19:44:57 garbled Exp $
+.\"    $NetBSD: alloca.3,v 1.8 2001/09/16 01:31:51 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -49,7 +49,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
@@ -77,6 +77,6 @@
 .\" .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...
diff -r ac8005db5f7b -r 79ad5bb83664 lib/libc/stdlib/atoll.3
--- a/lib/libc/stdlib/atoll.3   Sun Sep 16 01:09:18 2001 +0000
+++ b/lib/libc/stdlib/atoll.3   Sun Sep 16 01:31:51 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: atoll.3,v 1.1 2000/03/06 18:32:29 kleink Exp $
+.\"    $NetBSD: atoll.3,v 1.2 2001/09/16 01:31:51 wiz Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -71,7 +71,7 @@
 .Xr strtod 3 ,
 .Xr strtol 3 ,
 .Xr strtoll 3 ,
-.Xr strtoul 3
+.Xr strtoul 3 ,
 .Xr strtoull 3
 .Sh STANDARDS
 The
diff -r ac8005db5f7b -r 79ad5bb83664 lib/libc/stdlib/bsearch.3
--- a/lib/libc/stdlib/bsearch.3 Sun Sep 16 01:09:18 2001 +0000
+++ b/lib/libc/stdlib/bsearch.3 Sun Sep 16 01:31:51 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: bsearch.3,v 1.6 1998/02/05 18:49:50 perry Exp $
+.\"    $NetBSD: bsearch.3,v 1.7 2001/09/16 01:31:51 wiz Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
@@ -54,12 +54,12 @@
 .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
@@ -86,7 +86,7 @@
 .Xr db 3 ,
 .Xr lsearch 3 ,
 .Xr qsort 3 ,
-.\" .Xr tsearch 3
+.Xr tsearch 3
 .Sh STANDARDS
 The
 .Fn bsearch
diff -r ac8005db5f7b -r 79ad5bb83664 lib/libc/stdlib/div.3
--- a/lib/libc/stdlib/div.3     Sun Sep 16 01:09:18 2001 +0000
+++ b/lib/libc/stdlib/div.3     Sun Sep 16 01:31:51 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: div.3,v 1.7 2000/03/06 18:32:30 kleink Exp $
+.\"    $NetBSD: div.3,v 1.8 2001/09/16 01:31:51 wiz Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -64,8 +64,8 @@
 .Sh SEE ALSO
 .Xr ldiv 3 ,
 .Xr lldiv 3 ,
-.Xr qdiv 3 ,
-.Xr math 3
+.Xr math 3 ,
+.Xr qdiv 3
 .Sh STANDARDS
 The
 .Fn div
diff -r ac8005db5f7b -r 79ad5bb83664 lib/libc/stdlib/getenv.3
--- a/lib/libc/stdlib/getenv.3  Sun Sep 16 01:09:18 2001 +0000
+++ b/lib/libc/stdlib/getenv.3  Sun Sep 16 01:31:51 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: getenv.3,v 1.10 1998/02/06 13:53:17 kleink Exp $
+.\"    $NetBSD: getenv.3,v 1.11 2001/09/16 01:31:51 wiz Exp $
 .\"
 .\" Copyright (c) 1988, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -67,7 +67,7 @@
 .Ar name
 and
 .Ar value
-may be appended and prepended, 
+may be appended and prepended,
 respectively,
 with an equal sign
 .Dq Li \&= .
@@ -90,7 +90,7 @@
 .Ar name
 does not exist in the list,
 it is inserted with the given
-.Ar value.
+.Ar value .
 If the variable does exist, the argument
 .Ar overwrite
 is tested; if
diff -r ac8005db5f7b -r 79ad5bb83664 lib/libc/stdlib/getopt.3
--- a/lib/libc/stdlib/getopt.3  Sun Sep 16 01:09:18 2001 +0000
+++ b/lib/libc/stdlib/getopt.3  Sun Sep 16 01:31:51 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: getopt.3,v 1.19 2000/01/25 23:22:49 elric Exp $
+.\"    $NetBSD: getopt.3,v 1.20 2001/09/16 01:31:51 wiz Exp $
 .\"
 .\" Copyright (c) 1988, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -170,7 +170,7 @@
 This is an extension to the
 .St -p1003.2
 specification.
-.Sh EXAMPLE
+.Sh EXAMPLES
 .Bd -literal -compact
 extern char *optarg;
 extern int optind;
diff -r ac8005db5f7b -r 79ad5bb83664 lib/libc/stdlib/getopt_long.3
--- a/lib/libc/stdlib/getopt_long.3     Sun Sep 16 01:09:18 2001 +0000
+++ b/lib/libc/stdlib/getopt_long.3     Sun Sep 16 01:31:51 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: getopt_long.3,v 1.4 2000/11/26 22:35:53 wiz Exp $
+.\"    $NetBSD: getopt_long.3,v 1.5 2001/09/16 01:31:52 wiz Exp $
 .\"
 .\" Copyright (c) 1988, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -35,7 +35,7 @@
 .\"
 .Dd April 1, 2000
 .Dt GETOPT_LONG 3
-.Os 
+.Os
 .Sh NAME
 .Nm getopt_long
 .Nd get long options from command line argument list
@@ -48,46 +48,46 @@
 .Sh DESCRIPTION
 The
 .Fn getopt_long
-function is similar to 
+function is similar to
 .Xr getopt 3
 but it accepts options in two forms: words and characters. The
 .Fn getopt_long
-function provides a superset of of the functionality of 
+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, 
+options. When used in this fashion,
 .Fn getopt_long
-behaves identically to 
+behaves identically to
 .Xr getopt 3 .
 This is a good way to add long option processing to an existing program
 with the minimum of rewriting.
 .Pp
-In the second mechanism, a long option sets a flag in the 
+In the second mechanism, a long option sets a flag in the
 .Fa option
 structure passed, or will store a pointer to the command line argument
-in the 
-.Fa option 
+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. 
+an equal sign, e.g.
 .Bd -literal
 myprogram --myoption=somevalue
 .Ed
 .Pp
-When a long option is processed the call to 
+When a long option is processed the call to
 .Fn getopt_long
 will return 0. For this reason, long option processing without
-shortcuts is not backwards compatible with 
+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.
 .Pp
-The 
+The
 .Fn getopt_long
 call requires a structure to be initialized describing the long
 options. The structure is:
@@ -100,11 +100,11 @@
 };
 .Ed
 .Pp
-The 
+The
 .Fa name
 field should contain the option name without the leading double dash.
 .Pp
-The 
+The
 .Fa has_arg
 field should be one of:
 .Bl -tag -width "optional_argument"
@@ -118,14 +118,14 @@
 .Pp
 If
 .Fa flag
-is non-NULL, then the integer pointed to by it will be set to the 
-value in the 
+is non-NULL, then the integer pointed to by it will be set to the
+value in the
 .Fa val
-field. If the 
-.Fa flag 
-field is NULL, then 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
@@ -174,7 +174,6 @@
 argv += optind;
 .Ed
 .Sh IMPLEMENTATION DIFFERENCES
-.Pp
 This section describes differences to the GNU implementation
 found in glibc-2.1.3:
 .Bl -tag -width "xxx"
@@ -210,7 +209,7 @@
 .It Li GNU
 parses this as option '-', option 'a'.
 .It Li NetBSD
-parses this as '--', and returns -1 (ignoring the a).  (Because 
+parses this as '--', and returns -1 (ignoring the a).  (Because
 the original getopt does.)
 .El
 .It Li o
@@ -227,7 +226,7 @@
 .It Li GNU
 causes a segfault.
 .It Li NetBSD
-returns -1, with optind pointing past the argument of -W 
+returns -1, with optind pointing past the argument of -W
 (as if `-W arg' were `--arg', and thus '--' had been found).