Build a new version hopefully near complete and fully documented of the

* doc/libxml2-api.xml doc/parsedecl.py: Build a new version
  hopefully near complete and fully documented of the API in XML
* HTMLtree.c SAX.c debugXML.c error.c globals.c parser.c tree.c
 xmlIO.c xmlmemory.c include/libxml/catalog.h include/libxml/hash.h
 include/libxml/list.h include/libxml/parser.h include/libxml/tree.h
 include/libxml/parserInternals.h include/libxml/valid.hi
 include/libxml/xmlIO.h include/libxml/xmlerror.hi
 include/libxml/xmlmemory.h include/libxml/xmlversion.h.ini
 include/libxml/xpath.h include/libxml/xpathInternals.h:
  Cleaned up the doc comments a lot in the process, the interface
  coverage is now 100%
Daniel
diff --git a/tree.c b/tree.c
index 3370f0e..66e8acd 100644
--- a/tree.c
+++ b/tree.c
@@ -5036,7 +5036,8 @@
  * xmlBufferFree:
  * @buf:  the buffer to free
  *
- * Frees an XML buffer.
+ * Frees an XML buffer. It frees both the content and the structure which
+ * encapsulate it.
  */
 void
 xmlBufferFree(xmlBufferPtr buf) {