cleanup the make rebuild in doc, this include new directive to stop

* globals.c xmlwriter.c doc/apibuild.py include/libxml/globals.h
  include/libxml/pattern.h include/libxml/schemasInternals.h
  include/libxml/xmlexports.h include/libxml/xmlwriter.h: cleanup
  the make rebuild in doc, this include new directive to stop
  documentation warnings
* doc/* doc/html/*: rebuilt the docs
* pattern.c xmlreader.c include/libxml/pattern.h
  include/libxml/xmlreader.h: adding xmlTextReaderPreservePattern()
  to save nodes while scanning the tree with the reader, cleanup
  the way element were freed, and xmlTextReaderPreserve()
  implementation, the API might change for namespace binding support
  when compiling patterns.
* doc/examples/*: added reader3.c exposing the xmlTextReaderPreserve()
Daniel
diff --git a/include/libxml/xmlwriter.h b/include/libxml/xmlwriter.h
index e35e76a..5aeafa2 100644
--- a/include/libxml/xmlwriter.h
+++ b/include/libxml/xmlwriter.h
@@ -225,6 +225,11 @@
 	xmlTextWriterWritePI		(xmlTextWriterPtr writer,
 					 const xmlChar * target,
 					 const xmlChar * content);
+/**
+ * xmlTextWriterWriteProcessingInstruction:
+ *
+ * This macro maps to xmlTextWriterWritePI
+ */
 #define xmlTextWriterWriteProcessingInstruction xmlTextWriterWritePI
 
 /*
@@ -277,6 +282,11 @@
 					 const xmlChar * pubid,
 					 const xmlChar * sysid,
 					 const xmlChar * subset);
+/**
+ * xmlTextWriterWriteDocType:
+ *
+ * this macro maps to xmlTextWriterWriteDTD
+ */
 #define xmlTextWriterWriteDocType xmlTextWriterWriteDTD
 
 /*
@@ -285,6 +295,11 @@
 XMLPUBFUN int XMLCALL
 	xmlTextWriterStartDTDElement	(xmlTextWriterPtr writer,
 					 const xmlChar * name);
+/**
+ * xmlTextWriterEndDTDElement:
+ *
+ * This macro maps to xmlTextWriterEndDTD
+ */
 #define xmlTextWriterEndDTDElement xmlTextWriterEndDTD
 
 /*
@@ -310,6 +325,11 @@
 XMLPUBFUN int XMLCALL
 	xmlTextWriterStartDTDAttlist	(xmlTextWriterPtr writer,
 					 const xmlChar * name);
+/**
+ * xmlTextWriterEndDTDAttlist:
+ *
+ * This macro maps to xmlTextWriterEndDTD
+ */
 #define xmlTextWriterEndDTDAttlist xmlTextWriterEndDTD
 
 /*
@@ -335,6 +355,11 @@
 XMLPUBFUN int XMLCALL
 	xmlTextWriterStartDTDEntity	(xmlTextWriterPtr writer,
                                     int pe, const xmlChar * name);
+/**
+ * xmlTextWriterEndDTDEntity:
+ *
+ * This macro maps to xmlTextWriterEndDTD
+ */
 #define xmlTextWriterEndDTDEntity xmlTextWriterEndDTD
 
 /*