code cleanup, especially the function comments. fixed a small bug when

* DOCBparser.c HTMLparser.c c14n.c debugXML.c encoding.c hash.c
  nanoftp.c nanohttp.c parser.c parserInternals.c testC14N.c
  testDocbook.c threads.c tree.c valid.c xmlIO.c xmllint.c xmlmemory.c
  xmlreader.c xmlregexp.c xmlschemas.c xmlschemastypes.c xpath.c:
  code cleanup, especially the function comments.
* tree.c: fixed a small bug when freeing nodes which are XInclude ones.
Daniel
diff --git a/DOCBparser.c b/DOCBparser.c
index 33c0534..840b309 100644
--- a/DOCBparser.c
+++ b/DOCBparser.c
@@ -3459,7 +3459,7 @@
 
 
 /**
- * docbParseDocTypeDecl :
+ * docbParseDocTypeDecl:
  * @ctxt:  an SGML parser context
  *
  * parse a DOCTYPE declaration
@@ -4791,7 +4791,7 @@
 }
 
 /**
- * docbParseDocument :
+ * docbParseDocument:
  * @ctxt:  an SGML parser context
  * 
  * parse an SGML document (and build a tree if using the standard SAX
@@ -5004,7 +5004,7 @@
 }
 
 /**
- * docbCreateDocParserCtxt :
+ * docbCreateDocParserCtxt:
  * @cur:  a pointer to an array of xmlChar
  * @encoding: the SGML document encoding, or NULL
  *
@@ -5631,7 +5631,7 @@
                } else {
                    /* TODO Avoid the extra copy, handle directly !!!!!! */
                    /*
-                    * Goal of the following test is :
+                    * Goal of the following test is:
                     *  - minimize calls to the SAX 'character' callback
                     *    when they are mergeable
                     */
@@ -5869,7 +5869,7 @@
  ************************************************************************/
 
 /**
- * docbCreatePushParserCtxt :
+ * docbCreatePushParserCtxt:
  * @sax:  a SAX handler
  * @user_data:  The user data returned on SAX callbacks
  * @chunk:  a pointer to an array of chars
@@ -5949,7 +5949,7 @@
 }
 
 /**
- * docbSAXParseDoc :
+ * docbSAXParseDoc:
  * @cur:  a pointer to an array of xmlChar
  * @encoding:  a free form C string describing the SGML document encoding, or NULL
  * @sax:  the SAX handler block
@@ -5989,7 +5989,7 @@
 }
 
 /**
- * docbParseDoc :
+ * docbParseDoc:
  * @cur:  a pointer to an array of xmlChar
  * @encoding:  a free form C string describing the SGML document encoding, or NULL
  *
@@ -6005,7 +6005,7 @@
 
 
 /**
- * docbCreateFileParserCtxt :
+ * docbCreateFileParserCtxt:
  * @filename:  the filename
  * @encoding:  the SGML document encoding, or NULL
  *
@@ -6058,7 +6058,7 @@
 }
 
 /**
- * docbSAXParseFile :
+ * docbSAXParseFile:
  * @filename:  the filename
  * @encoding:  a free form C string describing the SGML document encoding, or NULL
  * @sax:  the SAX handler block
@@ -6100,7 +6100,7 @@
 }
 
 /**
- * docbParseFile :
+ * docbParseFile:
  * @filename:  the filename
  * @encoding:  a free form C string describing document encoding, or NULL
  *