[src/trunk]: src/lib/libc Add some STANDARDS lingo, mainly to note the functi...

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

details:   https://anonhg.NetBSD.org/src/rev/f6d976571e57
branches:  trunk
changeset: 754378:f6d976571e57
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Thu Apr 29 06:54:26 2010 +0000

description:
Add some STANDARDS lingo, mainly to note the functions that have been
removed from POSIX (2008).

diffstat:

 lib/libc/gen/getcwd.3    |  22 ++++++++++++++++++----
 lib/libc/stdio/mktemp.3  |  23 +++++++++++++++++++----
 lib/libc/string/bcmp.3   |  19 +++++++++++++++++--
 lib/libc/string/bcopy.3  |  14 ++++++++++++--
 lib/libc/string/bzero.3  |  19 +++++++++++++++++--
 lib/libc/string/index.3  |  19 +++++++++++++++++--
 lib/libc/string/rindex.3 |  19 +++++++++++++++++--
 7 files changed, 117 insertions(+), 18 deletions(-)

diffs (273 lines):

diff -r 2c959887f3b8 -r f6d976571e57 lib/libc/gen/getcwd.3
--- a/lib/libc/gen/getcwd.3     Thu Apr 29 06:53:48 2010 +0000
+++ b/lib/libc/gen/getcwd.3     Thu Apr 29 06:54:26 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: getcwd.3,v 1.17 2010/03/22 19:30:53 joerg Exp $
+.\"    $NetBSD: getcwd.3,v 1.18 2010/04/29 06:54:26 jruoho Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)getcwd.3   8.2 (Berkeley) 12/11/93
 .\"
-.Dd December 11, 1993
+.Dd April 29, 2010
 .Dt GETCWD 3
 .Os
 .Sh NAME
@@ -132,10 +132,24 @@
 .Xr strerror 3
 .Sh STANDARDS
 The
+.Fn getwd
+and
 .Fn getcwd
-function
-conforms to
+functions conform to
 .St -p1003.1-90 .
+The
+.St -p1003.1-2004
+revision marked
+.Fn getwd
+as legacy and recommended the use of
+.Fn getcwd
+instead.
+The
+.St -p1003.1-2008
+revision removed
+.Fn getwd
+from the specification.
+.Pp
 The ability to specify a
 .Dv NULL
 pointer and have
diff -r 2c959887f3b8 -r f6d976571e57 lib/libc/stdio/mktemp.3
--- a/lib/libc/stdio/mktemp.3   Thu Apr 29 06:53:48 2010 +0000
+++ b/lib/libc/stdio/mktemp.3   Thu Apr 29 06:54:26 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: mktemp.3,v 1.25 2006/08/04 20:55:45 jld Exp $
+.\"    $NetBSD: mktemp.3,v 1.26 2010/04/29 06:54:26 jruoho Exp $
 .\"
 .\" Copyright (c) 1989, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)mktemp.3   8.1 (Berkeley) 6/4/93
 .\"
-.Dd July 28, 1998
+.Dd April 29, 2010
 .Dt MKTEMP 3
 .Os
 .Sh NAME
@@ -249,6 +249,23 @@
 .Xr open 2 ,
 .Xr stat 2 ,
 .Xr umask 2
+.Sh STANDARDS
+The
+.Fn mktemp
+conforms to
+.St -p1003.1-2001 .
+It was however removed from the specification in the
+.St -p1003.1-2008
+revision.
+The
+.Fn mkstemp
+and
+.Fn mkdtemp
+conform to
+.St -p1003.1-2004
+and
+.St -p1003.1-2008 ,
+respectively.
 .Sh HISTORY
 A
 .Fn mktemp
@@ -310,5 +327,3 @@
 or
 .Fn mkdtemp
 instead.
-.\" .SH STANDARDS
-.\" .St -p1003.1-2003
diff -r 2c959887f3b8 -r f6d976571e57 lib/libc/string/bcmp.3
--- a/lib/libc/string/bcmp.3    Thu Apr 29 06:53:48 2010 +0000
+++ b/lib/libc/string/bcmp.3    Thu Apr 29 06:54:26 2010 +0000
@@ -28,9 +28,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)bcmp.3       8.1 (Berkeley) 6/4/93
-.\"    $NetBSD: bcmp.3,v 1.12 2003/08/07 16:43:46 agc Exp $
+.\"    $NetBSD: bcmp.3,v 1.13 2010/04/29 06:54:26 jruoho Exp $
 .\"
-.Dd June 4, 1993
+.Dd April 29, 2010
 .Dt BCMP 3
 .Os
 .Sh NAME
@@ -63,6 +63,21 @@
 .Xr strcmp 3 ,
 .Xr strcoll 3 ,
 .Xr strxfrm 3
+.Sh STANDARDS
+The
+.Fn bcmp
+function conforms to
+.St -p1003.1-2001 .
+The
+.St -p1003.1-2004
+revision marked it as legacy and recommended the use of
+.Xr memcmp 3
+instead.
+The
+.St -p1003.1-2008
+revision removed
+.Fn bcmp
+from the specification.
 .Sh HISTORY
 A
 .Fn bcmp
diff -r 2c959887f3b8 -r f6d976571e57 lib/libc/string/bcopy.3
--- a/lib/libc/string/bcopy.3   Thu Apr 29 06:53:48 2010 +0000
+++ b/lib/libc/string/bcopy.3   Thu Apr 29 06:54:26 2010 +0000
@@ -29,9 +29,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)bcopy.3      8.1 (Berkeley) 6/4/93
-.\"    $NetBSD: bcopy.3,v 1.11 2003/08/07 16:43:47 agc Exp $
+.\"    $NetBSD: bcopy.3,v 1.12 2010/04/29 06:54:26 jruoho Exp $
 .\"
-.Dd June 4, 1993
+.Dd April 29, 2010
 .Dt BCOPY 3
 .Os
 .Sh NAME
@@ -63,6 +63,16 @@
 .Xr memmove 3 ,
 .Xr strcpy 3 ,
 .Xr strncpy 3
+.Sh STANDARDS
+The
+.Fn bcmp
+function conforms to
+.St -p1003.1-2001 .
+The
+.St -p1003.1-2004
+revision marked it as legacy the
+.St -p1003.1-2008
+revision removed it from the specification.
 .Sh HISTORY
 A
 .Fn bcopy
diff -r 2c959887f3b8 -r f6d976571e57 lib/libc/string/bzero.3
--- a/lib/libc/string/bzero.3   Thu Apr 29 06:53:48 2010 +0000
+++ b/lib/libc/string/bzero.3   Thu Apr 29 06:54:26 2010 +0000
@@ -29,9 +29,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)bzero.3      8.1 (Berkeley) 6/4/93
-.\"    $NetBSD: bzero.3,v 1.12 2003/08/07 16:43:47 agc Exp $
+.\"    $NetBSD: bzero.3,v 1.13 2010/04/29 06:54:26 jruoho Exp $
 .\"
-.Dd June 4, 1993
+.Dd April 29, 2010
 .Dt BZERO 3
 .Os
 .Sh NAME
@@ -59,6 +59,21 @@
 .Sh SEE ALSO
 .Xr memset 3 ,
 .Xr swab 3
+.Sh STANDARDS
+The
+.Fn bzero
+function conforms to
+.St -p1003.1-2001 .
+The
+.St -p1003.1-2004
+revision marked it as legacy and recommended the use of
+.Xr memset 3
+instead.
+The
+.St -p1003.1-2008
+revision removed
+.Fn bzero
+from the specification.
 .Sh HISTORY
 A
 .Fn bzero
diff -r 2c959887f3b8 -r f6d976571e57 lib/libc/string/index.3
--- a/lib/libc/string/index.3   Thu Apr 29 06:53:48 2010 +0000
+++ b/lib/libc/string/index.3   Thu Apr 29 06:54:26 2010 +0000
@@ -28,9 +28,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)index.3      8.1 (Berkeley) 6/4/93
-.\"    $NetBSD: index.3,v 1.12 2006/10/16 08:48:45 wiz Exp $
+.\"    $NetBSD: index.3,v 1.13 2010/04/29 06:54:26 jruoho Exp $
 .\"
-.Dd June 4, 1993
+.Dd April 29, 2010
 .Dt INDEX 3
 .Os
 .Sh NAME
@@ -72,6 +72,21 @@
 .Xr strspn 3 ,
 .Xr strstr 3 ,
 .Xr strtok 3
+.Sh STANDARDS
+The
+.Fn index
+function conforms to
+.St -p1003.1-2001 .
+The
+.St -p1003.1-2004
+revision marked it as legacy and recommended the use of
+.Xr strchr 3
+instead.
+The
+.St -p1003.1-2008
+revision removed
+.Fn index
+from the specification.
 .Sh HISTORY
 An
 .Fn index
diff -r 2c959887f3b8 -r f6d976571e57 lib/libc/string/rindex.3
--- a/lib/libc/string/rindex.3  Thu Apr 29 06:53:48 2010 +0000
+++ b/lib/libc/string/rindex.3  Thu Apr 29 06:54:26 2010 +0000
@@ -28,9 +28,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)rindex.3     8.1 (Berkeley) 6/4/93
-.\"    $NetBSD: rindex.3,v 1.11 2006/10/16 08:48:45 wiz Exp $
+.\"    $NetBSD: rindex.3,v 1.12 2010/04/29 06:54:26 jruoho Exp $
 .\"
-.Dd June 4, 1993
+.Dd April 29, 2010
 .Dt RINDEX 3
 .Os
 .Sh NAME
@@ -75,6 +75,21 @@
 .Xr strspn 3 ,
 .Xr strstr 3 ,
 .Xr strtok 3
+.Sh STANDARDS
+The
+.Fn rindex
+function conforms to
+.St -p1003.1-2001 .
+The
+.St -p1003.1-2004
+revision marked it as legacy and recommended the use of
+.Xr strrchr 3
+instead.
+The
+.St -p1003.1-2008
+revision removed
+.Fn rindex
+from the specification.
 .Sh HISTORY
 A
 .Fn rindex