Libc-583.tar.gz

[apple/libc.git] / locale / isupper.3

diff --git a/locale/isupper.3 b/locale/isupper.3
index af98c6b9d85bc761c7930957ec22d915392626f3..acf7c13bc00df487bc6ab25406f58fb9e385df2e 100644 (file)
--- a/locale/isupper.3
+++ b/locale/isupper.3
@@ -34,9 +34,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)isupper.3  8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/locale/isupper.3,v 1.8.2.5 2001/12/14 18:33:54 ru Exp $
+.\" $FreeBSD: src/lib/libc/locale/isupper.3,v 1.18 2004/08/21 07:37:08 tjr Exp $
 .\"
-.Dd June 4, 1993
+.Dd August 21, 2004
 .Dt ISUPPER 3
 .Os
 .Sh NAME
@@ -55,14 +55,14 @@ function tests for any upper-case letter.
 For single C
 .Va char Ns s
 locales (see
-.Xr multibyte 3 )
+.Xr multibyte 3 ) ,
 the value of the argument is
 representable as an
 .Li unsigned char
 or the value of
 .Dv EOF .
 In the ASCII character set, this includes the following characters
-(with their numeric values shown in octal):
+(preceded by their numeric values, in octal):
 .Pp
 .Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
 .It "\&101\ ``A'' \t102\ ``B'' \t103\ ``C'' \t104\ ``D'' \t105\ ``E''"
@@ -77,8 +77,20 @@ The
 .Fn isupper
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+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 considered obsolete
+and may not be supported in future releases.
+The
+.Fn iswupper
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr isalnum_l 3 ,
+.Xr iswupper 3 ,
 .Xr multibyte 3 ,
 .Xr toupper 3 ,
 .Xr ascii 7