Libc-583.tar.gz

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

diff --git a/locale/iscntrl.3 b/locale/iscntrl.3
index be6dcc5357530540d96b40b8a67098dc9879754e..886980dc7d7788c53d1a989e71413b5d42e8d3d9 100644 (file)
--- a/locale/iscntrl.3
+++ b/locale/iscntrl.3
@@ -34,9 +34,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)iscntrl.3  8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/locale/iscntrl.3,v 1.6.2.5 2001/12/14 18:33:54 ru Exp $
+.\" $FreeBSD: src/lib/libc/locale/iscntrl.3,v 1.17 2004/08/21 07:37:08 tjr Exp $
 .\"
-.Dd June 4, 1993
+.Dd August 21, 2004
 .Dt ISCNTRL 3
 .Os
 .Sh NAME
@@ -55,31 +55,43 @@ function tests for any control character.
 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 "\&000\ nul \t001\ soh \t002\ stx \t003\ etx \t004\ eot"
-.It "\&005\ enq \t006\ ack \t007\ bel \t010\ bs \t011\ ht"
-.It "\&012\ nl \t013\ vt \t014\ np \t015\ cr \t016\ so"
-.It "\&017\ si \t020\ dle \t021\ dc1 \t022\ dc2 \t023\ dc3"
-.It "\&024\ dc4 \t025\ nak \t026\ syn \t027\ etb \t030\ can"
-.It "\&031\ em \t032\ sub \t033\ esc \t034\ fs \t035\ gs"
-.It "\&036\ rs \t037\ us \t177\ del"
+.It "\&000\ NUL \t001\ SOH \t002\ STX \t003\ ETX \t004\ EOT"
+.It "\&005\ ENQ \t006\ ACK \t007\ BEL \t010\ BS \t011\ HT"
+.It "\&012\ NL \t013\ VT \t014\ NP \t015\ CR \t016\ SO"
+.It "\&017\ SI \t020\ DLE \t021\ DC1 \t022\ DC2 \t023\ DC3"
+.It "\&024\ DC4 \t025\ NAK \t026\ SYN \t027\ ETB \t030\ CAN"
+.It "\&031\ EM \t032\ SUB \t033\ ESC \t034\ FS \t035\ GS"
+.It "\&036\ RS \t037\ US \t177\ DEL"
 .El
 .Sh RETURN VALUES
 The
 .Fn iscntrl
 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 iswcntrl
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr isalnum_l 3 ,
+.Xr iswcntrl 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS