X-Git-Url: http://sjero.net/git/?a=blobdiff_plain;f=lib%2Fc-ctype.h;h=d78dd19d5dc9a18fbde4533e1a362ffc3af743cc;hb=fb0946c7fc6f1831894e8fd67389c0bc74a387b8;hp=b26eccfb3d1df818013f7b62562cc20a393f9798;hpb=68740f10dd55cb272bcad0bd0c5199bbdef5b26e;p=wget

diff --git a/lib/c-ctype.h b/lib/c-ctype.h
index b26eccfb..d78dd19d 100644
--- a/lib/c-ctype.h
+++ b/lib/c-ctype.h
@@ -5,11 +5,11 @@
    <ctype.h> functions' behaviour depends on the current locale set via
    setlocale.
 
-   Copyright (C) 2000-2003, 2006 Free Software Foundation, Inc.
+   Copyright (C) 2000-2003, 2006, 2008 Free Software Foundation, Inc.
 
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or
+the Free Software Foundation; either version 3 of the License, or
 (at your option) any later version.
 
 This program is distributed in the hope that it will be useful,
@@ -103,6 +103,21 @@ extern "C" {
 
 /* Function declarations. */
 
+/* Unlike the functions in <ctype.h>, which require an argument in the range
+   of the 'unsigned char' type, the functions here operate on values that are
+   in the 'unsigned char' range or in the 'char' range.  In other words,
+   when you have a 'char' value, you need to cast it before using it as
+   argument to a <ctype.h> function:
+
+         const char *s = ...;
+         if (isalpha ((unsigned char) *s)) ...
+
+   but you don't need to cast it for the functions defined in this file:
+
+         const char *s = ...;
+         if (c_isalpha (*s)) ...
+ */
+
 extern bool c_isascii (int c); /* not locale dependent */
 
 extern bool c_isalnum (int c);