Document the isnumber() and ishexnumber() functions, and explain how they

differ (at least in theory) from isdigit() and isxdigit().

1 files changed, 16 insertions, 8 deletions

diff --git a/lib/libc/locale/isxdigit.3 b/lib/libc/locale/isxdigit.3
index 661b7fb..df50744 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 October 6, 2002
+.Dd March 30, 2004
 .Dt ISXDIGIT 3
 .Os
 .Sh NAME
@@ -54,7 +54,7 @@
 The
 .Fn isxdigit
 function tests for any hexadecimal-digit character.
-For any locale, this includes the following characters only:
+Regardless of locale, this includes the following characters only:
 .Pp
 .Bl -column \&``0''______ \&``0''______ \&``0''______ \&``0''______ \&``0''______
 .It "\&``0''\t``1''\t``2''\t``3''\t``4''"
@@ -64,6 +64,13 @@ For any locale, this includes the following characters only:
 .It "\&``e''\t``f''"
 .El
 .Pp
+The
+.Fn ishexnumber
+function behaves similarly to
+.Fn isxdigit ,
+but may recognize additional characters,
+depennding on the current locale setting.
+.Pp
 For single C
 .Va char Ns s
 locales (see
@@ -81,18 +88,14 @@ returns non-zero if the character tests true.
 .Sh COMPATIBILITY
 Although
 .Fn isxdigit
-and
-.Fn ishexnumber
-accept arguments outside of the range of the
+accepts arguments outside of the range of the
 .Vt "unsigned char"
 type in locales with large character sets,
 this is a
 .Bx 4.4
 extension and the
 .Fn isxwdigit
-and
-.Fn iswhexnumber
-functions should be used instead for maximum portability.
+function should be used instead for maximum portability.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswxdigit 3 ,
@@ -103,3 +106,8 @@ The
 .Fn isxdigit
 function conforms to
 .St -isoC .
+.Sh HISTORY
+The
+.Fn ishexnumber
+function appeared in
+.Bx 4.4 .