[src/trunk]: src/lib/libc/gen Add CAVEATS section similar to is*(3) ones. Bum...

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

details:   https://anonhg.NetBSD.org/src/rev/82cd25bb3663
branches:  trunk
changeset: 572201:82cd25bb3663
user:      wiz <wiz%NetBSD.org@localhost>
date:      Fri Dec 24 02:47:16 2004 +0000

description:
Add CAVEATS section similar to is*(3) ones. Bump date.
Fix typo in toascii.3 while here.
kleink says "ok".

diffstat:

 lib/libc/gen/toascii.3 |  14 +++++++++++---
 lib/libc/gen/tolower.3 |  12 ++++++++++--
 lib/libc/gen/toupper.3 |  12 ++++++++++--
 3 files changed, 31 insertions(+), 7 deletions(-)

diffs (94 lines):

diff -r 188ce49c056c -r 82cd25bb3663 lib/libc/gen/toascii.3
--- a/lib/libc/gen/toascii.3    Thu Dec 23 23:14:05 2004 +0000
+++ b/lib/libc/gen/toascii.3    Fri Dec 24 02:47:16 2004 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: toascii.3,v 1.8 2003/08/07 16:42:58 agc Exp $
+.\"    $NetBSD: toascii.3,v 1.9 2004/12/24 02:47:16 wiz Exp $
 .\"
 .\" Copyright (c) 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"    @(#)toascii.3   8.1 (Berkeley) 6/4/93
 .\"
-.Dd June 4, 1993
+.Dd December 24, 2004
 .Dt TOASCII 3
 .Os
 .Sh NAME
@@ -69,6 +69,14 @@
 .Xr ascii 7
 .Sh STANDARDS
 The
-.Fn isascii
+.Fn toascii
 function conforms to
 .St -xpg4 .
+.Sh CAVEATS
+The argument to
+.Fn toascii
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff -r 188ce49c056c -r 82cd25bb3663 lib/libc/gen/tolower.3
--- a/lib/libc/gen/tolower.3    Thu Dec 23 23:14:05 2004 +0000
+++ b/lib/libc/gen/tolower.3    Fri Dec 24 02:47:16 2004 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: tolower.3,v 1.10 2003/08/07 16:42:58 agc Exp $
+.\"    $NetBSD: tolower.3,v 1.11 2004/12/24 02:47:16 wiz Exp $
 .\"
 .\" Copyright (c) 1989, 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -33,7 +33,7 @@
 .\"
 .\"    @(#)tolower.3   5.2 (Berkeley) 6/29/91
 .\"
-.Dd June 29, 1991
+.Dd December 24, 2004
 .Dt TOLOWER 3
 .Os
 .Sh NAME
@@ -86,3 +86,11 @@
 .Fn tolower
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn tolower
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff -r 188ce49c056c -r 82cd25bb3663 lib/libc/gen/toupper.3
--- a/lib/libc/gen/toupper.3    Thu Dec 23 23:14:05 2004 +0000
+++ b/lib/libc/gen/toupper.3    Fri Dec 24 02:47:16 2004 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: toupper.3,v 1.13 2003/08/07 16:42:58 agc Exp $
+.\"    $NetBSD: toupper.3,v 1.14 2004/12/24 02:47:16 wiz Exp $
 .\"
 .\" Copyright (c) 1989, 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -33,7 +33,7 @@
 .\"
 .\"    @(#)toupper.3   5.2 (Berkeley) 6/29/91
 .\"
-.Dd June 29, 1991
+.Dd December 24, 2004
 .Dt TOUPPER 3
 .Os
 .Sh NAME
@@ -85,3 +85,11 @@
 .Fn toupper
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn toupper
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.