From 0db74aa4a9fad5850d799282c7bb128baffd6d89 Mon Sep 17 00:00:00 2001 From: "Tim J. Robbins" Date: Thu, 29 Jul 2004 23:32:41 +0000 Subject: [PATCH] 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 interface in FreeBSD 6. --- lib/libc/locale/isalnum.3 | 14 ++++++-------- lib/libc/locale/isalpha.3 | 14 ++++++-------- lib/libc/locale/isblank.3 | 14 ++++++-------- lib/libc/locale/iscntrl.3 | 16 +++++++--------- 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 | 16 +++++++--------- 12 files changed, 74 insertions(+), 98 deletions(-) diff --git a/lib/libc/locale/isalnum.3 b/lib/libc/locale/isalnum.3 index 5cc0f8c43282..643a97916d00 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 2f6cacf7f439..2e1ead270f43 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 5fdc2aebc489..d8bfb8ebaa2c 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 417820b56e61..d3ea5aa5354d 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 42503ad304c6..1d5eadd61568 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 e78522ce0bdb..39da046111b7 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 8f7b1e024334..5a818d71ebaa 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 825d06e30396..ace183a56c09 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 05a876928839..96b2c4fec58a 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 e286b6995994..a808371de224 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 3fb903e79a36..c3c187a98c65 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 04745ab4c5cb..4019d69b9ee4 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 ,