minor enhancement to prevent comment with unreferenced variable. edited

* genChRanges.py, chvalid.c, include/libxml/chvalid.h: minor
  enhancement to prevent comment with unreferenced variable.
* threads.c xmlreader.c xmlwriter.c: edited some comments to
  improve auto-generation of documentation
* apibuild.py: minor change to an error message

8 files changed, 43 insertions, 24 deletions

diff --git a/ChangeLog b/ChangeLog
index 740a5ff3..ab53fcb2 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+Tue Nov 18 14:28:32 HKT 2003 William Brack <mmm.com.hk>
+
+	* genChRanges.py, chvalid.c, include/libxml/chvalid.h: minor
+	  enhancement to prevent comment with unreferenced variable.
+	* threads.c xmlreader.c xmlwriter.c: edited some comments to
+	  improve auto-generation of documentation
+	* apibuild.py: minor change to an error message
+
 Mon Nov 17 17:55:51 CET 2003 Daniel Veillard <daniel@veillard.com>
 
 	* doc/apibuild.py doc/libxml2-api.xml doc/newapi.xsl: more cleanup,
diff --git a/chvalid.c b/chvalid.c
index d0982089..d47bc6aa 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 Nov 15 15:31:10 2003
+ * Generation date: Tue Nov 18 08:14:21 2003
  * Sources: chvalid.def
  * William Brack <wbrack@mmm.com.hk>
  */
@@ -212,8 +212,8 @@ xmlCharInRange (unsigned int val, const xmlChRangeGroupPtr rptr) {
  * xmlIsBaseChar:
  * @ch:  character to validate
  *
- * This function is DEPRECATED.  Use xmlIsBaseChar_ch
- * or xmlIsBaseCharQ instead
+ * This function is DEPRECATED.
+ * Use xmlIsBaseChar_ch or xmlIsBaseCharQ instead
  *
  * Returns true if argument valid, false otherwise
  */
@@ -227,8 +227,8 @@ xmlIsBaseChar(unsigned int ch) {
  * xmlIsBlank:
  * @ch:  character to validate
  *
- * This function is DEPRECATED.  Use xmlIsBlank_ch
- * or xmlIsBlankQ instead
+ * This function is DEPRECATED.
+ * Use xmlIsBlank_ch or xmlIsBlankQ instead
  *
  * Returns true if argument valid, false otherwise
  */
@@ -242,8 +242,8 @@ xmlIsBlank(unsigned int ch) {
  * xmlIsChar:
  * @ch:  character to validate
  *
- * This function is DEPRECATED.  Use xmlIsChar_ch
- * or xmlIsCharQ instead
+ * This function is DEPRECATED.
+ * Use xmlIsChar_ch or xmlIsCharQ instead
  *
  * Returns true if argument valid, false otherwise
  */
@@ -257,8 +257,8 @@ xmlIsChar(unsigned int ch) {
  * xmlIsCombining:
  * @ch:  character to validate
  *
- * This function is DEPRECATED.  Use xmlIsCombining_ch
- * or xmlIsCombiningQ instead
+ * This function is DEPRECATED.
+ * Use xmlIsCombiningQ instead
  *
  * Returns true if argument valid, false otherwise
  */
@@ -272,8 +272,8 @@ xmlIsCombining(unsigned int ch) {
  * xmlIsDigit:
  * @ch:  character to validate
  *
- * This function is DEPRECATED.  Use xmlIsDigit_ch
- * or xmlIsDigitQ instead
+ * This function is DEPRECATED.
+ * Use xmlIsDigit_ch or xmlIsDigitQ instead
  *
  * Returns true if argument valid, false otherwise
  */
@@ -287,8 +287,8 @@ xmlIsDigit(unsigned int ch) {
  * xmlIsExtender:
  * @ch:  character to validate
  *
- * This function is DEPRECATED.  Use xmlIsExtender_ch
- * or xmlIsExtenderQ instead
+ * This function is DEPRECATED.
+ * Use xmlIsExtender_ch or xmlIsExtenderQ instead
  *
  * Returns true if argument valid, false otherwise
  */
@@ -302,8 +302,8 @@ xmlIsExtender(unsigned int ch) {
  * xmlIsIdeographic:
  * @ch:  character to validate
  *
- * This function is DEPRECATED.  Use xmlIsIdeographic_ch
- * or xmlIsIdeographicQ instead
+ * This function is DEPRECATED.
+ * Use xmlIsIdeographicQ instead
  *
  * Returns true if argument valid, false otherwise
  */
@@ -317,8 +317,8 @@ xmlIsIdeographic(unsigned int ch) {
  * xmlIsPubidChar:
  * @ch:  character to validate
  *
- * This function is DEPRECATED.  Use xmlIsPubidChar_ch
- * or xmlIsPubidCharQ instead
+ * This function is DEPRECATED.
+ * Use xmlIsPubidChar_ch or xmlIsPubidCharQ instead
  *
  * Returns true if argument valid, false otherwise
  */
diff --git a/doc/apibuild.py b/doc/apibuild.py
index 89c69ab7..edde6ec7 100755
--- a/doc/apibuild.py
+++ b/doc/apibuild.py
@@ -679,7 +679,7 @@ class CParser:
 		 i = i + 1
 	     if i >= nbargs:
 		 if not quiet:
-		     print "Uname to find arg %s from function comment for %s" % (
+		     print "Unable to find arg %s from function comment for %s" % (
 		        arg, name)
 	 while len(lines) > 0 and lines[0] == '*':
 	     del lines[0]
diff --git a/genChRanges.py b/genChRanges.py
index 91a3399e..27a44faf 100755
--- a/genChRanges.py
+++ b/genChRanges.py
@@ -541,12 +541,17 @@ for f in fkeys:
  * %s:
  * @ch:  character to validate
  *
- * This function is DEPRECATED.  Use %s_ch
- * or %sQ instead
+ * This function is DEPRECATED.
+""" % f);
+    if max(Functs[f][0]) > 0:
+        output.write(" * Use %s_ch or %sQ instead" % (f, f))
+    else:
+        output.write(" * Use %sQ instead" % f)
+    output.write("""
  *
  * Returns true if argument valid, false otherwise
  */
-""" % (f, f, f))
+""")
     output.write("int\n%s(unsigned int ch) {\n    return(%sQ(ch));\n}\n\n" % (f,f))
     header.write("XMLPUBFUN int XMLCALL\n\t\t%s(unsigned int ch);\n" % f);
 #
diff --git a/include/libxml/chvalid.h b/include/libxml/chvalid.h
index 0f28e5ad..0e0c7f4c 100644
--- a/include/libxml/chvalid.h
+++ b/include/libxml/chvalid.h
@@ -5,7 +5,7 @@
  * This file is automatically generated from the cvs source
  * definition files using the genChRanges.py Python script
  *
- * Generation date: Sat Nov 15 15:31:10 2003
+ * Generation date: Tue Nov 18 08:14:21 2003
  * Sources: chvalid.def
  * William Brack <wbrack@mmm.com.hk>
  */
diff --git a/threads.c b/threads.c
index 30a88ed8..ac6c8d62 100644
--- a/threads.c
+++ b/threads.c
@@ -432,6 +432,12 @@ static CRITICAL_SECTION cleanup_helpers_cs;
 #endif /* HAVE_WIN32_THREADS */
 
 #if defined HAVE_BEOS_THREADS
+/**
+ * xmlGlobalStateCleanup:
+ * @data: unused parameter
+ *
+ * Used for Beos only
+ */
 void xmlGlobalStateCleanup(void *data)
 {
 	void *globalval = tls_get(globalkey);
diff --git a/xmlreader.c b/xmlreader.c
index ec36fe95..d5dd3775 100644
--- a/xmlreader.c
+++ b/xmlreader.c
@@ -1725,7 +1725,7 @@ found_node:
 }
 
 /**
- * xmlTextReaderNextTree:
+ * xmlTextReaderNextSibling:
  * @reader:  the xmlTextReaderPtr used
  *
  * Skip to the node following the current one in document order while
diff --git a/xmlwriter.c b/xmlwriter.c
index 21897ee2..38ee555e 100644
--- a/xmlwriter.c
+++ b/xmlwriter.c
@@ -2565,7 +2565,7 @@ xmlTextWriterWriteVFormatDTD(xmlTextWriterPtr writer,
  * @name:  the name of the DTD
  * @pubid:  the public identifier, which is an alternative to the system identifier
  * @sysid:  the system identifier, which is the URI of the DTD
- * @format:  format string (see printf)
+ * @subset:  string content of the DTD
  *
  * Write a DTD.
  *