Document that behaviour is undefined if the argument isn't EOF or an unsigned

char.

13 files changed, 117 insertions, 13 deletions

diff --git a/lib/libc/gen/isalnum.3 b/lib/libc/gen/isalnum.3
index 54b310a0e50..9a38ec984d7 100644
--- a/lib/libc/gen/isalnum.3
+++ b/lib/libc/gen/isalnum.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isalnum.3,v 1.5 1999/07/09 13:35:17 aaron Exp $
+.\"	$OpenBSD: isalnum.3,v 1.6 2001/06/25 03:23:55 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -81,3 +81,11 @@ The
 .Fn isalnum
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn isalnum
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/isalpha.3 b/lib/libc/gen/isalpha.3
index 91da6e8fc81..2ea0904cc64 100644
--- a/lib/libc/gen/isalpha.3
+++ b/lib/libc/gen/isalpha.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isalpha.3,v 1.6 1999/07/09 13:35:17 aaron Exp $
+.\"	$OpenBSD: isalpha.3,v 1.7 2001/06/25 03:23:56 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -96,3 +96,11 @@ The
 .Fn isalpha
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn isalpha
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/isascii.3 b/lib/libc/gen/isascii.3
index a8d4f3f5a76..f4b089dbe36 100644
--- a/lib/libc/gen/isascii.3
+++ b/lib/libc/gen/isascii.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isascii.3,v 1.7 1999/07/09 13:35:17 aaron Exp $
+.\"	$OpenBSD: isascii.3,v 1.8 2001/06/25 03:23:57 pjanzen Exp $
 .\"
 .\" Copyright (c) 1989, 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -76,3 +76,11 @@ The
 .Fn isascii
 function conforms to
 .St -xpg4 .
+.Sh CAVEATS
+The argument to
+.Fn isascii
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/isblank.3 b/lib/libc/gen/isblank.3
index 706f0c0b269..c7e02704ff7 100644
--- a/lib/libc/gen/isblank.3
+++ b/lib/libc/gen/isblank.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isblank.3,v 1.6 1999/07/09 13:35:17 aaron Exp $
+.\"	$OpenBSD: isblank.3,v 1.7 2001/06/25 03:23:59 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -84,3 +84,11 @@ non-zero if the character tests true.
 .Xr tolower 3 ,
 .Xr toupper 3 ,
 .Xr ascii 7
+.Sh CAVEATS
+The argument to
+.Fn isblank
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/iscntrl.3 b/lib/libc/gen/iscntrl.3
index 1ade0167108..a20938ecbd0 100644
--- a/lib/libc/gen/iscntrl.3
+++ b/lib/libc/gen/iscntrl.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: iscntrl.3,v 1.5 1999/07/09 13:35:17 aaron Exp $
+.\"	$OpenBSD: iscntrl.3,v 1.6 2001/06/25 03:23:59 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -77,3 +77,11 @@ The
 .Fn iscntrl
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn iscntrl
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/isdigit.3 b/lib/libc/gen/isdigit.3
index 11caef61a6b..e475fde3a35 100644
--- a/lib/libc/gen/isdigit.3
+++ b/lib/libc/gen/isdigit.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isdigit.3,v 1.5 1999/07/09 13:35:17 aaron Exp $
+.\"	$OpenBSD: isdigit.3,v 1.6 2001/06/25 03:24:00 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -77,3 +77,11 @@ The
 .Fn isdigit
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn isdigit
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/isgraph.3 b/lib/libc/gen/isgraph.3
index 89dc7abaaa8..872e717026b 100644
--- a/lib/libc/gen/isgraph.3
+++ b/lib/libc/gen/isgraph.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isgraph.3,v 1.5 1999/07/09 13:35:18 aaron Exp $
+.\"	$OpenBSD: isgraph.3,v 1.6 2001/06/25 03:24:01 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -78,3 +78,11 @@ The
 .Fn isgraph
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn isgraph
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/islower.3 b/lib/libc/gen/islower.3
index 404936408ac..4b12a19f776 100644
--- a/lib/libc/gen/islower.3
+++ b/lib/libc/gen/islower.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: islower.3,v 1.6 1999/07/09 13:35:18 aaron Exp $
+.\"	$OpenBSD: islower.3,v 1.7 2001/06/25 03:24:01 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -89,3 +89,11 @@ The
 .Fn islower
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn islower
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/isprint.3 b/lib/libc/gen/isprint.3
index 302836c7076..c4225f25557 100644
--- a/lib/libc/gen/isprint.3
+++ b/lib/libc/gen/isprint.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isprint.3,v 1.5 1999/07/09 13:35:18 aaron Exp $
+.\"	$OpenBSD: isprint.3,v 1.6 2001/06/25 03:24:02 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -78,3 +78,11 @@ The
 .Fn isprint
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn isprint
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/ispunct.3 b/lib/libc/gen/ispunct.3
index 518bdc35133..85548f0a850 100644
--- a/lib/libc/gen/ispunct.3
+++ b/lib/libc/gen/ispunct.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ispunct.3,v 1.5 1999/07/09 13:35:18 aaron Exp $
+.\"	$OpenBSD: ispunct.3,v 1.6 2001/06/25 03:24:03 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -81,3 +81,11 @@ The
 .Fn ispunct
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn ispunct
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/isspace.3 b/lib/libc/gen/isspace.3
index 5ce6692cc81..90a75ab1b9e 100644
--- a/lib/libc/gen/isspace.3
+++ b/lib/libc/gen/isspace.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isspace.3,v 1.7 2000/03/04 22:19:31 aaron Exp $
+.\"	$OpenBSD: isspace.3,v 1.8 2001/06/25 03:24:03 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -102,3 +102,11 @@ The
 .Fn isspace
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn isspace
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/isupper.3 b/lib/libc/gen/isupper.3
index bdaf741f0ee..c2d31dfcad5 100644
--- a/lib/libc/gen/isupper.3
+++ b/lib/libc/gen/isupper.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isupper.3,v 1.6 1999/07/09 13:35:18 aaron Exp $
+.\"	$OpenBSD: isupper.3,v 1.7 2001/06/25 03:24:04 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -87,3 +87,11 @@ The
 .Xr isupper
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn isupper
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.
diff --git a/lib/libc/gen/isxdigit.3 b/lib/libc/gen/isxdigit.3
index 63eec860c04..976945d2b29 100644
--- a/lib/libc/gen/isxdigit.3
+++ b/lib/libc/gen/isxdigit.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isxdigit.3,v 1.5 1999/07/09 13:35:18 aaron Exp $
+.\"	$OpenBSD: isxdigit.3,v 1.6 2001/06/25 03:24:04 pjanzen Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -77,3 +77,11 @@ The
 .Fn isxdigit
 function conforms to
 .St -ansiC .
+.Sh CAVEATS
+The argument to
+.Fn isxdigit
+must be
+.Dv EOF
+or representable as an
+.Li unsigned char ;
+otherwise, the result is undefined.