Re-word compatibility section, taking care to use the word "obsolete" to

describe the 4.4BSD extension of accepting characters (runes) outside of
the range of unsigned char.

14 files changed, 64 insertions, 54 deletions

diff --git a/lib/libc/locale/isalnum.3 b/lib/libc/locale/isalnum.3
index 643a979..b87c5bd 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISALNUM 3
 .Os
 .Sh NAME
@@ -93,10 +93,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswalnum
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr isalpha 3 ,
diff --git a/lib/libc/locale/isalpha.3 b/lib/libc/locale/isalpha.3
index 2e1ead2..7ab4e3a 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISALPHA 3
 .Os
 .Sh NAME
@@ -91,10 +91,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswalpha
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr islower 3 ,
diff --git a/lib/libc/locale/isblank.3 b/lib/libc/locale/isblank.3
index d8bfb8e..3b269bf 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISBLANK 3
 .Os
 .Sh NAME
@@ -71,10 +71,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswblank
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh RETURN VALUES
 The
 .Fn isblank
diff --git a/lib/libc/locale/iscntrl.3 b/lib/libc/locale/iscntrl.3
index d3ea5aa..8e1e4e4 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISCNTRL 3
 .Os
 .Sh NAME
@@ -83,10 +83,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswcntrl
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswcntrl 3 ,
diff --git a/lib/libc/locale/isdigit.3 b/lib/libc/locale/isdigit.3
index 1d5eadd..483041f 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISDIGIT 3
 .Os
 .Sh NAME
@@ -89,10 +89,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswdigit
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswdigit 3 ,
diff --git a/lib/libc/locale/isgraph.3 b/lib/libc/locale/isgraph.3
index 39da046..e4e2c62 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISGRAPH 3
 .Os
 .Sh NAME
@@ -98,10 +98,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswgraph
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswgraph 3 ,
diff --git a/lib/libc/locale/islower.3 b/lib/libc/locale/islower.3
index 5a818d7..57ee9a9 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISLOWER 3
 .Os
 .Sh NAME
@@ -82,10 +82,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswlower
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswlower 3 ,
diff --git a/lib/libc/locale/isprint.3 b/lib/libc/locale/isprint.3
index ace183a..99133ea 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISPRINT 3
 .Os
 .Sh NAME
@@ -96,10 +96,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswprint
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswprint 3 ,
diff --git a/lib/libc/locale/ispunct.3 b/lib/libc/locale/ispunct.3
index 96b2c4f..c5ef60f 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISPUNCT 3
 .Os
 .Sh NAME
@@ -88,10 +88,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswpunct
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswpunct 3 ,
diff --git a/lib/libc/locale/isspace.3 b/lib/libc/locale/isspace.3
index a808371..db2775f 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISSPACE 3
 .Os
 .Sh NAME
@@ -80,10 +80,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswspace
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswspace 3 ,
diff --git a/lib/libc/locale/isupper.3 b/lib/libc/locale/isupper.3
index c3c187a..c1fe632 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISUPPER 3
 .Os
 .Sh NAME
@@ -82,10 +82,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswupper
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswupper 3 ,
diff --git a/lib/libc/locale/isxdigit.3 b/lib/libc/locale/isxdigit.3
index 4019d69..9dc3400 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 July 30, 2004
+.Dd August 21, 2004
 .Dt ISXDIGIT 3
 .Os
 .Sh NAME
@@ -90,10 +90,11 @@ The
 .Bx 4.4
 extension of accepting arguments outside of the range of the
 .Vt "unsigned char"
-type in locales with large character sets is deprecated.
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
 The
 .Fn iswxdigit
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswxdigit 3 ,
diff --git a/lib/libc/locale/tolower.3 b/lib/libc/locale/tolower.3
index 394895e..47dfb44 100644
--- a/lib/libc/locale/tolower.3
+++ b/lib/libc/locale/tolower.3
@@ -36,7 +36,7 @@
 .\"	@(#)tolower.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd October 3, 2002
+.Dd August 21, 2004
 .Dt TOLOWER 3
 .Os
 .Sh NAME
@@ -68,16 +68,15 @@ If the argument is an upper-case letter, the
 function returns the corresponding lower-case letter if there is
 one; otherwise the argument is returned unchanged.
 .Sh COMPATIBILITY
-Although
-.Fn tolower
-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 considered obsolete
+and may not be supported in future releases.
+The
 .Fn towlower
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr islower 3 ,
diff --git a/lib/libc/locale/toupper.3 b/lib/libc/locale/toupper.3
index 9d6d3ba..d3008232 100644
--- a/lib/libc/locale/toupper.3
+++ b/lib/libc/locale/toupper.3
@@ -36,7 +36,7 @@
 .\"	@(#)toupper.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd October 3, 2002
+.Dd August 21, 2004
 .Dt TOUPPER 3
 .Os
 .Sh NAME
@@ -68,16 +68,15 @@ If the argument is a lower-case letter, the
 function returns the corresponding upper-case letter if there is
 one; otherwise the argument is returned unchanged.
 .Sh COMPATIBILITY
-Although
-.Fn toupper
-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 considered obsolete
+and may not be supported in future releases.
+The
 .Fn towupper
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr isupper 3 ,