Loading...
--- Libc/Libc-262/locale/ispunct.3
+++ Libc/Libc-583/locale/ispunct.3
@@ -34,9 +34,9 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)ispunct.3 8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/locale/ispunct.3,v 1.7.2.5 2001/12/14 18:33:54 ru Exp $
+.\" $FreeBSD: src/lib/libc/locale/ispunct.3,v 1.18 2004/08/21 07:37:08 tjr Exp $
.\"
-.Dd June 4, 1993
+.Dd August 21, 2004
.Dt ISPUNCT 3
.Os
.Sh NAME
@@ -51,21 +51,23 @@
.Sh DESCRIPTION
The
.Fn ispunct
-function tests for any printing character except for space (' ') or a
+function tests for any printing character, except for space
+.Pq Ql "\ "
+or a
character for which
.Xr isalnum 3
is true.
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 "\&041\ ``!'' \t042\ ``""'' \t043\ ``#'' \t044\ ``$'' \t045\ ``%''"
@@ -81,8 +83,20 @@
.Fn ispunct
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 iswpunct
+function should be used instead.
.Sh SEE ALSO
.Xr ctype 3 ,
+.Xr isalnum_l 3 ,
+.Xr iswpunct 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS