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

xmlschemas.c

@@ -3930,9 +3930,8 @@ xmlSchemaAttrFixup(xmlSchemaAttributePtr attrDecl,
 /**
  * xmlSchemaParse:
  * @ctxt:  a schema validation context
- * @URL:  the location of the schema
  *
- * Load, XML parse a schema definition resource and build an internal
+ * parse a schema definition resource and build an internal
  * XML Shema struture which can be used to validate instances.
  * *WARNING* this interface is highly subject to change
  *
@@ -4098,16 +4097,13 @@ skip_children:
 }
  
 /**
- * xmlSchemaParse:
+ * xmlSchemaSetParserErrors:
  * @ctxt:  a schema validation context
- * @URL:  the location of the schema
+ * @err:  the error callback
+ * @warn:  the warning callback
+ * @ctx:  contextual data for the callbacks
  *
- * Load, XML parse a schema definition resource and build an internal
- * XML Shema struture which can be used to validate instances.
- * *WARNING* this interface is highly subject to change
- *
- * Returns the internal XML Schema structure built from the resource or
- *         NULL in case of error
+ * Set the callback functions used to handle errors for a validation context
  */
 void
 xmlSchemaSetParserErrors(xmlSchemaParserCtxtPtr ctxt,