Re-word the COMPATIBILITY section, taking care to use the word "deprecated"

to describe the 4.4BSD extension of accepting arguments outside the range
of unsigned char. This gives us freedom to remove this extension when we
remove the <rune.h> interface in FreeBSD 6.

12 files changed, 74 insertions, 98 deletions

diff --git a/lib/libc/locale/isalnum.3 b/lib/libc/locale/isalnum.3
index 5cc0f8c..643a979 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 October 6, 2002
+.Dd July 30, 2004
 .Dt ISALNUM 3
 .Os
 .Sh NAME
@@ -89,14 +89,12 @@ The
 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
+The
 .Bx 4.4
-extension and the
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
 .Fn iswalnum
 function should be used instead for maximum portability.
 .Sh SEE ALSO
diff --git a/lib/libc/locale/isalpha.3 b/lib/libc/locale/isalpha.3
index 2f6cacf..2e1ead2 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 October 6, 2002
+.Dd July 30, 2004
 .Dt ISALPHA 3
 .Os
 .Sh NAME
@@ -87,14 +87,12 @@ The
 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
+The
 .Bx 4.4
-extension and the
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
 .Fn iswalpha
 function should be used instead for maximum portability.
 .Sh SEE ALSO
diff --git a/lib/libc/locale/isblank.3 b/lib/libc/locale/isblank.3
index 5fdc2ae..d8bfb8e 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 October 6, 2002
+.Dd July 30, 2004
 .Dt ISBLANK 3
 .Os
 .Sh NAME
@@ -67,14 +67,12 @@ representable as an
 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
+The
 .Bx 4.4
-extension and the
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
 .Fn iswblank
 function should be used instead for maximum portability.
 .Sh RETURN VALUES
diff --git a/lib/libc/locale/iscntrl.3 b/lib/libc/locale/iscntrl.3
index 417820b..d3ea5aa 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 October 6, 2002
+.Dd July 30, 2004
 .Dt ISCNTRL 3
 .Os
 .Sh NAME
@@ -79,15 +79,13 @@ The
 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
+The
 .Bx 4.4
-extension and the
-.Fn iwcntrl
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
+.Fn iswcntrl
 function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
diff --git a/lib/libc/locale/isdigit.3 b/lib/libc/locale/isdigit.3
index 42503ad..1d5eadd 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 March 30, 2004
+.Dd July 30, 2004
 .Dt ISDIGIT 3
 .Os
 .Sh NAME
@@ -85,14 +85,12 @@ and
 functions return 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
+The
 .Bx 4.4
-extension and the
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
 .Fn iswdigit
 function should be used instead for maximum portability.
 .Sh SEE ALSO
diff --git a/lib/libc/locale/isgraph.3 b/lib/libc/locale/isgraph.3
index e78522c..39da046 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 October 6, 2002
+.Dd July 30, 2004
 .Dt ISGRAPH 3
 .Os
 .Sh NAME
@@ -94,14 +94,12 @@ The
 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
+The
 .Bx 4.4
-extension and the
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
 .Fn iswgraph
 function should be used instead for maximum portability.
 .Sh SEE ALSO
diff --git a/lib/libc/locale/islower.3 b/lib/libc/locale/islower.3
index 8f7b1e0..5a818d7 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 October 6, 2002
+.Dd July 30, 2004
 .Dt ISLOWER 3
 .Os
 .Sh NAME
@@ -78,14 +78,12 @@ The
 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
+The
 .Bx 4.4
-extension and the
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
 .Fn iswlower
 function should be used instead for maximum portability.
 .Sh SEE ALSO
diff --git a/lib/libc/locale/isprint.3 b/lib/libc/locale/isprint.3
index 825d06e..ace183a 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 October 6, 2002
+.Dd July 30, 2004
 .Dt ISPRINT 3
 .Os
 .Sh NAME
@@ -92,14 +92,12 @@ The
 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
+The
 .Bx 4.4
-extension and the
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
 .Fn iswprint
 function should be used instead for maximum portability.
 .Sh SEE ALSO
diff --git a/lib/libc/locale/ispunct.3 b/lib/libc/locale/ispunct.3
index 05a8769..96b2c4f 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 October 6, 2002
+.Dd July 30, 2004
 .Dt ISPUNCT 3
 .Os
 .Sh NAME
@@ -84,14 +84,12 @@ The
 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
+The
 .Bx 4.4
-extension and the
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
 .Fn iswpunct
 function should be used instead for maximum portability.
 .Sh SEE ALSO
diff --git a/lib/libc/locale/isspace.3 b/lib/libc/locale/isspace.3
index e286b69..a808371 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 October 6, 2002
+.Dd July 30, 2004
 .Dt ISSPACE 3
 .Os
 .Sh NAME
@@ -76,14 +76,12 @@ The
 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
+The
 .Bx 4.4
-extension and the
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
 .Fn iswspace
 function should be used instead for maximum portability.
 .Sh SEE ALSO
diff --git a/lib/libc/locale/isupper.3 b/lib/libc/locale/isupper.3
index 3fb903e..c3c187a 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 October 6, 2002
+.Dd July 30, 2004
 .Dt ISUPPER 3
 .Os
 .Sh NAME
@@ -78,14 +78,12 @@ The
 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
+The
 .Bx 4.4
-extension and the
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
 .Fn iswupper
 function should be used instead for maximum portability.
 .Sh SEE ALSO
diff --git a/lib/libc/locale/isxdigit.3 b/lib/libc/locale/isxdigit.3
index 04745ab..4019d69 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 March 30, 2004
+.Dd July 30, 2004
 .Dt ISXDIGIT 3
 .Os
 .Sh NAME
@@ -86,15 +86,13 @@ The
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
 .Sh COMPATIBILITY
-Although
-.Fn isxdigit
-accepts arguments outside of the range of the
-.Vt "unsigned char"
-type in locales with large character sets,
-this is a
+The
 .Bx 4.4
-extension and the
-.Fn isxwdigit
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is deprecated.
+The
+.Fn iswxdigit
 function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,