From b5f0d0d8f20813c2d455d7c7558ba9f1262f14df Mon Sep 17 00:00:00 2001
From: tjr <tjr@FreeBSD.org>
Date: Sun, 6 Oct 2002 10:15:38 +0000
Subject: Add a note to the Compatiblity section suggesting that these
 functions only be used for byte values. Add cross-references to the wide-char
 counterparts.

---
 lib/libc/locale/isalnum.3  | 14 +++++++++++++-
 lib/libc/locale/isalpha.3  | 14 +++++++++++++-
 lib/libc/locale/isascii.3  |  3 ++-
 lib/libc/locale/isblank.3  | 14 +++++++++++++-
 lib/libc/locale/iscntrl.3  | 14 +++++++++++++-
 lib/libc/locale/isdigit.3  | 14 +++++++++++++-
 lib/libc/locale/isgraph.3  | 14 +++++++++++++-
 lib/libc/locale/islower.3  | 14 +++++++++++++-
 lib/libc/locale/isprint.3  | 14 +++++++++++++-
 lib/libc/locale/ispunct.3  | 14 +++++++++++++-
 lib/libc/locale/isspace.3  | 14 +++++++++++++-
 lib/libc/locale/isupper.3  | 14 +++++++++++++-
 lib/libc/locale/isxdigit.3 | 18 +++++++++++++++++-
 13 files changed, 162 insertions(+), 13 deletions(-)

(limited to 'lib/libc/locale')

diff --git a/lib/libc/locale/isalnum.3 b/lib/libc/locale/isalnum.3
index 7e460d4..5cc0f8c 100644
--- a/lib/libc/locale/isalnum.3
+++ b/lib/libc/locale/isalnum.3
@@ -36,7 +36,7 @@
 .\"     @(#)isalnum.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISALNUM 3
 .Os
 .Sh NAME
@@ -88,10 +88,22 @@ The
 .Fn isalnum
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn isalnum
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iswalnum
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr isalpha 3 ,
 .Xr isdigit 3 ,
+.Xr iswalnum 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS
diff --git a/lib/libc/locale/isalpha.3 b/lib/libc/locale/isalpha.3
index 27405d0..2f6cacf 100644
--- a/lib/libc/locale/isalpha.3
+++ b/lib/libc/locale/isalpha.3
@@ -36,7 +36,7 @@
 .\"     @(#)isalpha.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISALPHA 3
 .Os
 .Sh NAME
@@ -86,10 +86,22 @@ The
 .Fn isalpha
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn isalpha
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iswalpha
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr islower 3 ,
 .Xr isupper 3 ,
+.Xr iswalpha 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS
diff --git a/lib/libc/locale/isascii.3 b/lib/libc/locale/isascii.3
index 8079d0d..a031d8b 100644
--- a/lib/libc/locale/isascii.3
+++ b/lib/libc/locale/isascii.3
@@ -32,7 +32,7 @@
 .\"     @(#)isascii.3	8.2 (Berkeley) 12/11/93
 .\" $FreeBSD$
 .\"
-.Dd December 11, 1993
+.Dd October 6, 2002
 .Dt ISASCII 3
 .Os
 .Sh NAME
@@ -53,4 +53,5 @@ character, which is any character
 between 0 and octal 0177 inclusive.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswascii 3 ,
 .Xr ascii 7
diff --git a/lib/libc/locale/isblank.3 b/lib/libc/locale/isblank.3
index 7c920f4..12e54a0 100644
--- a/lib/libc/locale/isblank.3
+++ b/lib/libc/locale/isblank.3
@@ -32,7 +32,7 @@
 .\"     @(#)isblank.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISBLANK 3
 .Os
 .Sh NAME
@@ -66,6 +66,17 @@ representable as an
 .Li unsigned char
 or the value of
 .Dv EOF .
+.Sh COMPATIBILITY
+Although
+.Fn isblank
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iswblank
+function should be used instead for maximum portability.
 .Sh RETURN VALUES
 The
 .Fn isblank
@@ -73,6 +84,7 @@ function returns zero if the character tests false and
 returns non-zero if the character tests true.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswblank 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS
diff --git a/lib/libc/locale/iscntrl.3 b/lib/libc/locale/iscntrl.3
index 070fb9e..194b955 100644
--- a/lib/libc/locale/iscntrl.3
+++ b/lib/libc/locale/iscntrl.3
@@ -36,7 +36,7 @@
 .\"     @(#)iscntrl.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISCNTRL 3
 .Os
 .Sh NAME
@@ -78,8 +78,20 @@ The
 .Fn iscntrl
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn iscntrl
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iwcntrl
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswcntrl 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS
diff --git a/lib/libc/locale/isdigit.3 b/lib/libc/locale/isdigit.3
index 5d34e0c..bb7dd72 100644
--- a/lib/libc/locale/isdigit.3
+++ b/lib/libc/locale/isdigit.3
@@ -36,7 +36,7 @@
 .\"     @(#)isdigit.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISDIGIT 3
 .Os
 .Sh NAME
@@ -76,8 +76,20 @@ The
 .Fn isdigit
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn isdigit
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iswdigit
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswdigit 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS
diff --git a/lib/libc/locale/isgraph.3 b/lib/libc/locale/isgraph.3
index 607e184..e78522c 100644
--- a/lib/libc/locale/isgraph.3
+++ b/lib/libc/locale/isgraph.3
@@ -36,7 +36,7 @@
 .\"     @(#)isgraph.3	8.2 (Berkeley) 12/11/93
 .\" $FreeBSD$
 .\"
-.Dd December 11, 1993
+.Dd October 6, 2002
 .Dt ISGRAPH 3
 .Os
 .Sh NAME
@@ -93,8 +93,20 @@ The
 .Fn isgraph
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn isgraph
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iswgraph
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswgraph 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS
diff --git a/lib/libc/locale/islower.3 b/lib/libc/locale/islower.3
index 9cf8757..8f7b1e0 100644
--- a/lib/libc/locale/islower.3
+++ b/lib/libc/locale/islower.3
@@ -36,7 +36,7 @@
 .\"     @(#)islower.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISLOWER 3
 .Os
 .Sh NAME
@@ -77,8 +77,20 @@ The
 .Fn islower
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn islower
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iswlower
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswlower 3 ,
 .Xr multibyte 3 ,
 .Xr tolower 3 ,
 .Xr ascii 7
diff --git a/lib/libc/locale/isprint.3 b/lib/libc/locale/isprint.3
index be2c773..825d06e 100644
--- a/lib/libc/locale/isprint.3
+++ b/lib/libc/locale/isprint.3
@@ -36,7 +36,7 @@
 .\"     @(#)isprint.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISPRINT 3
 .Os
 .Sh NAME
@@ -91,8 +91,20 @@ The
 .Fn isprint
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn isprint
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iswprint
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswprint 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS
diff --git a/lib/libc/locale/ispunct.3 b/lib/libc/locale/ispunct.3
index 9665c00..05a8769 100644
--- a/lib/libc/locale/ispunct.3
+++ b/lib/libc/locale/ispunct.3
@@ -36,7 +36,7 @@
 .\"	@(#)ispunct.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISPUNCT 3
 .Os
 .Sh NAME
@@ -83,8 +83,20 @@ The
 .Fn ispunct
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn ispunct
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iswpunct
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswpunct 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS
diff --git a/lib/libc/locale/isspace.3 b/lib/libc/locale/isspace.3
index a6cc219..e286b69 100644
--- a/lib/libc/locale/isspace.3
+++ b/lib/libc/locale/isspace.3
@@ -36,7 +36,7 @@
 .\"     @(#)isspace.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISSPACE 3
 .Os
 .Sh NAME
@@ -75,8 +75,20 @@ The
 .Fn isspace
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn isspace
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iswspace
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswspace 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS
diff --git a/lib/libc/locale/isupper.3 b/lib/libc/locale/isupper.3
index ec43a7a..3fb903e 100644
--- a/lib/libc/locale/isupper.3
+++ b/lib/libc/locale/isupper.3
@@ -36,7 +36,7 @@
 .\"     @(#)isupper.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISUPPER 3
 .Os
 .Sh NAME
@@ -77,8 +77,20 @@ The
 .Fn isupper
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn isupper
+accepts arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn iswupper
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswupper 3 ,
 .Xr multibyte 3 ,
 .Xr toupper 3 ,
 .Xr ascii 7
diff --git a/lib/libc/locale/isxdigit.3 b/lib/libc/locale/isxdigit.3
index aa54ad2..661b7fb 100644
--- a/lib/libc/locale/isxdigit.3
+++ b/lib/libc/locale/isxdigit.3
@@ -36,7 +36,7 @@
 .\"     @(#)isxdigit.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd June 4, 1993
+.Dd October 6, 2002
 .Dt ISXDIGIT 3
 .Os
 .Sh NAME
@@ -78,8 +78,24 @@ The
 .Fn isxdigit
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+Although
+.Fn isxdigit
+and
+.Fn ishexnumber
+accept arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets,
+this is a
+.Bx 4.4
+extension and the
+.Fn isxwdigit
+and
+.Fn iswhexnumber
+functions should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr iswxdigit 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS
-- 
cgit v1.1