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.
This commit is contained in:
Tim J. Robbins 2004-07-29 23:32:41 +00:00
parent e5afeeb3be
commit 0db74aa4a9
12 changed files with 74 additions and 98 deletions

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 ,

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 ,