[libxml2] Rebuild documentation
- From: Nick Wellnhofer <nwellnhof src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [libxml2] Rebuild documentation
- Date: Wed, 24 Aug 2022 13:25:39 +0000 (UTC)
commit e70b0c5e03e9356f939e066c44c1f227ff8a9d50
Author: Nick Wellnhofer <wellnhofer aevum de>
Date: Wed Aug 24 15:16:04 2022 +0200
Rebuild documentation
doc/devhelp/libxml2-HTMLtree.html | 2 +-
doc/devhelp/libxml2-SAX2.html | 2 +-
doc/devhelp/libxml2-encoding.html | 2 +-
doc/devhelp/libxml2-globals.html | 10 +++---
doc/devhelp/libxml2-hash.html | 4 +--
doc/devhelp/libxml2-parser.html | 58 ++++++++++++++++----------------
doc/devhelp/libxml2-parserInternals.html | 4 +--
doc/devhelp/libxml2-tree.html | 34 +++++++++----------
doc/devhelp/libxml2-xmlreader.html | 42 +++++++++++------------
doc/devhelp/libxml2-xmlschemastypes.html | 2 +-
doc/devhelp/libxml2-xmlwriter.html | 20 +++++------
doc/devhelp/libxml2-xpathInternals.html | 2 +-
doc/libxml2-api.xml | 22 ++++++------
13 files changed, 102 insertions(+), 102 deletions(-)
---
diff --git a/doc/devhelp/libxml2-HTMLtree.html b/doc/devhelp/libxml2-HTMLtree.html
index 203cb38f..7e60ab61 100644
--- a/doc/devhelp/libxml2-HTMLtree.html
+++ b/doc/devhelp/libxml2-HTMLtree.html
@@ -250,7 +250,7 @@ int <a href="#htmlSetMetaEncoding">htmlSetMetaEncoding</a> (<a href="libxml2-HT
<a name="htmlIsBooleanAttr"></a>htmlIsBooleanAttr ()</h3>
<pre class="programlisting">int htmlIsBooleanAttr (const <a
href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name)<br>
</pre>
-<p>Determine if a given <a href="libxml2-SAX.html#attribute">attribute</a> is a boolean attribute.</p>
+<p>Determine if a given <a href="libxml2-SAX.html#attribute">attribute</a> is a boolean <a
href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
diff --git a/doc/devhelp/libxml2-SAX2.html b/doc/devhelp/libxml2-SAX2.html
index 2e2a6ed7..4a463b17 100644
--- a/doc/devhelp/libxml2-SAX2.html
+++ b/doc/devhelp/libxml2-SAX2.html
@@ -893,7 +893,7 @@ int <a href="#xmlSAXVersion">xmlSAXVersion</a> (<a
href="libxml2-tree.html#xml
<a name="xmlSAXDefaultVersion"></a>xmlSAXDefaultVersion ()</h3>
<pre class="programlisting">int xmlSAXDefaultVersion (int version)<br>
</pre>
-<p>DEPRECATED: Use parser option XML_PARSE_SAX1. Set the default version of SAX used globally by the
library. By default, during initialization the default is set to 2. Note that it is generally a better coding
style to use xmlSAXVersion() to set up the version explicitly for a given parsing context.</p>
+<p>DEPRECATED: Use parser option <a href="libxml2-parser.html#XML_PARSE_SAX1">XML_PARSE_SAX1</a>. Set the
default version of SAX used globally by the library. By default, during initialization the default is set to
2. Note that it is generally a better coding style to use xmlSAXVersion() to set up the version explicitly
for a given parsing context.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
diff --git a/doc/devhelp/libxml2-encoding.html b/doc/devhelp/libxml2-encoding.html
index 94d70572..cc9e2fb6 100644
--- a/doc/devhelp/libxml2-encoding.html
+++ b/doc/devhelp/libxml2-encoding.html
@@ -533,7 +533,7 @@ void <a href="#xmlRegisterCharEncodingHandler">xmlRegisterCharEncodingHandler</a
<a name="xmlNewCharEncodingHandler"></a>xmlNewCharEncodingHandler ()</h3>
<pre class="programlisting"><a
href="libxml2-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a>
xmlNewCharEncodingHandler (const char * name, <br>
<a href="libxml2-encoding.html#xmlCharEncodingInputFunc">xmlCharEncodingInputFunc</a> input, <br>
<a
href="libxml2-encoding.html#xmlCharEncodingOutputFunc">xmlCharEncodingOutputFunc</a> output)<br>
</pre>
-<p>Create and registers an xmlCharEncodingHandler.</p>
+<p>Create and registers an <a
href="libxml2-encoding.html#xmlCharEncodingHandler">xmlCharEncodingHandler</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
diff --git a/doc/devhelp/libxml2-globals.html b/doc/devhelp/libxml2-globals.html
index abe81ff4..ea7696de 100644
--- a/doc/devhelp/libxml2-globals.html
+++ b/doc/devhelp/libxml2-globals.html
@@ -255,7 +255,7 @@ const char * <a href="#xmlThrDefTreeIndentString">xmlThrDefTreeIndentString</a>
<a name="xmlDoValidityCheckingDefaultValue">Variable </a>xmlDoValidityCheckingDefaultValue</h3>
<pre class="programlisting">int xmlDoValidityCheckingDefaultValue;
</pre>
-<p>DEPRECATED: Use the modern options API with XML_PARSE_DTDVALID. Global setting, indicate that the parser
should work in validating mode. Disabled by default.</p>
+<p>DEPRECATED: Use the modern options API with <a
href="libxml2-parser.html#XML_PARSE_DTDVALID">XML_PARSE_DTDVALID</a>. Global setting, indicate that the
parser should work in validating mode. Disabled by default.</p>
</div>
<hr>
<div class="refsect2" lang="en">
@@ -303,7 +303,7 @@ const char * <a href="#xmlThrDefTreeIndentString">xmlThrDefTreeIndentString</a>
<a name="xmlKeepBlanksDefaultValue">Variable </a>xmlKeepBlanksDefaultValue</h3>
<pre class="programlisting">int xmlKeepBlanksDefaultValue;
</pre>
-<p>DEPRECATED: Use the modern options API with XML_PARSE_NOBLANKS. Global setting, indicate that the parser
should keep all blanks nodes found in the content Activated by default, this is actually needed to have the
parser conformant to the XML Recommendation, however the option is kept for some applications since this was
libxml1 default behaviour.</p>
+<p>DEPRECATED: Use the modern options API with <a
href="libxml2-parser.html#XML_PARSE_NOBLANKS">XML_PARSE_NOBLANKS</a>. Global setting, indicate that the
parser should keep all blanks nodes found in the content Activated by default, this is actually needed to
have the parser conformant to the XML Recommendation, however the option is kept for some applications since
this was libxml1 default behaviour.</p>
</div>
<hr>
<div class="refsect2" lang="en">
@@ -327,7 +327,7 @@ const char * <a href="#xmlThrDefTreeIndentString">xmlThrDefTreeIndentString</a>
<a name="xmlLoadExtDtdDefaultValue">Variable </a>xmlLoadExtDtdDefaultValue</h3>
<pre class="programlisting">int xmlLoadExtDtdDefaultValue;
</pre>
-<p>DEPRECATED: Use the modern options API with XML_PARSE_DTDLOAD. Global setting, indicate that the parser
should load DTD while not validating. Disabled by default.</p>
+<p>DEPRECATED: Use the modern options API with <a
href="libxml2-parser.html#XML_PARSE_DTDLOAD">XML_PARSE_DTDLOAD</a>. Global setting, indicate that the parser
should load DTD while not validating. Disabled by default.</p>
</div>
<hr>
<div class="refsect2" lang="en">
@@ -391,7 +391,7 @@ const char * <a href="#xmlThrDefTreeIndentString">xmlThrDefTreeIndentString</a>
<a name="xmlPedanticParserDefaultValue">Variable </a>xmlPedanticParserDefaultValue</h3>
<pre class="programlisting">int xmlPedanticParserDefaultValue;
</pre>
-<p>DEPRECATED: Use the modern options API with XML_PARSE_PEDANTIC. Global setting, indicate that the parser
be pedantic Disabled by default.</p>
+<p>DEPRECATED: Use the modern options API with <a
href="libxml2-parser.html#XML_PARSE_PEDANTIC">XML_PARSE_PEDANTIC</a>. Global setting, indicate that the
parser be pedantic Disabled by default.</p>
</div>
<hr>
<div class="refsect2" lang="en">
@@ -439,7 +439,7 @@ const char * <a href="#xmlThrDefTreeIndentString">xmlThrDefTreeIndentString</a>
<a name="xmlSubstituteEntitiesDefaultValue">Variable </a>xmlSubstituteEntitiesDefaultValue</h3>
<pre class="programlisting">int xmlSubstituteEntitiesDefaultValue;
</pre>
-<p>DEPRECATED: Use the modern options API with XML_PARSE_NOENT. Global setting, indicate that the parser
should not generate entity references but replace them with the actual content of the entity Disabled by
default, this should be activated when using XPath since the XPath data model requires entities replacement
and the XPath engine does not handle entities references transparently.</p>
+<p>DEPRECATED: Use the modern options API with <a
href="libxml2-parser.html#XML_PARSE_NOENT">XML_PARSE_NOENT</a>. Global setting, indicate that the parser
should not generate entity references but replace them with the actual content of the entity Disabled by
default, this should be activated when using XPath since the XPath data model requires entities replacement
and the XPath engine does not handle entities references transparently.</p>
</div>
<hr>
<div class="refsect2" lang="en">
diff --git a/doc/devhelp/libxml2-hash.html b/doc/devhelp/libxml2-hash.html
index 894c3f8a..2618680f 100644
--- a/doc/devhelp/libxml2-hash.html
+++ b/doc/devhelp/libxml2-hash.html
@@ -326,7 +326,7 @@ The content of this structure is not made public by the API.
<a name="xmlHashCreate"></a>xmlHashCreate ()</h3>
<pre class="programlisting"><a href="libxml2-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> xmlHashCreate
(int size)<br>
</pre>
-<p>Create a new xmlHashTablePtr.</p>
+<p>Create a new <a href="libxml2-hash.html#xmlHashTablePtr">xmlHashTablePtr</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -372,7 +372,7 @@ The content of this structure is not made public by the API.
<a name="xmlHashDefaultDeallocator"></a>xmlHashDefaultDeallocator ()</h3>
<pre class="programlisting">void xmlHashDefaultDeallocator (void * entry, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name)<br>
</pre>
-<p>Free a hash table entry with xmlFree.</p>
+<p>Free a hash table entry with <a href="libxml2-globals.html#xmlFree">xmlFree</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
diff --git a/doc/devhelp/libxml2-parser.html b/doc/devhelp/libxml2-parser.html
index af1bffdd..21fe1c85 100644
--- a/doc/devhelp/libxml2-parser.html
+++ b/doc/devhelp/libxml2-parser.html
@@ -152,7 +152,7 @@ int <a href="#xmlSubstituteEntitiesDefault">xmlSubstituteEntitiesDefault</a> (in
<a name="XML_COMPLETE_ATTRS">Macro </a>XML_COMPLETE_ATTRS</h3>
<pre class="programlisting">#define <a href="#XML_COMPLETE_ATTRS">XML_COMPLETE_ATTRS</a>;
</pre>
-<p>Bit in the loadsubset context field to tell to do complete the elements attributes lists with the ones
defaulted from the DTDs. Use it to initialize xmlLoadExtDtdDefaultValue.</p>
+<p>Bit in the loadsubset context field to tell to do complete the elements attributes lists with the ones
defaulted from the DTDs. Use it to initialize <a
href="libxml2-globals.html#xmlLoadExtDtdDefaultValue">xmlLoadExtDtdDefaultValue</a>.</p>
</div>
<hr>
<div class="refsect2" lang="en">
@@ -168,7 +168,7 @@ int <a href="#xmlSubstituteEntitiesDefault">xmlSubstituteEntitiesDefault</a> (in
<a name="XML_DETECT_IDS">Macro </a>XML_DETECT_IDS</h3>
<pre class="programlisting">#define <a href="#XML_DETECT_IDS">XML_DETECT_IDS</a>;
</pre>
-<p>Bit in the loadsubset context field to tell to do ID/REFs lookups. Use it to initialize
xmlLoadExtDtdDefaultValue.</p>
+<p>Bit in the loadsubset context field to tell to do ID/REFs lookups. Use it to initialize <a
href="libxml2-globals.html#xmlLoadExtDtdDefaultValue">xmlLoadExtDtdDefaultValue</a>.</p>
</div>
<hr>
<div class="refsect2" lang="en">
@@ -846,7 +846,7 @@ The content of this structure is not made public by the API.
<a name="ignorableWhitespaceSAXFunc"></a>Function type ignorableWhitespaceSAXFunc</h3>
<pre class="programlisting">void ignorableWhitespaceSAXFunc (void * ctx, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * ch, <br>
int len)<br>
</pre>
-<p>Receiving some ignorable whitespaces from the parser. UNUSED: by default the DOM building will use
characters.</p>
+<p>Receiving some ignorable whitespaces from the parser. UNUSED: by default the DOM building will use <a
href="libxml2-SAX.html#characters">characters</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1026,7 +1026,7 @@ The content of this structure is not made public by the API.
<a name="setDocumentLocatorSAXFunc"></a>Function type setDocumentLocatorSAXFunc</h3>
<pre class="programlisting">void setDocumentLocatorSAXFunc (void * ctx, <br>
<a href="libxml2-tree.html#xmlSAXLocatorPtr">xmlSAXLocatorPtr</a> loc)<br>
</pre>
-<p>Receive the document locator at startup, actually xmlDefaultSAXLocator. Everything is available on the
context, so this is useless in our case.</p>
+<p>Receive the document locator at startup, actually <a
href="libxml2-globals.html#xmlDefaultSAXLocator">xmlDefaultSAXLocator</a>. Everything is available on the
context, so this is useless in our case.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1267,7 +1267,7 @@ The content of this structure is not made public by the API.
<a name="xmlClearNodeInfoSeq"></a>xmlClearNodeInfoSeq ()</h3>
<pre class="programlisting">void xmlClearNodeInfoSeq (<a
href="libxml2-parser.html#xmlParserNodeInfoSeqPtr">xmlParserNodeInfoSeqPtr</a> seq)<br>
</pre>
-<p>-- Clear (release memory and reinitialize) node info sequence</p>
+<p>DEPRECATED: Don't use. -- Clear (release memory and reinitialize) node info sequence</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody><tr>
@@ -1360,7 +1360,7 @@ The content of this structure is not made public by the API.
<a name="xmlCreatePushParserCtxt"></a>xmlCreatePushParserCtxt ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a>
xmlCreatePushParserCtxt (<a href="libxml2-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br>
void * user_data, <br> const char
* chunk, <br> int size, <br>
const char * filename)<br>
</pre>
-<p>Create a parser context for using the XML parser in push mode. If @buffer and @size are non-NULL, the
data is used to detect the encoding. The remaining <a href="libxml2-SAX.html#characters">characters</a> will
be parsed so they don't need to be fed in again through xmlParseChunk. To allow content encoding detection,
@size should be >= 4 The value of @filename is used for fetching external entities and error/warning
reports.</p>
+<p>Create a parser context for using the XML parser in push mode. If @buffer and @size are non-NULL, the
data is used to detect the encoding. The remaining <a href="libxml2-SAX.html#characters">characters</a> will
be parsed so they don't need to be fed in again through <a
href="libxml2-parser.html#xmlParseChunk">xmlParseChunk</a>. To allow content encoding detection, @size should
be >= 4 The value of @filename is used for fetching external entities and error/warning reports.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1807,7 +1807,7 @@ The content of this structure is not made public by the API.
<a name="xmlInitNodeInfoSeq"></a>xmlInitNodeInfoSeq ()</h3>
<pre class="programlisting">void xmlInitNodeInfoSeq (<a
href="libxml2-parser.html#xmlParserNodeInfoSeqPtr">xmlParserNodeInfoSeqPtr</a> seq)<br>
</pre>
-<p>-- Initialize (set to initial state) node info sequence</p>
+<p>DEPRECATED: Don't use. -- Initialize (set to initial state) node info sequence</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody><tr>
@@ -2168,7 +2168,7 @@ The content of this structure is not made public by the API.
<a name="xmlParseDoc"></a>xmlParseDoc ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> xmlParseDoc
(const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * cur)<br>
</pre>
-<p>DEPRECATED: Use xmlReadDoc. parse an XML in-memory document and build a tree.</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlReadDoc">xmlReadDoc</a>. parse an XML in-memory document
and build a tree.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2298,7 +2298,7 @@ The content of this structure is not made public by the API.
<a name="xmlParseFile"></a>xmlParseFile ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> xmlParseFile
(const char * filename)<br>
</pre>
-<p>DEPRECATED: Use xmlReadFile. parse an XML file and build a tree. Automatic support for ZLIB/Compress
compressed document is provided by default if found at compile-time.</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlReadFile">xmlReadFile</a>. parse an XML file and build a
tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at
compile-time.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2358,7 +2358,7 @@ The content of this structure is not made public by the API.
<a name="xmlParseMemory"></a>xmlParseMemory ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> xmlParseMemory
(const char * buffer, <br> int size)<br>
</pre>
-<p>DEPRECATED: Use xmlReadMemory. parse an XML in-memory block and build a tree.</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlReadMemory">xmlReadMemory</a>. parse an XML in-memory
block and build a tree.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2383,7 +2383,7 @@ The content of this structure is not made public by the API.
<a name="xmlParserAddNodeInfo"></a>xmlParserAddNodeInfo ()</h3>
<pre class="programlisting">void xmlParserAddNodeInfo (<a
href="libxml2-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br>
const <a href="libxml2-parser.html#xmlParserNodeInfoPtr">xmlParserNodeInfoPtr</a> info)<br>
</pre>
-<p>Insert node info record into the sorted sequence</p>
+<p>DEPRECATED: Don't use. Insert node info record into the sorted sequence</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2404,7 +2404,7 @@ The content of this structure is not made public by the API.
<a name="xmlParserFindNodeInfo"></a>xmlParserFindNodeInfo ()</h3>
<pre class="programlisting">const <a href="libxml2-parser.html#xmlParserNodeInfo">xmlParserNodeInfo</a> *
xmlParserFindNodeInfo (const <a href="libxml2-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctx, <br>
const <a
href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> node)<br>
</pre>
-<p>Find the parser node info struct for a given node</p>
+<p>DEPRECATED: Don't use. Find the parser node info struct for a given node</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2429,7 +2429,7 @@ The content of this structure is not made public by the API.
<a name="xmlParserFindNodeInfoIndex"></a>xmlParserFindNodeInfoIndex ()</h3>
<pre class="programlisting">unsigned long xmlParserFindNodeInfoIndex (const <a
href="libxml2-parser.html#xmlParserNodeInfoSeqPtr">xmlParserNodeInfoSeqPtr</a> seq, <br>
const <a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> node)<br>
</pre>
-<p><a href="libxml2-parser.html#xmlParserFindNodeInfoIndex">xmlParserFindNodeInfoIndex</a> : Find the index
that the info record for the given node is or should be at in a sorted sequence</p>
+<p>DEPRECATED: Don't use. <a
href="libxml2-parser.html#xmlParserFindNodeInfoIndex">xmlParserFindNodeInfoIndex</a> : Find the index that
the info record for the given node is or should be at in a sorted sequence</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2454,7 +2454,7 @@ The content of this structure is not made public by the API.
<a name="xmlParserInputGrow"></a>xmlParserInputGrow ()</h3>
<pre class="programlisting">int xmlParserInputGrow (<a
href="libxml2-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> in, <br>
int len)<br>
</pre>
-<p>This function increase the input for the parser. It tries to preserve pointers to the input buffer, and
keep already read data</p>
+<p>DEPRECATED: Don't use. This function increase the input for the parser. It tries to preserve pointers to
the input buffer, and keep already read data</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2479,7 +2479,7 @@ The content of this structure is not made public by the API.
<a name="xmlParserInputRead"></a>xmlParserInputRead ()</h3>
<pre class="programlisting">int xmlParserInputRead (<a
href="libxml2-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> in, <br>
int len)<br>
</pre>
-<p>This function was internal and is deprecated.</p>
+<p>DEPRECATED: This function was internal and is deprecated.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2504,7 +2504,7 @@ The content of this structure is not made public by the API.
<a name="xmlPedanticParserDefault"></a>xmlPedanticParserDefault ()</h3>
<pre class="programlisting">int xmlPedanticParserDefault (int val)<br>
</pre>
-<p>Set and return the previous value for enabling pedantic warnings.</p>
+<p>DEPRECATED: Use the modern options API with <a
href="libxml2-parser.html#XML_PARSE_PEDANTIC">XML_PARSE_PEDANTIC</a>. Set and return the previous value for
enabling pedantic warnings.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2703,7 +2703,7 @@ The content of this structure is not made public by the API.
<a name="xmlRecoverDoc"></a>xmlRecoverDoc ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> xmlRecoverDoc
(const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * cur)<br>
</pre>
-<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlReadDoc">xmlReadDoc</a> with XML_PARSE_RECOVER. parse an
XML in-memory document and build a tree. In the case the document is not Well Formed, a attempt to build a
tree is tried anyway</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlReadDoc">xmlReadDoc</a> with <a
href="libxml2-parser.html#XML_PARSE_RECOVER">XML_PARSE_RECOVER</a>. parse an XML in-memory document and build
a tree. In the case the document is not Well Formed, a attempt to build a tree is tried anyway</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2725,7 +2725,7 @@ The content of this structure is not made public by the API.
<a name="xmlRecoverFile"></a>xmlRecoverFile ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> xmlRecoverFile
(const char * filename)<br>
</pre>
-<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlReadFile">xmlReadFile</a> with XML_PARSE_RECOVER. parse
an XML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default
if found at compile-time. In the case the document is not Well Formed, it attempts to build a tree anyway</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlReadFile">xmlReadFile</a> with <a
href="libxml2-parser.html#XML_PARSE_RECOVER">XML_PARSE_RECOVER</a>. parse an XML file and build a tree.
Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. In
the case the document is not Well Formed, it attempts to build a tree anyway</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2746,7 +2746,7 @@ The content of this structure is not made public by the API.
<a name="xmlRecoverMemory"></a>xmlRecoverMemory ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> xmlRecoverMemory
(const char * buffer, <br> int size)<br>
</pre>
-<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlReadMemory">xmlReadMemory</a> with XML_PARSE_RECOVER.
parse an XML in-memory block and build a tree. In the case the document is not Well Formed, an attempt to
build a tree is tried anyway</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlReadMemory">xmlReadMemory</a> with <a
href="libxml2-parser.html#XML_PARSE_RECOVER">XML_PARSE_RECOVER</a>. parse an XML in-memory block and build a
tree. In the case the document is not Well Formed, an attempt to build a tree is tried anyway</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2771,7 +2771,7 @@ The content of this structure is not made public by the API.
<a name="xmlSAXParseDTD"></a>xmlSAXParseDTD ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDtdPtr">xmlDtdPtr</a> xmlSAXParseDTD
(<a href="libxml2-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * ExternalID, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * SystemID)<br>
</pre>
-<p>Load and parse an external subset.</p>
+<p>DEPRECATED: Don't use. Load and parse an external subset.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2800,7 +2800,7 @@ The content of this structure is not made public by the API.
<a name="xmlSAXParseDoc"></a>xmlSAXParseDoc ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> xmlSAXParseDoc
(<a href="libxml2-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * cur, <br>
int recovery)<br>
</pre>
-<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and
xmlCtxtReadDoc. parse an XML in-memory document and build a tree. It use the given SAX function block to
handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines.</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and <a
href="libxml2-parser.html#xmlCtxtReadDoc">xmlCtxtReadDoc</a>. parse an XML in-memory document and build a
tree. It use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the
default DOM tree building routines.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2830,7 +2830,7 @@ The content of this structure is not made public by the API.
<a name="xmlSAXParseEntity"></a>xmlSAXParseEntity ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> xmlSAXParseEntity
(<a href="libxml2-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br>
const char * filename)<br>
</pre>
-<p>parse an XML external entity out of context and build a tree. It use the given SAX function block to
handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines. [78]
extParsedEnt ::= TextDecl? content This correspond to a "Well Balanced" chunk</p>
+<p>DEPRECATED: Don't use. parse an XML external entity out of context and build a tree. It use the given SAX
function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building
routines. [78] extParsedEnt ::= TextDecl? content This correspond to a "Well Balanced" chunk</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2855,7 +2855,7 @@ The content of this structure is not made public by the API.
<a name="xmlSAXParseFile"></a>xmlSAXParseFile ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> xmlSAXParseFile
(<a href="libxml2-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br>
const char * filename, <br> int recovery)<br>
</pre>
-<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and
xmlCtxtReadFile. parse an XML file and build a tree. Automatic support for ZLIB/Compress compressed document
is provided by default if found at compile-time. It use the given SAX function block to handle the parsing
callback. If sax is NULL, fallback to the default DOM tree building routines.</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and <a
href="libxml2-parser.html#xmlCtxtReadFile">xmlCtxtReadFile</a>. parse an XML file and build a tree. Automatic
support for ZLIB/Compress compressed document is provided by default if found at compile-time. It use the
given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree
building routines.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2884,7 +2884,7 @@ The content of this structure is not made public by the API.
<a name="xmlSAXParseFileWithData"></a>xmlSAXParseFileWithData ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a>
xmlSAXParseFileWithData (<a href="libxml2-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br>
const char * filename, <br> int recovery, <br>
void * data)<br>
</pre>
-<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and
xmlCtxtReadFile. parse an XML file and build a tree. Automatic support for ZLIB/Compress compressed document
is provided by default if found at compile-time. It use the given SAX function block to handle the parsing
callback. If sax is NULL, fallback to the default DOM tree building routines. User data (void *) is stored
within the parser context in the context's _private member, so it is available nearly everywhere in libxml</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and <a
href="libxml2-parser.html#xmlCtxtReadFile">xmlCtxtReadFile</a>. parse an XML file and build a tree. Automatic
support for ZLIB/Compress compressed document is provided by default if found at compile-time. It use the
given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree
building routines. User data (void *) is stored within the parser context in the context's _private member,
so it is available nearly everywhere in libxml</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2917,7 +2917,7 @@ The content of this structure is not made public by the API.
<a name="xmlSAXParseMemory"></a>xmlSAXParseMemory ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> xmlSAXParseMemory
(<a href="libxml2-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br>
const char * buffer, <br> int size, <br>
int recovery)<br>
</pre>
-<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and
xmlCtxtReadMemory. parse an XML in-memory block and use the given SAX function block to handle the parsing
callback. If sax is NULL, fallback to the default DOM tree building routines.</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and <a
href="libxml2-parser.html#xmlCtxtReadMemory">xmlCtxtReadMemory</a>. parse an XML in-memory block and use the
given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree
building routines.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2950,7 +2950,7 @@ The content of this structure is not made public by the API.
<a name="xmlSAXParseMemoryWithData"></a>xmlSAXParseMemoryWithData ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a>
xmlSAXParseMemoryWithData (<a href="libxml2-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br>
const char * buffer, <br>
int size, <br> int recovery, <br>
void * data)<br>
</pre>
-<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and
xmlCtxtReadMemory. parse an XML in-memory block and use the given SAX function block to handle the parsing
callback. If sax is NULL, fallback to the default DOM tree building routines. User data (void *) is stored
within the parser context in the context's _private member, so it is available nearly everywhere in libxml</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and <a
href="libxml2-parser.html#xmlCtxtReadMemory">xmlCtxtReadMemory</a>. parse an XML in-memory block and use the
given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree
building routines. User data (void *) is stored within the parser context in the context's _private member,
so it is available nearly everywhere in libxml</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2987,7 +2987,7 @@ The content of this structure is not made public by the API.
<a name="xmlSAXUserParseFile"></a>xmlSAXUserParseFile ()</h3>
<pre class="programlisting">int xmlSAXUserParseFile (<a
href="libxml2-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br>
void * user_data, <br> const char * filename)<br>
</pre>
-<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and
xmlCtxtReadFile. parse an XML file and call the given SAX handler routines. Automatic support for
ZLIB/Compress compressed document is provided</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and <a
href="libxml2-parser.html#xmlCtxtReadFile">xmlCtxtReadFile</a>. parse an XML file and call the given SAX
handler routines. Automatic support for ZLIB/Compress compressed document is provided</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -3016,7 +3016,7 @@ The content of this structure is not made public by the API.
<a name="xmlSAXUserParseMemory"></a>xmlSAXUserParseMemory ()</h3>
<pre class="programlisting">int xmlSAXUserParseMemory (<a
href="libxml2-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br>
void * user_data, <br> const char * buffer, <br>
int size)<br>
</pre>
-<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and
xmlCtxtReadMemory. parse an XML in-memory buffer and call the given SAX handler routines.</p>
+<p>DEPRECATED: Use <a href="libxml2-parser.html#xmlNewSAXParserCtxt">xmlNewSAXParserCtxt</a> and <a
href="libxml2-parser.html#xmlCtxtReadMemory">xmlCtxtReadMemory</a>. parse an XML in-memory buffer and call
the given SAX handler routines.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -3133,7 +3133,7 @@ The content of this structure is not made public by the API.
<a name="xmlSubstituteEntitiesDefault"></a>xmlSubstituteEntitiesDefault ()</h3>
<pre class="programlisting">int xmlSubstituteEntitiesDefault (int val)<br>
</pre>
-<p>Set and return the previous value for default entity support. Initially the parser always keep entity
references instead of substituting entity values in the output. This function has to be used to change the
default parser behavior SAX::substituteEntities() has to be used for changing that on a file by file
basis.</p>
+<p>DEPRECATED: Use the modern options API with <a
href="libxml2-parser.html#XML_PARSE_NOENT">XML_PARSE_NOENT</a>. Set and return the previous value for default
entity support. Initially the parser always keep entity references instead of substituting entity values in
the output. This function has to be used to change the default parser behavior SAX::substituteEntities() has
to be used for changing that on a file by file basis.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
diff --git a/doc/devhelp/libxml2-parserInternals.html b/doc/devhelp/libxml2-parserInternals.html
index e8bf357b..2e990df5 100644
--- a/doc/devhelp/libxml2-parserInternals.html
+++ b/doc/devhelp/libxml2-parserInternals.html
@@ -1358,7 +1358,7 @@ int <a href="#xmlSwitchToEncoding">xmlSwitchToEncoding</a> (<a
href="libxml2-tr
<a name="xmlParseAttributeType"></a>xmlParseAttributeType ()</h3>
<pre class="programlisting">int xmlParseAttributeType (<a
href="libxml2-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br>
<a href="libxml2-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> * tree)<br>
</pre>
-<p>parse the Attribute list def for an element [54] AttType ::= StringType | TokenizedType | EnumeratedType
[55] StringType ::= 'CDATA' [56] TokenizedType ::= 'ID' | 'IDREF' | 'IDREFS' | 'ENTITY' | 'ENTITIES' |
'NMTOKEN' | 'NMTOKENS' Validity constraints for <a href="libxml2-SAX.html#attribute">attribute</a> values
syntax are checked in xmlValidateAttributeValue() [ VC: ID ] Values of type ID must match the Name
production. A name must not appear more than once in an XML document as a value of this type; i.e., ID values
must uniquely identify the elements which bear them. [ VC: One ID per Element Type ] No element type may have
more than one ID <a href="libxml2-SAX.html#attribute">attribute</a> specified. [ VC: ID Attribute Default ]
An ID <a href="libxml2-SAX.html#attribute">attribute</a> must have a declared default of #IMPLIED or
#REQUIRED. [ VC: IDREF ] Values of type IDREF must match the Name production, and values of type IDREFS must
match Names; each IDREF Name must match the
value of an ID <a href="libxml2-SAX.html#attribute">attribute</a> on some element in the XML document; i.e.
IDREF values must match the value of some ID attribute. [ VC: Entity Name ] Values of type ENTITY must match
the Name production, values of type ENTITIES must match Names; each Entity Name must match the name of an
unparsed entity declared in the DTD. [ VC: Name Token ] Values of type NMTOKEN must match the Nmtoken
production; values of type NMTOKENS must match Nmtokens.</p>
+<p>parse the Attribute list def for an element [54] AttType ::= StringType | TokenizedType | EnumeratedType
[55] StringType ::= 'CDATA' [56] TokenizedType ::= 'ID' | 'IDREF' | 'IDREFS' | 'ENTITY' | 'ENTITIES' |
'NMTOKEN' | 'NMTOKENS' Validity constraints for <a href="libxml2-SAX.html#attribute">attribute</a> values
syntax are checked in xmlValidateAttributeValue() [ VC: ID ] Values of type ID must match the Name
production. A name must not appear more than once in an XML document as a value of this type; i.e., ID values
must uniquely identify the elements which bear them. [ VC: One ID per Element Type ] No element type may have
more than one ID <a href="libxml2-SAX.html#attribute">attribute</a> specified. [ VC: ID Attribute Default ]
An ID <a href="libxml2-SAX.html#attribute">attribute</a> must have a declared default of #IMPLIED or
#REQUIRED. [ VC: IDREF ] Values of type IDREF must match the Name production, and values of type IDREFS must
match Names; each IDREF Name must match the
value of an ID <a href="libxml2-SAX.html#attribute">attribute</a> on some element in the XML document; i.e.
IDREF values must match the value of some ID <a href="libxml2-SAX.html#attribute">attribute</a>. [ VC: Entity
Name ] Values of type ENTITY must match the Name production, values of type ENTITIES must match Names; each
Entity Name must match the name of an unparsed entity declared in the DTD. [ VC: Name Token ] Values of type
NMTOKEN must match the Nmtoken production; values of type NMTOKENS must match Nmtokens.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1485,7 +1485,7 @@ int <a href="#xmlSwitchToEncoding">xmlSwitchToEncoding</a> (<a
href="libxml2-tr
</tr>
<tr>
<td><span class="term"><i><tt>Returns</tt></i>:</span></td>
-<td>XML_ATTRIBUTE_NONE, XML_ATTRIBUTE_REQUIRED, <a
href="libxml2-tree.html#XML_ATTRIBUTE_IMPLIED">XML_ATTRIBUTE_IMPLIED</a> or XML_ATTRIBUTE_FIXED.</td>
+<td>XML_ATTRIBUTE_NONE, XML_ATTRIBUTE_REQUIRED, <a
href="libxml2-tree.html#XML_ATTRIBUTE_IMPLIED">XML_ATTRIBUTE_IMPLIED</a> or <a
href="libxml2-tree.html#XML_ATTRIBUTE_FIXED">XML_ATTRIBUTE_FIXED</a>.</td>
</tr>
</tbody>
</table></div>
diff --git a/doc/devhelp/libxml2-tree.html b/doc/devhelp/libxml2-tree.html
index c4f62fcf..e4987c13 100644
--- a/doc/devhelp/libxml2-tree.html
+++ b/doc/devhelp/libxml2-tree.html
@@ -268,7 +268,7 @@ int <a href="#xmlValidateQName">xmlValidateQName</a> (const <a
href="libxml2-xm
<a name="LIBXML2_NEW_BUFFER">Macro </a>LIBXML2_NEW_BUFFER</h3>
<pre class="programlisting">#define <a href="#LIBXML2_NEW_BUFFER">LIBXML2_NEW_BUFFER</a>;
</pre>
-<p>Macro used to express that the API use the new buffers for <a
href="libxml2-tree.html#xmlParserInputBuffer">xmlParserInputBuffer</a> and xmlOutputBuffer. The change was
introduced in 2.9.0.</p>
+<p>Macro used to express that the API use the new buffers for <a
href="libxml2-tree.html#xmlParserInputBuffer">xmlParserInputBuffer</a> and <a
href="libxml2-tree.html#xmlOutputBuffer">xmlOutputBuffer</a>. The change was introduced in 2.9.0.</p>
</div>
<hr>
<div class="refsect2" lang="en">
@@ -1219,7 +1219,7 @@ The content of this structure is not made public by the API.
<a name="xmlAddChildList"></a>xmlAddChildList ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlAddChildList
(<a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> parent, <br> <a
href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> cur)<br>
</pre>
-<p>Add a list of node at the end of the child list of the parent merging adjacent TEXT nodes (@cur may be
freed) See the note regarding namespaces in xmlAddChild.</p>
+<p>Add a list of node at the end of the child list of the parent merging adjacent TEXT nodes (@cur may be
freed) See the note regarding namespaces in <a href="libxml2-tree.html#xmlAddChild">xmlAddChild</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1244,7 +1244,7 @@ The content of this structure is not made public by the API.
<a name="xmlAddNextSibling"></a>xmlAddNextSibling ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlAddNextSibling
(<a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br> <a
href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> elem)<br>
</pre>
-<p>Add a new node @elem as the next sibling of @cur If the new node was already inserted in a document it is
first unlinked from its existing context. As a result of text merging @elem may be freed. If the new node is
ATTRIBUTE, it is added into properties instead of children. If there is an <a
href="libxml2-SAX.html#attribute">attribute</a> with equal name, it is first destroyed. See the note
regarding namespaces in xmlAddChild.</p>
+<p>Add a new node @elem as the next sibling of @cur If the new node was already inserted in a document it is
first unlinked from its existing context. As a result of text merging @elem may be freed. If the new node is
ATTRIBUTE, it is added into properties instead of children. If there is an <a
href="libxml2-SAX.html#attribute">attribute</a> with equal name, it is first destroyed. See the note
regarding namespaces in <a href="libxml2-tree.html#xmlAddChild">xmlAddChild</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1269,7 +1269,7 @@ The content of this structure is not made public by the API.
<a name="xmlAddPrevSibling"></a>xmlAddPrevSibling ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlAddPrevSibling
(<a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br> <a
href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> elem)<br>
</pre>
-<p>Add a new node @elem as the previous sibling of @cur merging adjacent TEXT nodes (@elem may be freed) If
the new node was already inserted in a document it is first unlinked from its existing context. If the new
node is ATTRIBUTE, it is added into properties instead of children. If there is an <a
href="libxml2-SAX.html#attribute">attribute</a> with equal name, it is first destroyed. See the note
regarding namespaces in xmlAddChild.</p>
+<p>Add a new node @elem as the previous sibling of @cur merging adjacent TEXT nodes (@elem may be freed) If
the new node was already inserted in a document it is first unlinked from its existing context. If the new
node is ATTRIBUTE, it is added into properties instead of children. If there is an <a
href="libxml2-SAX.html#attribute">attribute</a> with equal name, it is first destroyed. See the note
regarding namespaces in <a href="libxml2-tree.html#xmlAddChild">xmlAddChild</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1294,7 +1294,7 @@ The content of this structure is not made public by the API.
<a name="xmlAddSibling"></a>xmlAddSibling ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlAddSibling
(<a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br> <a
href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> elem)<br>
</pre>
-<p>Add a new element @elem to the list of siblings of @cur merging adjacent TEXT nodes (@elem may be freed)
If the new element was already inserted in a document it is first unlinked from its existing context. See the
note regarding namespaces in xmlAddChild.</p>
+<p>Add a new element @elem to the list of siblings of @cur merging adjacent TEXT nodes (@elem may be freed)
If the new element was already inserted in a document it is first unlinked from its existing context. See the
note regarding namespaces in <a href="libxml2-tree.html#xmlAddChild">xmlAddChild</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2133,7 +2133,7 @@ The content of this structure is not made public by the API.
<a name="xmlCopyProp"></a>xmlCopyProp ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlAttrPtr">xmlAttrPtr</a> xmlCopyProp
(<a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> target, <br> <a
href="libxml2-tree.html#xmlAttrPtr">xmlAttrPtr</a> cur)<br>
</pre>
-<p>Do a copy of the attribute.</p>
+<p>Do a copy of the <a href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -3051,7 +3051,7 @@ The content of this structure is not made public by the API.
<a name="xmlGetProp"></a>xmlGetProp ()</h3>
<pre class="programlisting"><a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * xmlGetProp
(const <a href="libxml2-tree.html#xmlNode">xmlNode</a> * node, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name)<br>
</pre>
-<p>Search and get the value of an <a href="libxml2-SAX.html#attribute">attribute</a> associated to a node
This does the entity substitution. This function looks in DTD <a
href="libxml2-SAX.html#attribute">attribute</a> declaration for #FIXED or default declaration values unless
DTD use has been turned off. NOTE: this function acts independently of namespaces associated to the
attribute. Use xmlGetNsProp() or xmlGetNoNsProp() for namespace aware processing.</p>
+<p>Search and get the value of an <a href="libxml2-SAX.html#attribute">attribute</a> associated to a node
This does the entity substitution. This function looks in DTD <a
href="libxml2-SAX.html#attribute">attribute</a> declaration for #FIXED or default declaration values unless
DTD use has been turned off. NOTE: this function acts independently of namespaces associated to the <a
href="libxml2-SAX.html#attribute">attribute</a>. Use xmlGetNsProp() or xmlGetNoNsProp() for namespace aware
processing.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -3284,7 +3284,7 @@ The content of this structure is not made public by the API.
<a name="xmlNewComment"></a>xmlNewComment ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewComment
(const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * content)<br>
</pre>
-<p>Use of this function is DISCOURAGED in favor of xmlNewDocComment. Creation of a new node containing a
comment.</p>
+<p>Use of this function is DISCOURAGED in favor of <a
href="libxml2-tree.html#xmlNewDocComment">xmlNewDocComment</a>. Creation of a new node containing a <a
href="libxml2-SAX.html#comment">comment</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -3649,7 +3649,7 @@ The content of this structure is not made public by the API.
<a name="xmlNewNode"></a>xmlNewNode ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewNode
(<a href="libxml2-tree.html#xmlNsPtr">xmlNsPtr</a> ns, <br> const <a
href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name)<br>
</pre>
-<p>Creation of a new node element. @ns is optional (NULL). Use of this function is DISCOURAGED in favor of
xmlNewDocNode.</p>
+<p>Creation of a new node element. @ns is optional (NULL). Use of this function is DISCOURAGED in favor of
<a href="libxml2-tree.html#xmlNewDocNode">xmlNewDocNode</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -3674,7 +3674,7 @@ The content of this structure is not made public by the API.
<a name="xmlNewNodeEatName"></a>xmlNewNodeEatName ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewNodeEatName
(<a href="libxml2-tree.html#xmlNsPtr">xmlNsPtr</a> ns, <br> <a
href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name)<br>
</pre>
-<p>Creation of a new node element. @ns is optional (NULL). Use of this function is DISCOURAGED in favor of
xmlNewDocNodeEatName.</p>
+<p>Creation of a new node element. @ns is optional (NULL). Use of this function is DISCOURAGED in favor of
<a href="libxml2-tree.html#xmlNewDocNodeEatName">xmlNewDocNodeEatName</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -3800,7 +3800,7 @@ The content of this structure is not made public by the API.
<a name="xmlNewPI"></a>xmlNewPI ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewPI
(const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * content)<br>
</pre>
-<p>Creation of a processing instruction element. Use of this function is DISCOURAGED in favor of
xmlNewDocPI.</p>
+<p>Creation of a processing instruction element. Use of this function is DISCOURAGED in favor of <a
href="libxml2-tree.html#xmlNewDocPI">xmlNewDocPI</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -3882,7 +3882,7 @@ The content of this structure is not made public by the API.
<a name="xmlNewText"></a>xmlNewText ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewText
(const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * content)<br>
</pre>
-<p>Creation of a new text node. Use of this function is DISCOURAGED in favor of xmlNewDocText.</p>
+<p>Creation of a new text node. Use of this function is DISCOURAGED in favor of <a
href="libxml2-tree.html#xmlNewDocText">xmlNewDocText</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -3936,7 +3936,7 @@ The content of this structure is not made public by the API.
<a name="xmlNewTextLen"></a>xmlNewTextLen ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewTextLen
(const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * content, <br>
int len)<br>
</pre>
-<p>Use of this function is DISCOURAGED in favor of xmlNewDocTextLen. Creation of a new text node with an
extra parameter for the content's length</p>
+<p>Use of this function is DISCOURAGED in favor of <a
href="libxml2-tree.html#xmlNewDocTextLen">xmlNewDocTextLen</a>. Creation of a new text node with an extra
parameter for the content's length</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -4294,7 +4294,7 @@ The content of this structure is not made public by the API.
<a name="xmlNodeSetBase"></a>xmlNodeSetBase ()</h3>
<pre class="programlisting">void xmlNodeSetBase (<a
href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br> const <a
href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * uri)<br>
</pre>
-<p>Set (or reset) the base URI of a node, i.e. the value of the xml:base attribute.</p>
+<p>Set (or reset) the base URI of a node, i.e. the value of the xml:base <a
href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -4361,7 +4361,7 @@ The content of this structure is not made public by the API.
<a name="xmlNodeSetLang"></a>xmlNodeSetLang ()</h3>
<pre class="programlisting">void xmlNodeSetLang (<a
href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br> const <a
href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * lang)<br>
</pre>
-<p>Set the language of a node, i.e. the values of the xml:lang attribute.</p>
+<p>Set the language of a node, i.e. the values of the xml:lang <a
href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -4403,7 +4403,7 @@ The content of this structure is not made public by the API.
<a name="xmlNodeSetSpacePreserve"></a>xmlNodeSetSpacePreserve ()</h3>
<pre class="programlisting">void xmlNodeSetSpacePreserve (<a
href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br> int
val)<br>
</pre>
-<p>Set (or reset) the space preserving behaviour of a node, i.e. the value of the xml:space attribute.</p>
+<p>Set (or reset) the space preserving behaviour of a node, i.e. the value of the xml:space <a
href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -4492,7 +4492,7 @@ The content of this structure is not made public by the API.
<a name="xmlReplaceNode"></a>xmlReplaceNode ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> xmlReplaceNode
(<a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> old, <br> <a
href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> cur)<br>
</pre>
-<p>Unlink the old node from its current context, prune the new one at the same place. If @cur was already
inserted in a document it is first unlinked from its existing context. See the note regarding namespaces in
xmlAddChild.</p>
+<p>Unlink the old node from its current context, prune the new one at the same place. If @cur was already
inserted in a document it is first unlinked from its existing context. See the note regarding namespaces in
<a href="libxml2-tree.html#xmlAddChild">xmlAddChild</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
diff --git a/doc/devhelp/libxml2-xmlreader.html b/doc/devhelp/libxml2-xmlreader.html
index 02306873..bb012e6a 100644
--- a/doc/devhelp/libxml2-xmlreader.html
+++ b/doc/devhelp/libxml2-xmlreader.html
@@ -312,7 +312,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderForDoc"></a>xmlReaderForDoc ()</h3>
<pre class="programlisting"><a href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a>
xmlReaderForDoc (const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * cur, <br>
const char * URL, <br> const char * encoding, <br>
int options)<br>
</pre>
-<p>Create an xmltextReader for an XML in-memory document. The parsing flags @options are a combination of
xmlParserOption.</p>
+<p>Create an xmltextReader for an XML in-memory document. The parsing flags @options are a combination of <a
href="libxml2-parser.html#xmlParserOption">xmlParserOption</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -346,7 +346,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderForFd"></a>xmlReaderForFd ()</h3>
<pre class="programlisting"><a href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a>
xmlReaderForFd (int fd, <br> const char * URL, <br>
const char * encoding, <br> int options)<br>
</pre>
-<p>Create an xmltextReader for an XML from a file descriptor. The parsing flags @options are a combination
of xmlParserOption. NOTE that the file descriptor will not be closed when the reader is closed or reset.</p>
+<p>Create an xmltextReader for an XML from a file descriptor. The parsing flags @options are a combination
of <a href="libxml2-parser.html#xmlParserOption">xmlParserOption</a>. NOTE that the file descriptor will not
be closed when the reader is closed or reset.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -380,7 +380,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderForFile"></a>xmlReaderForFile ()</h3>
<pre class="programlisting"><a href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a>
xmlReaderForFile (const char * filename, <br> const char *
encoding, <br> int options)<br>
</pre>
-<p>parse an XML file from the filesystem or the network. The parsing flags @options are a combination of
xmlParserOption.</p>
+<p>parse an XML file from the filesystem or the network. The parsing flags @options are a combination of <a
href="libxml2-parser.html#xmlParserOption">xmlParserOption</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -410,7 +410,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderForIO"></a>xmlReaderForIO ()</h3>
<pre class="programlisting"><a href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a>
xmlReaderForIO (<a href="libxml2-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread, <br>
<a
href="libxml2-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose, <br>
void * ioctx, <br> const char * URL, <br>
const char * encoding, <br> int options)<br>
</pre>
-<p>Create an xmltextReader for an XML document from I/O functions and source. The parsing flags @options are
a combination of xmlParserOption.</p>
+<p>Create an xmltextReader for an XML document from I/O functions and source. The parsing flags @options are
a combination of <a href="libxml2-parser.html#xmlParserOption">xmlParserOption</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -452,7 +452,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderForMemory"></a>xmlReaderForMemory ()</h3>
<pre class="programlisting"><a href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a>
xmlReaderForMemory (const char * buffer, <br> int size,
<br> const char * URL, <br>
const char * encoding, <br> int options)<br>
</pre>
-<p>Create an xmltextReader for an XML in-memory document. The parsing flags @options are a combination of
xmlParserOption.</p>
+<p>Create an xmltextReader for an XML in-memory document. The parsing flags @options are a combination of <a
href="libxml2-parser.html#xmlParserOption">xmlParserOption</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -490,7 +490,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderNewDoc"></a>xmlReaderNewDoc ()</h3>
<pre class="programlisting">int xmlReaderNewDoc (<a
href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * cur, <br>
const char * URL, <br> const char * encoding, <br>
int options)<br>
</pre>
-<p>Setup an xmltextReader to parse an XML in-memory document. The parsing flags @options are a combination
of xmlParserOption. This reuses the existing @reader xmlTextReader.</p>
+<p>Setup an xmltextReader to parse an XML in-memory document. The parsing flags @options are a combination
of <a href="libxml2-parser.html#xmlParserOption">xmlParserOption</a>. This reuses the existing @reader <a
href="libxml2-xmlreader.html#xmlTextReader">xmlTextReader</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -528,7 +528,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderNewFd"></a>xmlReaderNewFd ()</h3>
<pre class="programlisting">int xmlReaderNewFd (<a
href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader, <br>
int fd, <br> const char * URL, <br>
const char * encoding, <br> int options)<br>
</pre>
-<p>Setup an xmltextReader to parse an XML from a file descriptor. NOTE that the file descriptor will not be
closed when the reader is closed or reset. The parsing flags @options are a combination of xmlParserOption.
This reuses the existing @reader xmlTextReader.</p>
+<p>Setup an xmltextReader to parse an XML from a file descriptor. NOTE that the file descriptor will not be
closed when the reader is closed or reset. The parsing flags @options are a combination of <a
href="libxml2-parser.html#xmlParserOption">xmlParserOption</a>. This reuses the existing @reader <a
href="libxml2-xmlreader.html#xmlTextReader">xmlTextReader</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -566,7 +566,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderNewFile"></a>xmlReaderNewFile ()</h3>
<pre class="programlisting">int xmlReaderNewFile (<a
href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader, <br>
const char * filename, <br> const char * encoding, <br>
int options)<br>
</pre>
-<p>parse an XML file from the filesystem or the network. The parsing flags @options are a combination of
xmlParserOption. This reuses the existing @reader xmlTextReader.</p>
+<p>parse an XML file from the filesystem or the network. The parsing flags @options are a combination of <a
href="libxml2-parser.html#xmlParserOption">xmlParserOption</a>. This reuses the existing @reader <a
href="libxml2-xmlreader.html#xmlTextReader">xmlTextReader</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -600,7 +600,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderNewIO"></a>xmlReaderNewIO ()</h3>
<pre class="programlisting">int xmlReaderNewIO (<a
href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader, <br>
<a href="libxml2-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread, <br>
<a href="libxml2-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a>
ioclose, <br> void * ioctx, <br>
const char * URL, <br> const char * encoding, <br>
int options)<br>
</pre>
-<p>Setup an xmltextReader to parse an XML document from I/O functions and source. The parsing flags @options
are a combination of xmlParserOption. This reuses the existing @reader xmlTextReader.</p>
+<p>Setup an xmltextReader to parse an XML document from I/O functions and source. The parsing flags @options
are a combination of <a href="libxml2-parser.html#xmlParserOption">xmlParserOption</a>. This reuses the
existing @reader <a href="libxml2-xmlreader.html#xmlTextReader">xmlTextReader</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -646,7 +646,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderNewMemory"></a>xmlReaderNewMemory ()</h3>
<pre class="programlisting">int xmlReaderNewMemory (<a
href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader, <br>
const char * buffer, <br> int size, <br>
const char * URL, <br> const char * encoding, <br>
int options)<br>
</pre>
-<p>Setup an xmltextReader to parse an XML in-memory document. The parsing flags @options are a combination
of xmlParserOption. This reuses the existing @reader xmlTextReader.</p>
+<p>Setup an xmltextReader to parse an XML in-memory document. The parsing flags @options are a combination
of <a href="libxml2-parser.html#xmlParserOption">xmlParserOption</a>. This reuses the existing @reader <a
href="libxml2-xmlreader.html#xmlTextReader">xmlTextReader</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -688,7 +688,7 @@ The content of this structure is not made public by the API.
<a name="xmlReaderNewWalker"></a>xmlReaderNewWalker ()</h3>
<pre class="programlisting">int xmlReaderNewWalker (<a
href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader, <br>
<a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> doc)<br>
</pre>
-<p>Setup an xmltextReader to parse a preparsed XML document. This reuses the existing @reader
xmlTextReader.</p>
+<p>Setup an xmltextReader to parse a preparsed XML document. This reuses the existing @reader <a
href="libxml2-xmlreader.html#xmlTextReader">xmlTextReader</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1032,7 +1032,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextReaderCurrentDoc"></a>xmlTextReaderCurrentDoc ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a>
xmlTextReaderCurrentDoc (<a href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader)<br>
</pre>
-<p>Hacking interface allowing to get the <a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> corresponding
to the current document being accessed by the xmlTextReader. NOTE: as a result of this call, the reader will
not destroy the associated XML document and calling xmlFreeDoc() on the result is needed once the reader
parsing has finished.</p>
+<p>Hacking interface allowing to get the <a href="libxml2-tree.html#xmlDocPtr">xmlDocPtr</a> corresponding
to the current document being accessed by the <a
href="libxml2-xmlreader.html#xmlTextReader">xmlTextReader</a>. NOTE: as a result of this call, the reader
will not destroy the associated XML document and calling xmlFreeDoc() on the result is needed once the reader
parsing has finished.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1053,7 +1053,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextReaderCurrentNode"></a>xmlTextReaderCurrentNode ()</h3>
<pre class="programlisting"><a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a>
xmlTextReaderCurrentNode (<a href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a>
reader)<br>
</pre>
-<p>Hacking interface allowing to get the <a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> corresponding
to the current node being accessed by the xmlTextReader. This is dangerous because the underlying node may be
destroyed on the next Reads.</p>
+<p>Hacking interface allowing to get the <a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> corresponding
to the current node being accessed by the <a href="libxml2-xmlreader.html#xmlTextReader">xmlTextReader</a>.
This is dangerous because the underlying node may be destroyed on the next Reads.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1126,7 +1126,7 @@ The content of this structure is not made public by the API.
</tr>
<tr>
<td><span class="term"><i><tt>name</tt></i>:</span></td>
-<td>the qualified name of the attribute.</td>
+<td>the qualified name of the <a href="libxml2-SAX.html#attribute">attribute</a>.</td>
</tr>
<tr>
<td><span class="term"><i><tt>Returns</tt></i>:</span></td>
@@ -1176,11 +1176,11 @@ The content of this structure is not made public by the API.
</tr>
<tr>
<td><span class="term"><i><tt>localName</tt></i>:</span></td>
-<td>the local name of the attribute.</td>
+<td>the local name of the <a href="libxml2-SAX.html#attribute">attribute</a>.</td>
</tr>
<tr>
<td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td>
-<td>the namespace URI of the attribute.</td>
+<td>the namespace URI of the <a href="libxml2-SAX.html#attribute">attribute</a>.</td>
</tr>
<tr>
<td><span class="term"><i><tt>Returns</tt></i>:</span></td>
@@ -1392,7 +1392,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextReaderIsNamespaceDecl"></a>xmlTextReaderIsNamespaceDecl ()</h3>
<pre class="programlisting">int xmlTextReaderIsNamespaceDecl (<a
href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader)<br>
</pre>
-<p>Determine whether the current node is a namespace declaration rather than a regular attribute.</p>
+<p>Determine whether the current node is a namespace declaration rather than a regular <a
href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1532,7 +1532,7 @@ The content of this structure is not made public by the API.
</tr>
<tr>
<td><span class="term"><i><tt>name</tt></i>:</span></td>
-<td>the qualified name of the attribute.</td>
+<td>the qualified name of the <a href="libxml2-SAX.html#attribute">attribute</a>.</td>
</tr>
<tr>
<td><span class="term"><i><tt>Returns</tt></i>:</span></td>
@@ -1582,11 +1582,11 @@ The content of this structure is not made public by the API.
</tr>
<tr>
<td><span class="term"><i><tt>localName</tt></i>:</span></td>
-<td>the local name of the attribute.</td>
+<td>the local name of the <a href="libxml2-SAX.html#attribute">attribute</a>.</td>
</tr>
<tr>
<td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td>
-<td>the namespace URI of the attribute.</td>
+<td>the namespace URI of the <a href="libxml2-SAX.html#attribute">attribute</a>.</td>
</tr>
<tr>
<td><span class="term"><i><tt>Returns</tt></i>:</span></td>
@@ -1861,7 +1861,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextReaderQuoteChar"></a>xmlTextReaderQuoteChar ()</h3>
<pre class="programlisting">int xmlTextReaderQuoteChar (<a
href="libxml2-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader)<br>
</pre>
-<p>The quotation mark character used to enclose the value of an attribute.</p>
+<p>The quotation mark character used to enclose the value of an <a
href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
diff --git a/doc/devhelp/libxml2-xmlschemastypes.html b/doc/devhelp/libxml2-xmlschemastypes.html
index 5760adf6..8d4459ab 100644
--- a/doc/devhelp/libxml2-xmlschemastypes.html
+++ b/doc/devhelp/libxml2-xmlschemastypes.html
@@ -513,7 +513,7 @@ const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * <a href="#xmlSchema
<a name="xmlSchemaNewStringValue"></a>xmlSchemaNewStringValue ()</h3>
<pre class="programlisting"><a href="libxml2-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a>
xmlSchemaNewStringValue (<a href="libxml2-schemasInternals.html#xmlSchemaValType">xmlSchemaValType</a>
type, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a>
* value)<br>
</pre>
-<p>Allocate a new simple type value. The type can be of XML_SCHEMAS_STRING. WARNING: This one is intended to
be expanded for other string based types. We need this for anySimpleType as well. The given value is consumed
and freed with the struct.</p>
+<p>Allocate a new simple type value. The type can be of <a
href="libxml2-schemasInternals.html#XML_SCHEMAS_STRING">XML_SCHEMAS_STRING</a>. WARNING: This one is intended
to be expanded for other string based types. We need this for anySimpleType as well. The given value is
consumed and freed with the struct.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
diff --git a/doc/devhelp/libxml2-xmlwriter.html b/doc/devhelp/libxml2-xmlwriter.html
index 9418ea8d..a274d09f 100644
--- a/doc/devhelp/libxml2-xmlwriter.html
+++ b/doc/devhelp/libxml2-xmlwriter.html
@@ -364,7 +364,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextWriterEndComment"></a>xmlTextWriterEndComment ()</h3>
<pre class="programlisting">int xmlTextWriterEndComment (<a
href="libxml2-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer)<br>
</pre>
-<p>End the current xml comment.</p>
+<p>End the current xml <a href="libxml2-SAX.html#comment">comment</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -662,7 +662,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextWriterStartAttribute"></a>xmlTextWriterStartAttribute ()</h3>
<pre class="programlisting">int xmlTextWriterStartAttribute (<a
href="libxml2-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name)<br>
</pre>
-<p>Start an xml attribute.</p>
+<p>Start an xml <a href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -744,7 +744,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextWriterStartComment"></a>xmlTextWriterStartComment ()</h3>
<pre class="programlisting">int xmlTextWriterStartComment (<a
href="libxml2-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer)<br>
</pre>
-<p>Start an xml comment.</p>
+<p>Start an xml <a href="libxml2-SAX.html#comment">comment</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1002,7 +1002,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextWriterWriteAttribute"></a>xmlTextWriterWriteAttribute ()</h3>
<pre class="programlisting">int xmlTextWriterWriteAttribute (<a
href="libxml2-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * content)<br>
</pre>
-<p>Write an xml attribute.</p>
+<p>Write an xml <a href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1034,7 +1034,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextWriterWriteAttributeNS"></a>xmlTextWriterWriteAttributeNS ()</h3>
<pre class="programlisting">int xmlTextWriterWriteAttributeNS (<a
href="libxml2-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * prefix, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * namespaceURI, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * content)<br>
</pre>
-<p>Write an xml attribute.</p>
+<p>Write an xml <a href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1168,7 +1168,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextWriterWriteComment"></a>xmlTextWriterWriteComment ()</h3>
<pre class="programlisting">int xmlTextWriterWriteComment (<a
href="libxml2-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * content)<br>
</pre>
-<p>Write an xml comment.</p>
+<p>Write an xml <a href="libxml2-SAX.html#comment">comment</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1551,7 +1551,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextWriterWriteFormatAttribute"></a>xmlTextWriterWriteFormatAttribute ()</h3>
<pre class="programlisting">int xmlTextWriterWriteFormatAttribute (<a
href="libxml2-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name, <br>
const char * format, <br> ... ...)<br>
</pre>
-<p>Write a formatted xml attribute.</p>
+<p>Write a formatted xml <a href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -1659,7 +1659,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextWriterWriteFormatComment"></a>xmlTextWriterWriteFormatComment ()</h3>
<pre class="programlisting">int xmlTextWriterWriteFormatComment (<a
href="libxml2-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer, <br>
const char * format, <br> ... ...)<br>
</pre>
-<p>Write an xml comment.</p>
+<p>Write an xml <a href="libxml2-SAX.html#comment">comment</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2119,7 +2119,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextWriterWriteVFormatAttribute"></a>xmlTextWriterWriteVFormatAttribute ()</h3>
<pre class="programlisting">int xmlTextWriterWriteVFormatAttribute (<a
href="libxml2-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer, <br>
const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name, <br>
const char * format, <br> va_list
argptr)<br>
</pre>
-<p>Write a formatted xml attribute.</p>
+<p>Write a formatted xml <a href="libxml2-SAX.html#attribute">attribute</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
@@ -2227,7 +2227,7 @@ The content of this structure is not made public by the API.
<a name="xmlTextWriterWriteVFormatComment"></a>xmlTextWriterWriteVFormatComment ()</h3>
<pre class="programlisting">int xmlTextWriterWriteVFormatComment (<a
href="libxml2-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer, <br>
const char * format, <br> va_list argptr)<br>
</pre>
-<p>Write an xml comment.</p>
+<p>Write an xml <a href="libxml2-SAX.html#comment">comment</a>.</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
diff --git a/doc/devhelp/libxml2-xpathInternals.html b/doc/devhelp/libxml2-xpathInternals.html
index e5edfac4..750dade3 100644
--- a/doc/devhelp/libxml2-xpathInternals.html
+++ b/doc/devhelp/libxml2-xpathInternals.html
@@ -1227,7 +1227,7 @@ void <a href="#xmlXPatherror">xmlXPatherror</a> (<a
href="libxml2-xpath.html#x
<a name="xmlXPathLangFunction"></a>xmlXPathLangFunction ()</h3>
<pre class="programlisting">void xmlXPathLangFunction (<a
href="libxml2-xpath.html#xmlXPathParserContextPtr">xmlXPathParserContextPtr</a> ctxt, <br>
int nargs)<br>
</pre>
-<p>Implement the lang() XPath function boolean lang(string) The lang function returns true or false
depending on whether the language of the context node as specified by xml:lang attributes is the same as or
is a sublanguage of the language specified by the argument string. The language of the context node is
determined by the value of the xml:lang <a href="libxml2-SAX.html#attribute">attribute</a> on the context
node, or, if the context node has no xml:lang attribute, by the value of the xml:lang <a
href="libxml2-SAX.html#attribute">attribute</a> on the nearest ancestor of the context node that has an
xml:lang attribute. If there is no such attribute, then lang</p>
+<p>Implement the lang() XPath function boolean lang(string) The lang function returns true or false
depending on whether the language of the context node as specified by xml:lang attributes is the same as or
is a sublanguage of the language specified by the argument string. The language of the context node is
determined by the value of the xml:lang <a href="libxml2-SAX.html#attribute">attribute</a> on the context
node, or, if the context node has no xml:lang attribute, by the value of the xml:lang <a
href="libxml2-SAX.html#attribute">attribute</a> on the nearest ancestor of the context node that has an
xml:lang <a href="libxml2-SAX.html#attribute">attribute</a>. If there is no such attribute, then lang</p>
<div class="variablelist"><table border="0">
<col align="left">
<tbody>
diff --git a/doc/libxml2-api.xml b/doc/libxml2-api.xml
index 0fe2f582..0bcdcdad 100644
--- a/doc/libxml2-api.xml
+++ b/doc/libxml2-api.xml
@@ -9011,7 +9011,7 @@ Could we use @subtypes for this?'/>
<return type='void'/>
</function>
<function name='xmlClearNodeInfoSeq' file='parser' module='parserInternals'>
- <info>-- Clear (release memory and reinitialize) node info sequence</info>
+ <info>DEPRECATED: Don't use. -- Clear (release memory and reinitialize) node info sequence</info>
<return type='void'/>
<arg name='seq' type='xmlParserNodeInfoSeqPtr' info='a node info sequence pointer'/>
</function>
@@ -10582,7 +10582,7 @@ Could we use @subtypes for this?'/>
<return type='int' info='0 on success'/>
</function>
<function name='xmlInitNodeInfoSeq' file='parser' module='parserInternals'>
- <info>-- Initialize (set to initial state) node info sequence</info>
+ <info>DEPRECATED: Don't use. -- Initialize (set to initial state) node info sequence</info>
<return type='void'/>
<arg name='seq' type='xmlParserNodeInfoSeqPtr' info='a node info sequence pointer'/>
</function>
@@ -12352,7 +12352,7 @@ Could we use @subtypes for this?'/>
<arg name='ctxt' type='xmlParserCtxtPtr' info='an XML parser context'/>
</function>
<function name='xmlParserAddNodeInfo' file='parser' module='parserInternals'>
- <info>Insert node info record into the sorted sequence</info>
+ <info>DEPRECATED: Don't use. Insert node info record into the sorted sequence</info>
<return type='void'/>
<arg name='ctxt' type='xmlParserCtxtPtr' info='an XML parser context'/>
<arg name='info' type='const xmlParserNodeInfoPtr' info='a node info sequence pointer'/>
@@ -12365,13 +12365,13 @@ Could we use @subtypes for this?'/>
<arg name='...' type='...' info='extra parameters for the message display'/>
</function>
<function name='xmlParserFindNodeInfo' file='parser' module='parserInternals'>
- <info>Find the parser node info struct for a given node</info>
+ <info>DEPRECATED: Don't use. Find the parser node info struct for a given node</info>
<return type='const xmlParserNodeInfo *' info='an xmlParserNodeInfo block pointer or NULL'/>
<arg name='ctx' type='const xmlParserCtxtPtr' info='an XML parser context'/>
<arg name='node' type='const xmlNodePtr' info='an XML node within the tree'/>
</function>
<function name='xmlParserFindNodeInfoIndex' file='parser' module='parserInternals'>
- <info>xmlParserFindNodeInfoIndex : Find the index that the info record for the given node is or should
be at in a sorted sequence</info>
+ <info>DEPRECATED: Don't use. xmlParserFindNodeInfoIndex : Find the index that the info record
for the given node is or should be at in a sorted sequence</info>
<return type='unsigned long' info='a long indicating the position of the record'/>
<arg name='seq' type='const xmlParserNodeInfoSeqPtr' info='a node info sequence pointer'/>
<arg name='node' type='const xmlNodePtr' info='an XML node pointer'/>
@@ -12468,13 +12468,13 @@ Could we use @subtypes for this?'/>
<arg name='str' type='xmlChar *' info='the string to deallocate'/>
</functype>
<function name='xmlParserInputGrow' file='parser' module='parserInternals'>
- <info>This function increase the input for the parser. It tries to preserve pointers to the input
buffer, and keep already read data</info>
+ <info>DEPRECATED: Don't use. This function increase the input for the parser. It tries to
preserve pointers to the input buffer, and keep already read data</info>
<return type='int' info='the amount of char read, or -1 in case of error, 0 indicate the end of this
entity'/>
<arg name='in' type='xmlParserInputPtr' info='an XML parser input'/>
<arg name='len' type='int' info='an indicative size for the lookahead'/>
</function>
<function name='xmlParserInputRead' file='parser' module='parserInternals'>
- <info>This function was internal and is deprecated.</info>
+ <info>DEPRECATED: This function was internal and is deprecated.</info>
<return type='int' info='-1 as this is an error to use it.'/>
<arg name='in' type='xmlParserInputPtr' info='an XML parser input'/>
<arg name='len' type='int' info='an indicative size for the lookahead'/>
@@ -12567,7 +12567,7 @@ Could we use @subtypes for this?'/>
<arg name='namespaces' type='const xmlChar **' info='the prefix definitions, array of [URI, prefix] or
NULL'/>
</function>
<function name='xmlPedanticParserDefault' file='parser' module='parserInternals'>
- <info>Set and return the previous value for enabling pedantic warnings.</info>
+ <info>DEPRECATED: Use the modern options API with XML_PARSE_PEDANTIC. Set and return the previous
value for enabling pedantic warnings.</info>
<return type='int' info='the last value for 0 for no substitution, 1 for substitution.'/>
<arg name='val' type='int' info='int 0 or 1'/>
</function>
@@ -13394,7 +13394,7 @@ Could we use @subtypes for this?'/>
</function>
<function name='xmlSAXParseDTD' file='parser' module='parser'>
<cond>defined(LIBXML_VALID_ENABLED)</cond>
- <info>Load and parse an external subset.</info>
+ <info>DEPRECATED: Don't use. Load and parse an external subset.</info>
<return type='xmlDtdPtr' info='the resulting xmlDtdPtr or NULL in case of error.'/>
<arg name='sax' type='xmlSAXHandlerPtr' info='the SAX handler block'/>
<arg name='ExternalID' type='const xmlChar *' info='a NAME* containing the External ID of the DTD'/>
@@ -13410,7 +13410,7 @@ Could we use @subtypes for this?'/>
</function>
<function name='xmlSAXParseEntity' file='parser' module='parser'>
<cond>defined(LIBXML_SAX1_ENABLED)</cond>
- <info>parse an XML external entity out of context and build a tree. It use the given SAX function
block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines.
[78] extParsedEnt ::= TextDecl? content This correspond to a "Well Balanced" chunk</info>
+ <info>DEPRECATED: Don't use. parse an XML external entity out of context and build a tree. It
use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM
tree building routines. [78] extParsedEnt ::= TextDecl? content This correspond to a "Well
Balanced" chunk</info>
<return type='xmlDocPtr' info='the resulting document tree'/>
<arg name='sax' type='xmlSAXHandlerPtr' info='the SAX handler block'/>
<arg name='filename' type='const char *' info='the filename'/>
@@ -14652,7 +14652,7 @@ Could we use @subtypes for this?'/>
<arg name='error' type='xmlErrorPtr' info='the error being raised.'/>
</functype>
<function name='xmlSubstituteEntitiesDefault' file='parser' module='parserInternals'>
- <info>Set and return the previous value for default entity support. Initially the parser always keep
entity references instead of substituting entity values in the output. This function has to be used to change
the default parser behavior SAX::substituteEntities() has to be used for changing that on a file by file
basis.</info>
+ <info>DEPRECATED: Use the modern options API with XML_PARSE_NOENT. Set and return the previous value
for default entity support. Initially the parser always keep entity references instead of substituting entity
values in the output. This function has to be used to change the default parser behavior
SAX::substituteEntities() has to be used for changing that on a file by file basis.</info>
<return type='int' info='the last value for 0 for no substitution, 1 for substitution.'/>
<arg name='val' type='int' info='int 0 or 1'/>
</function>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
