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/HTMLparser.c b/HTMLparser.c
index e846567..7db3e9e 100644
--- a/HTMLparser.c
+++ b/HTMLparser.c
@@ -2623,7 +2623,7 @@
 
 
 /**
- * htmlParseDocTypeDecl :
+ * htmlParseDocTypeDecl:
  * @ctxt:  an HTML parser context
  *
  * parse a DOCTYPE declaration
@@ -3544,7 +3544,7 @@
 }
 
 /**
- * htmlParseDocument :
+ * htmlParseDocument:
  * @ctxt:  an HTML parser context
  * 
  * parse an HTML document (and build a tree if using the standard SAX
@@ -3833,7 +3833,7 @@
 }
 
 /**
- * htmlCreateDocParserCtxt :
+ * htmlCreateDocParserCtxt:
  * @cur:  a pointer to an array of xmlChar
  * @encoding:  a free form C string describing the HTML document encoding, or NULL
  *
@@ -4491,7 +4491,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
 			 */
@@ -4727,7 +4727,7 @@
  ************************************************************************/
 
 /**
- * htmlCreatePushParserCtxt :
+ * htmlCreatePushParserCtxt:
  * @sax:  a SAX handler
  * @user_data:  The user data returned on SAX callbacks
  * @chunk:  a pointer to an array of chars
@@ -4809,7 +4809,7 @@
 }
 
 /**
- * htmlSAXParseDoc :
+ * htmlSAXParseDoc:
  * @cur:  a pointer to an array of xmlChar
  * @encoding:  a free form C string describing the HTML document encoding, or NULL
  * @sax:  the SAX handler block
@@ -4852,7 +4852,7 @@
 }
 
 /**
- * htmlParseDoc :
+ * htmlParseDoc:
  * @cur:  a pointer to an array of xmlChar
  * @encoding:  a free form C string describing the HTML document encoding, or NULL
  *
@@ -4868,7 +4868,7 @@
 
 
 /**
- * htmlCreateFileParserCtxt :
+ * htmlCreateFileParserCtxt:
  * @filename:  the filename
  * @encoding:  a free form C string describing the HTML document encoding, or NULL
  *
@@ -4933,7 +4933,7 @@
 }
 
 /**
- * htmlSAXParseFile :
+ * htmlSAXParseFile:
  * @filename:  the filename
  * @encoding:  a free form C string describing the HTML document encoding, or NULL
  * @sax:  the SAX handler block
@@ -4978,7 +4978,7 @@
 }
 
 /**
- * htmlParseFile :
+ * htmlParseFile:
  * @filename:  the filename
  * @encoding:  a free form C string describing the HTML document encoding, or NULL
  *