enhanced to include enough comments to make the api doc generation happy.

* genChRanges.py, chvalid.c, include/libxml/chvalid.h,
  doc/apibuild.py: enhanced to include enough comments to
  make the api doc generation happy.
diff --git a/chvalid.c b/chvalid.c
index 8ffcb73..0d140a4 100755
--- a/chvalid.c
+++ b/chvalid.c
@@ -5,7 +5,7 @@
  * This file is automatically generated from the cvs source
  * definition files using the genChRanges.py Python script
  *
- * Generation date: Sat Oct 18 09:01:24 2003
+ * Generation date: Sat Oct 18 20:32:35 2003
  * Sources: chvalid.def
  * William Brack <wbrack@mmm.com.hk>
  */
@@ -149,6 +149,16 @@
 	{3, 0, xmlIsIdeographic_srng, (xmlChLRangePtr)0};
 
 
+/**
+ * xmlCharInRange:
+ * @val: character to be validated
+ * @rptr: pointer to range to be used to validate
+ *
+ * Does a binary search of the range table to determine if char
+ * is valid
+ *
+ * Returns: true if character valid, false otherwise
+ */
 int
 xmlCharInRange (unsigned int val, xmlChRangeGroupPtr rptr) {
     int low, high, mid;
@@ -195,41 +205,121 @@
     return 0;
 }
 
+
+/**
+ * xmlIsBaseChar:
+ * @ch:  character to validate
+ *
+ * This function is DEPRECATED.  Use xmlIsBaseChar_ch
+ * or xmlIsBaseCharQ instead
+ *
+ * Returns true if argument valid, false otherwise
+ */
 int
 xmlIsBaseChar(unsigned int ch) {
     return(xmlIsBaseCharQ(ch));
 }
 
+
+/**
+ * xmlIsBlank:
+ * @ch:  character to validate
+ *
+ * This function is DEPRECATED.  Use xmlIsBlank_ch
+ * or xmlIsBlankQ instead
+ *
+ * Returns true if argument valid, false otherwise
+ */
 int
 xmlIsBlank(unsigned int ch) {
     return(xmlIsBlankQ(ch));
 }
 
+
+/**
+ * xmlIsChar:
+ * @ch:  character to validate
+ *
+ * This function is DEPRECATED.  Use xmlIsChar_ch
+ * or xmlIsCharQ instead
+ *
+ * Returns true if argument valid, false otherwise
+ */
 int
 xmlIsChar(unsigned int ch) {
     return(xmlIsCharQ(ch));
 }
 
+
+/**
+ * xmlIsCombining:
+ * @ch:  character to validate
+ *
+ * This function is DEPRECATED.  Use xmlIsCombining_ch
+ * or xmlIsCombiningQ instead
+ *
+ * Returns true if argument valid, false otherwise
+ */
 int
 xmlIsCombining(unsigned int ch) {
     return(xmlIsCombiningQ(ch));
 }
 
+
+/**
+ * xmlIsDigit:
+ * @ch:  character to validate
+ *
+ * This function is DEPRECATED.  Use xmlIsDigit_ch
+ * or xmlIsDigitQ instead
+ *
+ * Returns true if argument valid, false otherwise
+ */
 int
 xmlIsDigit(unsigned int ch) {
     return(xmlIsDigitQ(ch));
 }
 
+
+/**
+ * xmlIsExtender:
+ * @ch:  character to validate
+ *
+ * This function is DEPRECATED.  Use xmlIsExtender_ch
+ * or xmlIsExtenderQ instead
+ *
+ * Returns true if argument valid, false otherwise
+ */
 int
 xmlIsExtender(unsigned int ch) {
     return(xmlIsExtenderQ(ch));
 }
 
+
+/**
+ * xmlIsIdeographic:
+ * @ch:  character to validate
+ *
+ * This function is DEPRECATED.  Use xmlIsIdeographic_ch
+ * or xmlIsIdeographicQ instead
+ *
+ * Returns true if argument valid, false otherwise
+ */
 int
 xmlIsIdeographic(unsigned int ch) {
     return(xmlIsIdeographicQ(ch));
 }
 
+
+/**
+ * xmlIsPubidChar:
+ * @ch:  character to validate
+ *
+ * This function is DEPRECATED.  Use xmlIsPubidChar_ch
+ * or xmlIsPubidCharQ instead
+ *
+ * Returns true if argument valid, false otherwise
+ */
 int
 xmlIsPubidChar(unsigned int ch) {
     return(xmlIsPubidCharQ(ch));