new API building Python script, does the C parsing directly, generates a

* doc/apibuild.py doc/libxml2-api.xml doc/Makefile.am: new API
  building Python script, does the C parsing directly, generates
  a better API description including structure fieds defs and
  enums. Still a couple of bugs, but good enough for the python
  wrappers now.
* DOCBparser.c SAX.c nanohttp.c parser.c parserInternals.c tree.c
  valid.c xmlIO.c xmlmemory.c xmlreader.c xmlregexp.c xmlschemas.c
  include/libxml/schemasInternals.h include/libxml/tree.h: more
  cleanup based on the python analysis script reports.
* libxml.spec.in: make sure the API XML description is part of the
  devel package.
Daniel
diff --git a/tree.c b/tree.c
index 60ae931..c3d3045 100644
--- a/tree.c
+++ b/tree.c
@@ -899,8 +899,9 @@
  * @list:  a Node list
  * @inLine:  should we replace entity contents or show their external form
  *
- * Returns the string equivalent to the text contained in the Node list
+ * Build the string equivalent to the text contained in the Node list
  * made of TEXTs and ENTITY_REFs
+ *
  * Returns a pointer to the string copy, the caller must free it with xmlFree().
  */
 xmlChar *
@@ -977,7 +978,7 @@
  * @list:  a Node list
  * @inLine:  should we replace entity contents or show their external form
  *
- * Returns the string equivalent to the text contained in the Node list
+ * Builds the string equivalent to the text contained in the Node list
  * made of TEXTs and ENTITY_REFs, contrary to xmlNodeListGetString()
  * this function doesn't do any character encoding handling.
  *
@@ -7470,6 +7471,8 @@
  * @encoding:  the name of the encoding to use or NULL.
  * @format:  should formatting spaces be added.
  *
+ * Dump an XML document to a file or an URL.
+ *
  * Returns the number of bytes written or -1 in case of error.
  */
 int