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

1 files changed, 8 insertions, 3 deletions

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);
 #