From 24ab237a8980c1104688fd011e09eafc8e3ac3d5 Mon Sep 17 00:00:00 2001 From: tjr Date: Thu, 29 Jul 2004 23:32:41 +0000 Subject: 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(-) (limited to 'lib/libc') 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 , -- cgit v1.1