summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Veillard <veillard@src.gnome.org>2006-06-06 13:27:03 +0000
committerDaniel Veillard <veillard@src.gnome.org>2006-06-06 13:27:03 +0000
commit69839ba1974ba8a7e996652bb2f7865de33b366f (patch)
tree8a397b96e9dada77ba6d1378dfbddfa317536e26
parent080152c9017a0ee4b97149d54f85fea3ab348b6d (diff)
downloadlibxml2-69839ba1974ba8a7e996652bb2f7865de33b366f.tar.gz
preparing release of 2.6.25 Daniel
* configure.ini NEWS doc//* libxml.spec.in : preparing release of 2.6.25 Daniel
-rw-r--r--ChangeLog4
-rw-r--r--configure.in2
-rw-r--r--doc/APIchunk1.html2
-rw-r--r--doc/APIchunk10.html1
-rw-r--r--doc/APIchunk12.html7
-rw-r--r--doc/APIchunk13.html2
-rw-r--r--doc/APIchunk14.html2
-rw-r--r--doc/APIchunk15.html2
-rw-r--r--doc/APIchunk17.html1
-rw-r--r--doc/APIchunk19.html2
-rw-r--r--doc/APIchunk21.html5
-rw-r--r--doc/APIchunk22.html1
-rw-r--r--doc/APIchunk23.html2
-rw-r--r--doc/APIchunk24.html5
-rw-r--r--doc/APIchunk5.html1
-rw-r--r--doc/APIchunk8.html2
-rw-r--r--doc/APIfiles.html2
-rw-r--r--doc/APIfunctions.html1
-rw-r--r--doc/APIsymbols.html2
-rw-r--r--doc/DOM.html15
-rw-r--r--doc/FAQ.html338
-rw-r--r--doc/XMLinfo.html31
-rw-r--r--doc/XSLT.html8
-rw-r--r--doc/architecture.html7
-rw-r--r--doc/bugs.html116
-rw-r--r--doc/catalog.html325
-rw-r--r--doc/contribs.html57
-rw-r--r--doc/devhelp/libxml2-xmlerror.html1
-rw-r--r--doc/devhelp/libxml2-xpath.html8
-rw-r--r--doc/devhelp/libxml2.devhelp2
-rw-r--r--doc/docs.html38
-rw-r--r--doc/downloads.html44
-rw-r--r--doc/encoding.html313
-rw-r--r--doc/entities.html73
-rw-r--r--doc/example.html70
-rw-r--r--doc/help.html27
-rw-r--r--doc/html/libxml-xmlerror.html1
-rw-r--r--doc/html/libxml-xpath.html8
-rw-r--r--doc/index.html109
-rw-r--r--doc/interface.html35
-rw-r--r--doc/intro.html40
-rw-r--r--doc/library.html138
-rw-r--r--doc/libxml2-api.xml15
-rw-r--r--doc/libxml2-refs.xml73
-rw-r--r--doc/libxml2.xsa69
-rw-r--r--doc/namespaces.html70
-rw-r--r--doc/news.html1681
-rw-r--r--doc/python.html247
-rw-r--r--doc/threads.html24
-rw-r--r--doc/tree.html33
-rw-r--r--doc/upgrade.html188
-rw-r--r--doc/xml.html4978
-rw-r--r--doc/xmldtd.html153
-rw-r--r--doc/xmlio.html125
-rw-r--r--doc/xmlmem.html167
-rw-r--r--libxml.spec.in1
-rw-r--r--python/libxml2class.txt1
-rw-r--r--testapi.c58
58 files changed, 4973 insertions, 4760 deletions
diff --git a/ChangeLog b/ChangeLog
index c9eca016..3a3a8f12 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+Tue Jun 6 15:19:57 CEST 2006 Daniel Veillard <daniel@veillard.com>
+
+ * configure.ini NEWS doc//* libxml.spec.in : preparing release of 2.6.25
+
Tue Jun 6 11:28:15 CEST 2006 Kasimier Buchcik <libxml2-cvs@cazic.net>
* xpath.c: Enabled the compound traversal again; I added a
diff --git a/configure.in b/configure.in
index cb9e0b1d..7fbacfbe 100644
--- a/configure.in
+++ b/configure.in
@@ -5,7 +5,7 @@ AC_CANONICAL_HOST
LIBXML_MAJOR_VERSION=2
LIBXML_MINOR_VERSION=6
-LIBXML_MICRO_VERSION=24
+LIBXML_MICRO_VERSION=25
LIBXML_MICRO_VERSION_SUFFIX=
LIBXML_VERSION=$LIBXML_MAJOR_VERSION.$LIBXML_MINOR_VERSION.$LIBXML_MICRO_VERSION$LIBXML_MICRO_VERSION_SUFFIX
LIBXML_VERSION_INFO=`expr $LIBXML_MAJOR_VERSION + $LIBXML_MINOR_VERSION`:$LIBXML_MICRO_VERSION:$LIBXML_MINOR_VERSION
diff --git a/doc/APIchunk1.html b/doc/APIchunk1.html
index ca14e32b..7c9ff725 100644
--- a/doc/APIchunk1.html
+++ b/doc/APIchunk1.html
@@ -81,6 +81,7 @@ A:link, A:visited, A:active { text-decoration: underline }
</dd><dt>CJKUnifiedIdeographsExtensionB</dt><dd><a href="html/libxml-xmlunicode.html#xmlUCSIsCJKUnifiedIdeographsExtensionB">xmlUCSIsCJKUnifiedIdeographsExtensionB</a><br />
</dd><dt>CVS</dt><dd><a href="html/libxml-xmlversion.html#LIBXML_VERSION_EXTRA">LIBXML_VERSION_EXTRA</a><br />
</dd><dt>CWD</dt><dd><a href="html/libxml-nanoftp.html#xmlNanoFTPCwd">xmlNanoFTPCwd</a><br />
+</dd><dt>Cache</dt><dd><a href="html/libxml-xpath.html#_xmlXPathContext">_xmlXPathContext</a><br />
</dd><dt>Call</dt><dd><a href="html/libxml-parserInternals.html#htmlInitAutoClose">htmlInitAutoClose</a><br />
<a href="html/libxml-parser.html#xmlInitParser">xmlInitParser</a><br />
<a href="html/libxml-xpath.html#xmlXPathOrderDocElems">xmlXPathOrderDocElems</a><br />
@@ -309,6 +310,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xmlregexp.html#xmlExpNewCtxt">xmlExpNewCtxt</a><br />
<a href="html/libxml-tree.html#xmlNewDoc">xmlNewDoc</a><br />
<a href="html/libxml-xinclude.html#xmlXIncludeNewContext">xmlXIncludeNewContext</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>Creation</dt><dd><a href="html/libxml-tree.html#xmlNewCDataBlock">xmlNewCDataBlock</a><br />
<a href="html/libxml-tree.html#xmlNewCharRef">xmlNewCharRef</a><br />
<a href="html/libxml-tree.html#xmlNewChild">xmlNewChild</a><br />
diff --git a/doc/APIchunk10.html b/doc/APIchunk10.html
index c2e8d33c..0486624d 100644
--- a/doc/APIchunk10.html
+++ b/doc/APIchunk10.html
@@ -123,6 +123,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xmlreader.html#xmlTextReaderSchemaValidate">xmlTextReaderSchemaValidate</a><br />
<a href="html/libxml-xmlreader.html#xmlTextReaderSchemaValidateCtxt">xmlTextReaderSchemaValidateCtxt</a><br />
<a href="html/libxml-xmlreader.html#xmlTextReaderSetSchema">xmlTextReaderSetSchema</a><br />
+</dd><dt>activates</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>activation</dt><dd><a href="html/libxml-tree.html#xmlGetLineNo">xmlGetLineNo</a><br />
</dd><dt>acts</dt><dd><a href="html/libxml-tree.html#xmlGetProp">xmlGetProp</a><br />
</dd><dt>actual</dt><dd><a href="html/libxml-xmlstring.html#xmlGetUTF8Char">xmlGetUTF8Char</a><br />
diff --git a/doc/APIchunk12.html b/doc/APIchunk12.html
index 8f93a9f7..1c552b14 100644
--- a/doc/APIchunk12.html
+++ b/doc/APIchunk12.html
@@ -37,7 +37,10 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="APIchunk27.html">w-w</a>
<a href="APIchunk28.html">x-x</a>
<a href="APIchunk29.html">y-z</a>
-</h2><h2>Letter c:</h2><dl><dt>calculated</dt><dd><a href="html/libxml-xmlstring.html#xmlStrncatNew">xmlStrncatNew</a><br />
+</h2><h2>Letter c:</h2><dl><dt>cache</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
+</dd><dt>cached</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
+</dd><dt>caching:</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
+</dd><dt>calculated</dt><dd><a href="html/libxml-xmlstring.html#xmlStrncatNew">xmlStrncatNew</a><br />
</dd><dt>calculates</dt><dd><a href="html/libxml-xmlstring.html#xmlUTF8Size">xmlUTF8Size</a><br />
</dd><dt>calling</dt><dd><a href="html/libxml-xpath.html#_xmlXPathContext">_xmlXPathContext</a><br />
<a href="html/libxml-uri.html#xmlBuildRelativeURI">xmlBuildRelativeURI</a><br />
@@ -839,6 +842,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xmlautomata.html#xmlAutomataNewTransition2">xmlAutomataNewTransition2</a><br />
<a href="html/libxml-uri.html#xmlCreateURI">xmlCreateURI</a><br />
<a href="html/libxml-xmlstring.html#xmlStrncatNew">xmlStrncatNew</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>creating</dt><dd><a href="html/libxml-tree.html#xmlDOMWrapAdoptNode">xmlDOMWrapAdoptNode</a><br />
<a href="html/libxml-tree.html#xmlDOMWrapCloneNode">xmlDOMWrapCloneNode</a><br />
<a href="html/libxml-tree.html#xmlDOMWrapReconcileNamespaces">xmlDOMWrapReconcileNamespaces</a><br />
@@ -869,6 +873,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xmlmemory.html#xmlMemGet">xmlMemGet</a><br />
<a href="html/libxml-xmlmemory.html#xmlMemUsed">xmlMemUsed</a><br />
<a href="html/libxml-xmlIO.html#xmlOutputBufferCreateFilename">xmlOutputBufferCreateFilename</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>custom</dt><dd><a href="html/libxml-tree.html#xmlDOMWrapAdoptNode">xmlDOMWrapAdoptNode</a><br />
<a href="html/libxml-tree.html#xmlDOMWrapCloneNode">xmlDOMWrapCloneNode</a><br />
<a href="html/libxml-xmlsave.html#xmlSaveSetAttrEscape">xmlSaveSetAttrEscape</a><br />
diff --git a/doc/APIchunk13.html b/doc/APIchunk13.html
index 96643e35..5980cc29 100644
--- a/doc/APIchunk13.html
+++ b/doc/APIchunk13.html
@@ -221,6 +221,7 @@ A:link, A:visited, A:active { text-decoration: underline }
</dd><dt>delegation</dt><dd><a href="html/libxml-catalog.html#xmlCatalogSetDefaultPrefer">xmlCatalogSetDefaultPrefer</a><br />
</dd><dt>delete</dt><dd><a href="html/libxml-nanoftp.html#xmlNanoFTPDele">xmlNanoFTPDele</a><br />
</dd><dt>deletion</dt><dd><a href="html/libxml-catalog.html#xmlCatalogSetDefaultPrefer">xmlCatalogSetDefaultPrefer</a><br />
+</dd><dt>dependant</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>depending</dt><dd><a href="html/libxml-valid.html#xmlIsID">xmlIsID</a><br />
<a href="html/libxml-valid.html#xmlIsRef">xmlIsRef</a><br />
<a href="html/libxml-list.html#xmlListDataCompare">xmlListDataCompare</a><br />
@@ -455,6 +456,7 @@ A:link, A:visited, A:active { text-decoration: underline }
</dd><dt>disabled</dt><dd><a href="html/libxml-hash.html#XML_CAST_FPTR">XML_CAST_FPTR</a><br />
<a href="html/libxml-parser.html#_xmlParserCtxt">_xmlParserCtxt</a><br />
<a href="html/libxml-uri.html#xmlParseURIRaw">xmlParseURIRaw</a><br />
+</dd><dt>disables</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>disabling</dt><dd><a href="html/libxml-xmlIO.html#xmlNoNetExternalEntityLoader">xmlNoNetExternalEntityLoader</a><br />
</dd><dt>disallowed</dt><dd><a href="html/libxml-schemasInternals.html#XML_SCHEMAS_ELEM_BLOCK_EXTENSION">XML_SCHEMAS_ELEM_BLOCK_EXTENSION</a><br />
<a href="html/libxml-schemasInternals.html#XML_SCHEMAS_ELEM_BLOCK_RESTRICTION">XML_SCHEMAS_ELEM_BLOCK_RESTRICTION</a><br />
diff --git a/doc/APIchunk14.html b/doc/APIchunk14.html
index eb1716e6..f5134af2 100644
--- a/doc/APIchunk14.html
+++ b/doc/APIchunk14.html
@@ -50,6 +50,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xpathInternals.html#xmlXPathIdFunction">xmlXPathIdFunction</a><br />
<a href="html/libxml-xpathInternals.html#xmlXPathSubstringFunction">xmlXPathSubstringFunction</a><br />
</dd><dt>edition</dt><dd><a href="html/libxml-parserInternals.html#xmlCheckLanguageID">xmlCheckLanguageID</a><br />
+</dd><dt>effect</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>effective</dt><dd><a href="html/libxml-catalog.html#xmlLoadCatalog">xmlLoadCatalog</a><br />
<a href="html/libxml-catalog.html#xmlLoadCatalogs">xmlLoadCatalogs</a><br />
</dd><dt>efficiency</dt><dd><a href="html/libxml-uri.html#xmlBuildRelativeURI">xmlBuildRelativeURI</a><br />
@@ -118,6 +119,7 @@ A:link, A:visited, A:active { text-decoration: underline }
</dd><dt>enable</dt><dd><a href="html/libxml-catalog.html#xmlCatalogSetDebug">xmlCatalogSetDebug</a><br />
</dd><dt>enabled</dt><dd><a href="html/libxml-tree.html#xmlSaveFile">xmlSaveFile</a><br />
<a href="html/libxml-tree.html#xmlSaveFormatFile">xmlSaveFormatFile</a><br />
+</dd><dt>enables</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>enabling</dt><dd><a href="html/libxml-parser.html#xmlLineNumbersDefault">xmlLineNumbersDefault</a><br />
<a href="html/libxml-parser.html#xmlPedanticParserDefault">xmlPedanticParserDefault</a><br />
</dd><dt>enc</dt><dd><a href="html/libxml-xmlIO.html#xmlParserInputBufferCreateFilename">xmlParserInputBufferCreateFilename</a><br />
diff --git a/doc/APIchunk15.html b/doc/APIchunk15.html
index 8b51338d..4ac0a55a 100644
--- a/doc/APIchunk15.html
+++ b/doc/APIchunk15.html
@@ -243,6 +243,7 @@ A:link, A:visited, A:active { text-decoration: underline }
</dd><dt>fonctionnalities</dt><dd><a href="html/libxml-xmlIO.html#xmlInputMatchCallback">xmlInputMatchCallback</a><br />
<a href="html/libxml-xmlIO.html#xmlOutputMatchCallback">xmlOutputMatchCallback</a><br />
</dd><dt>for:</dt><dd><a href="html/libxml-xmlschemastypes.html#xmlSchemaGetCanonValue">xmlSchemaGetCanonValue</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>forbid</dt><dd><a href="html/libxml-xpath.html#XML_XPATH_NOVAR">XML_XPATH_NOVAR</a><br />
</dd><dt>force</dt><dd><a href="html/libxml-parser.html#xmlKeepBlanksDefault">xmlKeepBlanksDefault</a><br />
<a href="html/libxml-xmlerror.html#xmlSetGenericErrorFunc">xmlSetGenericErrorFunc</a><br />
@@ -320,6 +321,7 @@ A:link, A:visited, A:active { text-decoration: underline }
</dd><dt>freeing</dt><dd><a href="html/libxml-uri.html#xmlCanonicPath">xmlCanonicPath</a><br />
<a href="html/libxml-parser.html#xmlParserInputDeallocate">xmlParserInputDeallocate</a><br />
</dd><dt>frees</dt><dd><a href="html/libxml-tree.html#xmlBufferFree">xmlBufferFree</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>front</dt><dd><a href="html/libxml-tree.html#xmlValidateNCName">xmlValidateNCName</a><br />
<a href="html/libxml-tree.html#xmlValidateNMToken">xmlValidateNMToken</a><br />
<a href="html/libxml-tree.html#xmlValidateName">xmlValidateName</a><br />
diff --git a/doc/APIchunk17.html b/doc/APIchunk17.html
index 892cf527..071403e8 100644
--- a/doc/APIchunk17.html
+++ b/doc/APIchunk17.html
@@ -464,6 +464,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-relaxng.html#xmlRelaxNGNewDocParserCtxt">xmlRelaxNGNewDocParserCtxt</a><br />
<a href="html/libxml-valid.html#xmlRemoveID">xmlRemoveID</a><br />
<a href="html/libxml-valid.html#xmlRemoveRef">xmlRemoveRef</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>interned</dt><dd><a href="html/libxml-pattern.html#xmlPatterncompile">xmlPatterncompile</a><br />
<a href="html/libxml-xmlreader.html#xmlTextReaderConstString">xmlTextReaderConstString</a><br />
</dd><dt>interning</dt><dd><a href="html/libxml-tree.html#xmlCopyNodeList">xmlCopyNodeList</a><br />
diff --git a/doc/APIchunk19.html b/doc/APIchunk19.html
index 0cde864b..8541fe1a 100644
--- a/doc/APIchunk19.html
+++ b/doc/APIchunk19.html
@@ -148,6 +148,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xmlregexp.html#xmlExpMaxToken">xmlExpMaxToken</a><br />
<a href="html/libxml-xmlregexp.html#xmlExpNewCtxt">xmlExpNewCtxt</a><br />
<a href="html/libxml-pattern.html#xmlPatternMaxDepth">xmlPatternMaxDepth</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>maybe</dt><dd><a href="html/libxml-schemasInternals.html#_xmlSchemaElement">_xmlSchemaElement</a><br />
</dd><dt>mean</dt><dd><a href="html/libxml-pattern.html#xmlPatternMinDepth">xmlPatternMinDepth</a><br />
</dd><dt>means</dt><dd><a href="html/libxml-xmlregexp.html#xmlExpNewRange">xmlExpNewRange</a><br />
@@ -238,6 +239,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-pattern.html#xmlPatternMinDepth">xmlPatternMinDepth</a><br />
</dd><dt>minus</dt><dd><a href="html/libxml-xpathInternals.html#xmlXPathStringFunction">xmlXPathStringFunction</a><br />
</dd><dt>minute</dt><dd><a href="html/libxml-nanoftp.html#ftpListCallback">ftpListCallback</a><br />
+</dd><dt>misc</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>misleading</dt><dd><a href="html/libxml-parserInternals.html#xmlParsePEReference">xmlParsePEReference</a><br />
<a href="html/libxml-parserInternals.html#xmlParserHandlePEReference">xmlParserHandlePEReference</a><br />
</dd><dt>mixed</dt><dd><a href="html/libxml-schemasInternals.html#XML_SCHEMAS_TYPE_MIXED">XML_SCHEMAS_TYPE_MIXED</a><br />
diff --git a/doc/APIchunk21.html b/doc/APIchunk21.html
index 8817d3c7..f503ffe8 100644
--- a/doc/APIchunk21.html
+++ b/doc/APIchunk21.html
@@ -39,7 +39,9 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="APIchunk29.html">y-z</a>
</h2><h2>Letter o:</h2><dl><dt>object?</dt><dd><a href="html/libxml-xpathInternals.html#xmlXPathNumberFunction">xmlXPathNumberFunction</a><br />
<a href="html/libxml-xpathInternals.html#xmlXPathStringFunction">xmlXPathStringFunction</a><br />
-</dd><dt>objects</dt><dd><a href="html/libxml-xpathInternals.html#xmlXPathCompareValues">xmlXPathCompareValues</a><br />
+</dd><dt>objects</dt><dd><a href="html/libxml-xpath.html#_xmlXPathContext">_xmlXPathContext</a><br />
+<a href="html/libxml-xpathInternals.html#xmlXPathCompareValues">xmlXPathCompareValues</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
<a href="html/libxml-xpathInternals.html#xmlXPathDivValues">xmlXPathDivValues</a><br />
<a href="html/libxml-xpathInternals.html#xmlXPathEqualValues">xmlXPathEqualValues</a><br />
<a href="html/libxml-xpath.html#xmlXPathFreeNodeSetList">xmlXPathFreeNodeSetList</a><br />
@@ -236,6 +238,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xmlsave.html#xmlSaveToFilename">xmlSaveToFilename</a><br />
<a href="html/libxml-xmlsave.html#xmlSaveToIO">xmlSaveToIO</a><br />
<a href="html/libxml-xmlreader.html#xmlTextReaderSchemaValidateCtxt">xmlTextReaderSchemaValidateCtxt</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>ordered</dt><dd><a href="html/libxml-list.html#xmlListAppend">xmlListAppend</a><br />
<a href="html/libxml-list.html#xmlListInsert">xmlListInsert</a><br />
<a href="html/libxml-xpathInternals.html#xmlXPathNextAncestor">xmlXPathNextAncestor</a><br />
diff --git a/doc/APIchunk22.html b/doc/APIchunk22.html
index dec83506..f4c83216 100644
--- a/doc/APIchunk22.html
+++ b/doc/APIchunk22.html
@@ -146,6 +146,7 @@ A:link, A:visited, A:active { text-decoration: underline }
</dd><dt>per</dt><dd><a href="html/libxml-xmlerror.html#xmlGetLastError">xmlGetLastError</a><br />
<a href="html/libxml-parserInternals.html#xmlParseAttributeType">xmlParseAttributeType</a><br />
<a href="html/libxml-valid.html#xmlValidateElementDecl">xmlValidateElementDecl</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>performance</dt><dd><a href="html/libxml-tree.html#xmlGetBufferAllocationScheme">xmlGetBufferAllocationScheme</a><br />
<a href="html/libxml-tree.html#xmlSetBufferAllocationScheme">xmlSetBufferAllocationScheme</a><br />
</dd><dt>performed</dt><dd><a href="html/libxml-HTMLparser.html#htmlNodeStatus">htmlNodeStatus</a><br />
diff --git a/doc/APIchunk23.html b/doc/APIchunk23.html
index ebbea9a0..4a782246 100644
--- a/doc/APIchunk23.html
+++ b/doc/APIchunk23.html
@@ -541,9 +541,11 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-hash.html#xmlHashUpdateEntry3">xmlHashUpdateEntry3</a><br />
</dd><dt>retry</dt><dd><a href="html/libxml-valid.html#xmlValidGetValidElements">xmlValidGetValidElements</a><br />
</dd><dt>returning</dt><dd><a href="html/libxml-xpathInternals.html#xmlXPathStringFunction">xmlXPathStringFunction</a><br />
+</dd><dt>reusal</dt><dd><a href="html/libxml-xpath.html#_xmlXPathContext">_xmlXPathContext</a><br />
</dd><dt>reuse</dt><dd><a href="html/libxml-tree.html#xmlReconciliateNs">xmlReconciliateNs</a><br />
<a href="html/libxml-xmlregexp.html#xmlRegExecPushString">xmlRegExecPushString</a><br />
<a href="html/libxml-xmlregexp.html#xmlRegExecPushString2">xmlRegExecPushString2</a><br />
+</dd><dt>reused</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>reuses</dt><dd><a href="html/libxml-HTMLparser.html#htmlCtxtReadDoc">htmlCtxtReadDoc</a><br />
<a href="html/libxml-HTMLparser.html#htmlCtxtReadFd">htmlCtxtReadFd</a><br />
<a href="html/libxml-HTMLparser.html#htmlCtxtReadFile">htmlCtxtReadFile</a><br />
diff --git a/doc/APIchunk24.html b/doc/APIchunk24.html
index fa596f61..6ac493b1 100644
--- a/doc/APIchunk24.html
+++ b/doc/APIchunk24.html
@@ -180,6 +180,7 @@ A:link, A:visited, A:active { text-decoration: underline }
</dd><dt>self</dt><dd><a href="html/libxml-xpathInternals.html#xmlXPathNextSelf">xmlXPathNextSelf</a><br />
</dd><dt>semantic</dt><dd><a href="html/libxml-xmlautomata.html#xmlAutomataNewNegTrans">xmlAutomataNewNegTrans</a><br />
<a href="html/libxml-xpathInternals.html#xmlXPathNodeSetFreeNs">xmlXPathNodeSetFreeNs</a><br />
+</dd><dt>semantics</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>sense</dt><dd><a href="html/libxml-entities.html#xmlCreateEntitiesTable">xmlCreateEntitiesTable</a><br />
</dd><dt>separated</dt><dd><a href="html/libxml-catalog.html#xmlLoadCatalogs">xmlLoadCatalogs</a><br />
</dd><dt>separately</dt><dd><a href="html/libxml-xmlerror.html#xmlSetGenericErrorFunc">xmlSetGenericErrorFunc</a><br />
@@ -261,6 +262,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xpathInternals.html#xmlXPathDifference">xmlXPathDifference</a><br />
<a href="html/libxml-xpathInternals.html#xmlXPathIntersection">xmlXPathIntersection</a><br />
</dd><dt>setting</dt><dd><a href="html/libxml-xmlerror.html#xmlSetGenericErrorFunc">xmlSetGenericErrorFunc</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>setups</dt><dd><a href="html/libxml-parserInternals.html#xmlParseEncodingDecl">xmlParseEncodingDecl</a><br />
</dd><dt>sgmlsource</dt><dd><a href="html/libxml-SAX.html#getSystemId">getSystemId</a><br />
<a href="html/libxml-SAX2.html#xmlSAX2GetSystemId">xmlSAX2GetSystemId</a><br />
@@ -388,6 +390,8 @@ A:link, A:visited, A:active { text-decoration: underline }
</dd><dt>skipped</dt><dd><a href="html/libxml-parserInternals.html#xmlParseElementChildrenContentDecl">xmlParseElementChildrenContentDecl</a><br />
<a href="html/libxml-parserInternals.html#xmlParseElementMixedContentDecl">xmlParseElementMixedContentDecl</a><br />
<a href="html/libxml-parserInternals.html#xmlSkipBlankChars">xmlSkipBlankChars</a><br />
+</dd><dt>slot</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
+</dd><dt>slots</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>smallest</dt><dd><a href="html/libxml-xpathInternals.html#xmlXPathCeilingFunction">xmlXPathCeilingFunction</a><br />
</dd><dt>socket</dt><dd><a href="html/libxml-xmlIO.html#xmlCheckFilename">xmlCheckFilename</a><br />
<a href="html/libxml-nanoftp.html#xmlNanoFTPGetSocket">xmlNanoFTPGetSocket</a><br />
@@ -797,6 +801,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-hash.html#xmlHashUpdateEntry3">xmlHashUpdateEntry3</a><br />
<a href="html/libxml-xmlschemastypes.html#xmlSchemaValueAppend">xmlSchemaValueAppend</a><br />
<a href="html/libxml-xpathInternals.html#xmlXPathCompareValues">xmlXPathCompareValues</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>succeeds</dt><dd><a href="html/libxml-xmlIO.html#xmlCheckFilename">xmlCheckFilename</a><br />
<a href="html/libxml-xmlwriter.html#xmlNewTextWriterPushParser">xmlNewTextWriterPushParser</a><br />
</dd><dt>successful</dt><dd><a href="html/libxml-catalog.html#xmlACatalogAdd">xmlACatalogAdd</a><br />
diff --git a/doc/APIchunk5.html b/doc/APIchunk5.html
index dbc12b16..3ebc5a88 100644
--- a/doc/APIchunk5.html
+++ b/doc/APIchunk5.html
@@ -71,6 +71,7 @@ A:link, A:visited, A:active { text-decoration: underline }
</dd><dt>Optional</dt><dd><a href="html/libxml-HTMLparser.html#_htmlElemDesc">_htmlElemDesc</a><br />
</dd><dt>Oriya</dt><dd><a href="html/libxml-xmlunicode.html#xmlUCSIsOriya">xmlUCSIsOriya</a><br />
</dd><dt>Osmanya</dt><dd><a href="html/libxml-xmlunicode.html#xmlUCSIsOsmanya">xmlUCSIsOsmanya</a><br />
+</dd><dt>Other</dt><dd><a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>Otherwise</dt><dd><a href="html/libxml-pattern.html#xmlStreamPush">xmlStreamPush</a><br />
<a href="html/libxml-pattern.html#xmlStreamPushAttr">xmlStreamPushAttr</a><br />
</dd><dt>Output</dt><dd><a href="html/libxml-xmlIO.html#xmlOutputCloseCallback">xmlOutputCloseCallback</a><br />
diff --git a/doc/APIchunk8.html b/doc/APIchunk8.html
index 87c07a43..82de64be 100644
--- a/doc/APIchunk8.html
+++ b/doc/APIchunk8.html
@@ -114,6 +114,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-parserInternals.html#xmlParseMarkupDecl">xmlParseMarkupDecl</a><br />
</dd><dt>Then</dt><dd><a href="html/libxml-valid.html#xmlValidateOneElement">xmlValidateOneElement</a><br />
</dd><dt>There</dt><dd><a href="html/libxml-xmlregexp.html#xmlExpParse">xmlExpParse</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>Those</dt><dd><a href="html/libxml-parser.html#_xmlParserCtxt">_xmlParserCtxt</a><br />
</dd><dt>Thus:</dt><dd><a href="html/libxml-xpathInternals.html#xmlXPathSubstringFunction">xmlXPathSubstringFunction</a><br />
</dd><dt>Tibetan</dt><dd><a href="html/libxml-xmlunicode.html#xmlUCSIsTibetan">xmlUCSIsTibetan</a><br />
@@ -249,6 +250,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xmlreader.html#xmlTextReaderSchemaValidate">xmlTextReaderSchemaValidate</a><br />
<a href="html/libxml-xmlreader.html#xmlTextReaderSchemaValidateCtxt">xmlTextReaderSchemaValidateCtxt</a><br />
<a href="html/libxml-xmlreader.html#xmlTextReaderSetSchema">xmlTextReaderSetSchema</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
</dd><dt>Used</dt><dd><a href="html/libxml-schemasInternals.html#XML_SCHEMAS_ANY_LAX">XML_SCHEMAS_ANY_LAX</a><br />
<a href="html/libxml-schemasInternals.html#XML_SCHEMAS_ANY_STRICT">XML_SCHEMAS_ANY_STRICT</a><br />
<a href="html/libxml-schemasInternals.html#XML_SCHEMAS_ATTR_USE_PROHIBITED">XML_SCHEMAS_ATTR_USE_PROHIBITED</a><br />
diff --git a/doc/APIfiles.html b/doc/APIfiles.html
index 2de70cc0..2a5af4b6 100644
--- a/doc/APIfiles.html
+++ b/doc/APIfiles.html
@@ -2457,6 +2457,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_INVALIDATTR">XML_SCHEMAV_INVALIDATTR</a><br />
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_INVALIDELEM">XML_SCHEMAV_INVALIDELEM</a><br />
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_ISABSTRACT">XML_SCHEMAV_ISABSTRACT</a><br />
+<a href="html/libxml-xmlerror.html#XML_SCHEMAV_MISC">XML_SCHEMAV_MISC</a><br />
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_MISSING">XML_SCHEMAV_MISSING</a><br />
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_NOROLLBACK">XML_SCHEMAV_NOROLLBACK</a><br />
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_NOROOT">XML_SCHEMAV_NOROOT</a><br />
@@ -3274,6 +3275,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xpath.html#xmlXPathCompiledEval">xmlXPathCompiledEval</a><br />
<a href="html/libxml-xpath.html#xmlXPathContext">xmlXPathContext</a><br />
<a href="html/libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
<a href="html/libxml-xpath.html#xmlXPathConvertBoolean">xmlXPathConvertBoolean</a><br />
<a href="html/libxml-xpath.html#xmlXPathConvertFunc">xmlXPathConvertFunc</a><br />
<a href="html/libxml-xpath.html#xmlXPathConvertNumber">xmlXPathConvertNumber</a><br />
diff --git a/doc/APIfunctions.html b/doc/APIfunctions.html
index 042bc3a2..92489fb0 100644
--- a/doc/APIfunctions.html
+++ b/doc/APIfunctions.html
@@ -2164,6 +2164,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xpathInternals.html#xmlXPathDebugDumpCompExpr">xmlXPathDebugDumpCompExpr</a><br />
<a href="html/libxml-xpath.html#xmlXPathFreeCompExpr">xmlXPathFreeCompExpr</a><br />
</p><h2>Type xmlXPathContextPtr:</h2><p><a href="html/libxml-xpath.html#xmlXPathCompiledEval">xmlXPathCompiledEval</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
<a href="html/libxml-xpath.html#xmlXPathCtxtCompile">xmlXPathCtxtCompile</a><br />
<a href="html/libxml-xpath.html#xmlXPathEval">xmlXPathEval</a><br />
<a href="html/libxml-xpath.html#xmlXPathEvalExpression">xmlXPathEvalExpression</a><br />
diff --git a/doc/APIsymbols.html b/doc/APIsymbols.html
index cc7019a7..7e1ba3c4 100644
--- a/doc/APIsymbols.html
+++ b/doc/APIsymbols.html
@@ -1199,6 +1199,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_INVALIDATTR">XML_SCHEMAV_INVALIDATTR</a><br />
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_INVALIDELEM">XML_SCHEMAV_INVALIDELEM</a><br />
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_ISABSTRACT">XML_SCHEMAV_ISABSTRACT</a><br />
+<a href="html/libxml-xmlerror.html#XML_SCHEMAV_MISC">XML_SCHEMAV_MISC</a><br />
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_MISSING">XML_SCHEMAV_MISSING</a><br />
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_NOROLLBACK">XML_SCHEMAV_NOROLLBACK</a><br />
<a href="html/libxml-xmlerror.html#XML_SCHEMAV_NOROOT">XML_SCHEMAV_NOROOT</a><br />
@@ -3292,6 +3293,7 @@ A:link, A:visited, A:active { text-decoration: underline }
<a href="html/libxml-xpathInternals.html#xmlXPathContainsFunction">xmlXPathContainsFunction</a><br />
<a href="html/libxml-xpath.html#xmlXPathContext">xmlXPathContext</a><br />
<a href="html/libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a><br />
+<a href="html/libxml-xpath.html#xmlXPathContextSetCache">xmlXPathContextSetCache</a><br />
<a href="html/libxml-xpath.html#xmlXPathConvertBoolean">xmlXPathConvertBoolean</a><br />
<a href="html/libxml-xpath.html#xmlXPathConvertFunc">xmlXPathConvertFunc</a><br />
<a href="html/libxml-xpath.html#xmlXPathConvertNumber">xmlXPathConvertNumber</a><br />
diff --git a/doc/DOM.html b/doc/DOM.html
index 52f11392..0a477704 100644
--- a/doc/DOM.html
+++ b/doc/DOM.html
@@ -7,11 +7,10 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>DOM Principles</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>DOM Principles</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p><a href="http://www.w3.org/DOM/">DOM</a> stands for the <em>Document
-Object Model</em>; this is an API for accessing XML or HTML structured
-documents. Native support for DOM in Gnome is on the way (module gnome-dom),
-and will be based on gnome-xml. This will be a far cleaner interface to
-manipulate XML files within Gnome since it won't expose the internal
-structure.</p><p>The current DOM implementation on top of libxml2 is the <a href="http://cvs.gnome.org/lxr/source/gdome2/">gdome2 Gnome module</a>, this
-is a full DOM interface, thanks to Paolo Casarini, check the <a href="http://www.cs.unibo.it/~casarini/gdome2/">Gdome2 homepage</a> for more
-informations.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+</style><title>DOM Principles</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>DOM Principles</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p><a href="http://www.w3.org/DOM/">DOM</a>stands for the <em>DocumentObject
+Model</em>; this is an API for accessing XML or HTML structureddocuments.
+Native support for DOM in Gnome is on the way (module gnome-dom),and will be
+based on gnome-xml. This will be a far cleaner interface tomanipulate XML
+files within Gnome since it won't expose the internalstructure.</p><p>The current DOM implementation on top of libxml2 is the <a href="http://cvs.gnome.org/lxr/source/gdome2/">gdome2 Gnome module</a>,
+thisis a full DOM interface, thanks to Paolo Casarini, check the <a href="http://www.cs.unibo.it/~casarini/gdome2/">Gdome2 homepage</a>for
+moreinformations.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/FAQ.html b/doc/FAQ.html
index 0d5ded6d..d917d693 100644
--- a/doc/FAQ.html
+++ b/doc/FAQ.html
@@ -12,53 +12,51 @@ A:link, A:visited, A:active { text-decoration: underline }
<li><a href="FAQ.html#Compilatio">Compilation</a></li>
<li><a href="FAQ.html#Developer">Developer corner</a></li>
</ul><h3><a name="License" id="License">License</a>(s)</h3><ol><li><em>Licensing Terms for libxml</em>
- <p>libxml2 is released under the <a href="http://www.opensource.org/licenses/mit-license.html">MIT
- License</a>; see the file Copyright in the distribution for the precise
- wording</p>
+ <p>libxml2 is released under the <a href="http://www.opensource.org/licenses/mit-license.html">MITLicense</a>;
+ see the file Copyright in the distribution for the precisewording</p>
</li>
<li><em>Can I embed libxml2 in a proprietary application ?</em>
- <p>Yes. The MIT License allows you to keep proprietary the changes you
- made to libxml, but it would be graceful to send-back bug fixes and
- improvements as patches for possible incorporation in the main
- development tree.</p>
+ <p>Yes. The MIT License allows you to keep proprietary the changes
+ youmade to libxml, but it would be graceful to send-back bug fixes
+ andimprovements as patches for possible incorporation in the
+ maindevelopment tree.</p>
</li>
-</ol><h3><a name="Installati" id="Installati">Installation</a></h3><ol><li><strong><span style="background-color: #FF0000">Do Not Use
- libxml1</span></strong>, use libxml2</li>
- <li><em>Where can I get libxml</em> ?
- <p>The original distribution comes from <a href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a> or <a href="ftp://ftp.gnome.org/pub/GNOME/sources/libxml2/2.6/">gnome.org</a></p>
- <p>Most Linux and BSD distributions include libxml, this is probably the
- safer way for end-users to use libxml.</p>
+</ol><h3><a name="Installati" id="Installati">Installation</a></h3><ol><li><strong><span style="background-color: #FF0000">Do Not
+ Uselibxml1</span></strong>, use libxml2</li>
+ <li><em>Where can I get libxml</em>?
+ <p>The original distribution comes from <a href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a>or <a href="ftp://ftp.gnome.org/pub/GNOME/sources/libxml2/2.6/">gnome.org</a></p>
+ <p>Most Linux and BSD distributions include libxml, this is probably
+ thesafer way for end-users to use libxml.</p>
<p>David Doolin provides precompiled Windows versions at <a href="http://www.ce.berkeley.edu/~doolin/code/libxmlwin32/ ">http://www.ce.berkeley.edu/~doolin/code/libxmlwin32/</a></p>
</li>
<li><em>I see libxml and libxml2 releases, which one should I install ?</em>
- <ul><li>If you are not constrained by backward compatibility issues with
- existing applications, install libxml2 only</li>
- <li>If you are not doing development, you can safely install both.
- Usually the packages <a href="http://rpmfind.net/linux/RPM/libxml.html">libxml</a> and <a href="http://rpmfind.net/linux/RPM/libxml2.html">libxml2</a> are
- compatible (this is not the case for development packages).</li>
- <li>If you are a developer and your system provides separate packaging
- for shared libraries and the development components, it is possible
- to install libxml and libxml2, and also <a href="http://rpmfind.net/linux/RPM/libxml-devel.html">libxml-devel</a>
- and <a href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml2-devel</a>
- too for libxml2 &gt;= 2.3.0</li>
- <li>If you are developing a new application, please develop against
- libxml2(-devel)</li>
+ <ul><li>If you are not constrained by backward compatibility issues
+ withexisting applications, install libxml2 only</li>
+ <li>If you are not doing development, you can safely install
+ both.Usually the packages <a href="http://rpmfind.net/linux/RPM/libxml.html">libxml</a>and <a href="http://rpmfind.net/linux/RPM/libxml2.html">libxml2</a>arecompatible
+ (this is not the case for development packages).</li>
+ <li>If you are a developer and your system provides separate
+ packagingfor shared libraries and the development components, it is
+ possibleto install libxml and libxml2, and also <a href="http://rpmfind.net/linux/RPM/libxml-devel.html">libxml-devel</a>and
+ <a href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml2-devel</a>too
+ for libxml2 &gt;= 2.3.0</li>
+ <li>If you are developing a new application, please develop
+ againstlibxml2(-devel)</li>
</ul></li>
<li><em>I can't install the libxml package, it conflicts with libxml0</em>
- <p>You probably have an old libxml0 package used to provide the shared
- library for libxml.so.0, you can probably safely remove it. The libxml
- packages provided on <a href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a> provide
- libxml.so.0</p>
+ <p>You probably have an old libxml0 package used to provide the
+ sharedlibrary for libxml.so.0, you can probably safely remove it. The
+ libxmlpackages provided on <a href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a>providelibxml.so.0</p>
</li>
- <li><em>I can't install the libxml(2) RPM package due to failed
- dependencies</em>
- <p>The most generic solution is to re-fetch the latest src.rpm , and
- rebuild it locally with</p>
+ <li><em>I can't install the libxml(2) RPM package due to
+ faileddependencies</em>
+ <p>The most generic solution is to re-fetch the latest src.rpm ,
+ andrebuild it locally with</p>
<p><code>rpm --rebuild libxml(2)-xxx.src.rpm</code>.</p>
- <p>If everything goes well it will generate two binary rpm packages (one
- providing the shared libs and xmllint, and the other one, the -devel
- package, providing includes, static libraries and scripts needed to build
- applications with libxml(2)) that you can install locally.</p>
+ <p>If everything goes well it will generate two binary rpm packages
+ (oneproviding the shared libs and xmllint, and the other one, the
+ -develpackage, providing includes, static libraries and scripts needed to
+ buildapplications with libxml(2)) that you can install locally.</p>
</li>
</ol><h3><a name="Compilatio" id="Compilatio">Compilation</a></h3><ol><li><em>What is the process to compile libxml2 ?</em>
<p>As most UNIX libraries libxml2 follows the "standard":</p>
@@ -69,109 +67,107 @@ A:link, A:visited, A:active { text-decoration: underline }
<p><code>./configure [possible options]</code></p>
<p><code>make</code></p>
<p><code>make install</code></p>
- <p>At that point you may have to rerun ldconfig or a similar utility to
- update your list of installed shared libs.</p>
+ <p>At that point you may have to rerun ldconfig or a similar utility
+ toupdate your list of installed shared libs.</p>
</li>
<li><em>What other libraries are needed to compile/install libxml2 ?</em>
- <p>Libxml2 does not require any other library, the normal C ANSI API
- should be sufficient (please report any violation to this rule you may
- find).</p>
- <p>However if found at configuration time libxml2 will detect and use the
- following libs:</p>
- <ul><li><a href="http://www.info-zip.org/pub/infozip/zlib/">libz</a> : a
- highly portable and available widely compression library.</li>
- <li>iconv: a powerful character encoding conversion library. It is
- included by default in recent glibc libraries, so it doesn't need to
- be installed specifically on Linux. It now seems a <a href="http://www.opennc.org/onlinepubs/7908799/xsh/iconv.html">part
- of the official UNIX</a> specification. Here is one <a href="http://www.gnu.org/software/libiconv/">implementation of the
- library</a> which source can be found <a href="ftp://ftp.ilog.fr/pub/Users/haible/gnu/">here</a>.</li>
+ <p>Libxml2 does not require any other library, the normal C ANSI
+ APIshould be sufficient (please report any violation to this rule you
+ mayfind).</p>
+ <p>However if found at configuration time libxml2 will detect and use
+ thefollowing libs:</p>
+ <ul><li><a href="http://www.info-zip.org/pub/infozip/zlib/">libz</a>:
+ ahighly portable and available widely compression library.</li>
+ <li>iconv: a powerful character encoding conversion library. It
+ isincluded by default in recent glibc libraries, so it doesn't need
+ tobe installed specifically on Linux. It now seems a <a href="http://www.opennc.org/onlinepubs/7908799/xsh/iconv.html">partof
+ the official UNIX</a>specification. Here is one <a href="http://www.gnu.org/software/libiconv/">implementation of
+ thelibrary</a>which source can be found <a href="ftp://ftp.ilog.fr/pub/Users/haible/gnu/">here</a>.</li>
</ul></li>
<li><em>Make check fails on some platforms</em>
- <p>Sometimes the regression tests' results don't completely match the
- value produced by the parser, and the makefile uses diff to print the
- delta. On some platforms the diff return breaks the compilation process;
- if the diff is small this is probably not a serious problem.</p>
- <p>Sometimes (especially on Solaris) make checks fail due to limitations
- in make. Try using GNU-make instead.</p>
+ <p>Sometimes the regression tests' results don't completely match
+ thevalue produced by the parser, and the makefile uses diff to print
+ thedelta. On some platforms the diff return breaks the compilation
+ process;if the diff is small this is probably not a serious problem.</p>
+ <p>Sometimes (especially on Solaris) make checks fail due to
+ limitationsin make. Try using GNU-make instead.</p>
</li>
<li><em>I use the CVS version and there is no configure script</em>
- <p>The configure script (and other Makefiles) are generated. Use the
- autogen.sh script to regenerate the configure script and Makefiles,
- like:</p>
+ <p>The configure script (and other Makefiles) are generated. Use
+ theautogen.sh script to regenerate the configure script and
+ Makefiles,like:</p>
<p><code>./autogen.sh --prefix=/usr --disable-shared</code></p>
</li>
<li><em>I have troubles when running make tests with gcc-3.0</em>
- <p>It seems the initial release of gcc-3.0 has a problem with the
- optimizer which miscompiles the URI module. Please use another
- compiler.</p>
+ <p>It seems the initial release of gcc-3.0 has a problem with
+ theoptimizer which miscompiles the URI module. Please use
+ anothercompiler.</p>
</li>
-</ol><h3><a name="Developer" id="Developer">Developer</a> corner</h3><ol><li><em>Troubles compiling or linking programs using libxml2</em>
- <p>Usually the problem comes from the fact that the compiler doesn't get
- the right compilation or linking flags. There is a small shell script
- <code>xml2-config</code> which is installed as part of libxml2 usual
- install process which provides those flags. Use</p>
+</ol><h3><a name="Developer" id="Developer">Developer</a>corner</h3><ol><li><em>Troubles compiling or linking programs using libxml2</em>
+ <p>Usually the problem comes from the fact that the compiler doesn't
+ getthe right compilation or linking flags. There is a small shell
+ script<code>xml2-config</code>which is installed as part of libxml2
+ usualinstall process which provides those flags. Use</p>
<p><code>xml2-config --cflags</code></p>
<p>to get the compilation flags and</p>
<p><code>xml2-config --libs</code></p>
- <p>to get the linker flags. Usually this is done directly from the
- Makefile as:</p>
+ <p>to get the linker flags. Usually this is done directly from
+ theMakefile as:</p>
<p><code>CFLAGS=`xml2-config --cflags`</code></p>
<p><code>LIBS=`xml2-config --libs`</code></p>
</li>
- <li><em>I want to install my own copy of libxml2 in my home directory and
- link my programs against it, but it doesn't work</em>
- <p>There are many different ways to accomplish this. Here is one way to
- do this under Linux. Suppose your home directory is <code>/home/user.
- </code>Then:</p>
+ <li><em>I want to install my own copy of libxml2 in my home directory
+ andlink my programs against it, but it doesn't work</em>
+ <p>There are many different ways to accomplish this. Here is one way
+ todo this under Linux. Suppose your home directory is
+ <code>/home/user.</code>Then:</p>
<ul><li>Create a subdirectory, let's call it <code>myxml</code></li>
<li>unpack the libxml2 distribution into that subdirectory</li>
- <li>chdir into the unpacked distribution
- (<code>/home/user/myxml/libxml2 </code>)</li>
- <li>configure the library using the "<code>--prefix</code>" switch,
- specifying an installation subdirectory in
- <code>/home/user/myxml</code>, e.g.
- <p><code>./configure --prefix /home/user/myxml/xmlinst</code> {other
- configuration options}</p>
+ <li>chdir into the unpacked distribution(<code>/home/user/myxml/libxml2
+ </code>)</li>
+ <li>configure the library using the "<code>--prefix</code>"
+ switch,specifying an installation subdirectory
+ in<code>/home/user/myxml</code>, e.g.
+ <p><code>./configure --prefix
+ /home/user/myxml/xmlinst</code>{otherconfiguration options}</p>
</li>
- <li>now run <code>make</code> followed by <code>make install</code></li>
- <li>At this point, the installation subdirectory contains the complete
- "private" include files, library files and binary program files (e.g.
- xmllint), located in
- <p><code>/home/user/myxml/xmlinst/lib,
- /home/user/myxml/xmlinst/include </code> and <code>
- /home/user/myxml/xmlinst/bin</code></p>
+ <li>now run <code>make</code>followed by <code>make install</code></li>
+ <li>At this point, the installation subdirectory contains the
+ complete"private" include files, library files and binary program
+ files (e.g.xmllint), located in
+ <p><code>/home/user/myxml/xmlinst/lib,/home/user/myxml/xmlinst/include
+ </code>and <code>/home/user/myxml/xmlinst/bin</code></p>
respectively.</li>
- <li>In order to use this "private" library, you should first add it to
- the beginning of your default PATH (so that your own private program
- files such as xmllint will be used instead of the normal system
- ones). To do this, the Bash command would be
+ <li>In order to use this "private" library, you should first add it
+ tothe beginning of your default PATH (so that your own private
+ programfiles such as xmllint will be used instead of the normal
+ systemones). To do this, the Bash command would be
<p><code>export PATH=/home/user/myxml/xmlinst/bin:$PATH</code></p>
</li>
- <li>Now suppose you have a program <code>test1.c</code> that you would
- like to compile with your "private" library. Simply compile it using
- the command
+ <li>Now suppose you have a program <code>test1.c</code>that you
+ wouldlike to compile with your "private" library. Simply compile it
+ usingthe command
<p><code>gcc `xml2-config --cflags --libs` -o test test.c</code></p>
- Note that, because your PATH has been set with <code>
- /home/user/myxml/xmlinst/bin</code> at the beginning, the xml2-config
- program which you just installed will be used instead of the system
- default one, and this will <em>automatically</em> get the correct
- libraries linked with your program.</li>
+ Note that, because your PATH has been set with
+ <code>/home/user/myxml/xmlinst/bin</code>at the beginning, the
+ xml2-configprogram which you just installed will be used instead of
+ the systemdefault one, and this will <em>automatically</em>get the
+ correctlibraries linked with your program.</li>
</ul></li>
<p></p>
<li><em>xmlDocDump() generates output on one line.</em>
- <p>Libxml2 will not <strong>invent</strong> spaces in the content of a
- document since <strong>all spaces in the content of a document are
- significant</strong>. If you build a tree from the API and want
- indentation:</p>
+ <p>Libxml2 will not <strong>invent</strong>spaces in the content of
+ adocument since <strong>all spaces in the content of a document
+ aresignificant</strong>. If you build a tree from the API and
+ wantindentation:</p>
<ol><li>the correct way is to generate those yourself too.</li>
- <li>the dangerous way is to ask libxml2 to add those blanks to your
- content <strong>modifying the content of your document in the
- process</strong>. The result may not be what you expect. There is
- <strong>NO</strong> way to guarantee that such a modification won't
- affect other parts of the content of your document. See <a href="http://xmlsoft.org/html/libxml-parser.html#xmlKeepBlanksDefault">xmlKeepBlanksDefault
- ()</a> and <a href="http://xmlsoft.org/html/libxml-tree.html#xmlSaveFormatFile">xmlSaveFormatFile
- ()</a></li>
+ <li>the dangerous way is to ask libxml2 to add those blanks to
+ yourcontent <strong>modifying the content of your document in
+ theprocess</strong>. The result may not be what you expect. There
+ is<strong>NO</strong>way to guarantee that such a modification
+ won'taffect other parts of the content of your document. See <a href="http://xmlsoft.org/html/libxml-parser.html#xmlKeepBlanksDefault">xmlKeepBlanksDefault()</a>and
+ <a href="http://xmlsoft.org/html/libxml-tree.html#xmlSaveFormatFile">xmlSaveFormatFile()</a></li>
</ol></li>
<li>Extra nodes in the document:
<p><em>For a XML file as below:</em></p>
@@ -180,10 +176,10 @@ A:link, A:visited, A:active { text-decoration: underline }
&lt;NODE CommFlag="0"/&gt;
&lt;NODE CommFlag="1"/&gt;
&lt;/PLAN&gt;</pre>
- <p><em>after parsing it with the function
- pxmlDoc=xmlParseFile(...);</em></p>
- <p><em>I want to the get the content of the first node (node with the
- CommFlag="0")</em></p>
+ <p><em>after parsing it with the
+ functionpxmlDoc=xmlParseFile(...);</em></p>
+ <p><em>I want to the get the content of the first node (node with
+ theCommFlag="0")</em></p>
<p><em>so I did it as following;</em></p>
<pre>xmlNodePtr pnode;
pnode=pxmlDoc-&gt;children-&gt;children;</pre>
@@ -191,63 +187,64 @@ pnode=pxmlDoc-&gt;children-&gt;children;</pre>
<pre>pnode=pxmlDoc-&gt;children-&gt;children-&gt;next;</pre>
<p><em>then it works. Can someone explain it to me.</em></p>
<p></p>
- <p>In XML all characters in the content of the document are significant
- <strong>including blanks and formatting line breaks</strong>.</p>
- <p>The extra nodes you are wondering about are just that, text nodes with
- the formatting spaces which are part of the document but that people tend
- to forget. There is a function <a href="http://xmlsoft.org/html/libxml-parser.html">xmlKeepBlanksDefault
- ()</a> to remove those at parse time, but that's an heuristic, and its
- use should be limited to cases where you are certain there is no
- mixed-content in the document.</p>
+ <p>In XML all characters in the content of the document are
+ significant<strong>including blanks and formatting line
+ breaks</strong>.</p>
+ <p>The extra nodes you are wondering about are just that, text nodes
+ withthe formatting spaces which are part of the document but that people
+ tendto forget. There is a function <a href="http://xmlsoft.org/html/libxml-parser.html">xmlKeepBlanksDefault()</a>to
+ remove those at parse time, but that's an heuristic, and itsuse should be
+ limited to cases where you are certain there is nomixed-content in the
+ document.</p>
</li>
- <li><em>I get compilation errors of existing code like when accessing
- <strong>root</strong> or <strong>child fields</strong> of nodes.</em>
- <p>You are compiling code developed for libxml version 1 and using a
- libxml2 development environment. Either switch back to libxml v1 devel or
- even better fix the code to compile with libxml2 (or both) by <a href="upgrade.html">following the instructions</a>.</p>
+ <li><em>I get compilation errors of existing code like when
+ accessing<strong>root</strong>or <strong>child fields</strong>of
+ nodes.</em>
+ <p>You are compiling code developed for libxml version 1 and using
+ alibxml2 development environment. Either switch back to libxml v1 devel
+ oreven better fix the code to compile with libxml2 (or both) by <a href="upgrade.html">following the instructions</a>.</p>
</li>
- <li><em>I get compilation errors about non existing
- <strong>xmlRootNode</strong> or <strong>xmlChildrenNode</strong>
- fields.</em>
- <p>The source code you are using has been <a href="upgrade.html">upgraded</a> to be able to compile with both libxml
- and libxml2, but you need to install a more recent version:
- libxml(-devel) &gt;= 1.8.8 or libxml2(-devel) &gt;= 2.1.0</p>
+ <li><em>I get compilation errors about non
+ existing<strong>xmlRootNode</strong>or
+ <strong>xmlChildrenNode</strong>fields.</em>
+ <p>The source code you are using has been <a href="upgrade.html">upgraded</a>to be able to compile with both libxmland
+ libxml2, but you need to install a more recent version:libxml(-devel)
+ &gt;= 1.8.8 or libxml2(-devel) &gt;= 2.1.0</p>
</li>
<li><em>XPath implementation looks seriously broken</em>
- <p>XPath implementation prior to 2.3.0 was really incomplete. Upgrade to
- a recent version, there are no known bugs in the current version.</p>
+ <p>XPath implementation prior to 2.3.0 was really incomplete. Upgrade toa
+ recent version, there are no known bugs in the current version.</p>
</li>
<li><em>The example provided in the web page does not compile.</em>
- <p>It's hard to maintain the documentation in sync with the code
- &lt;grin/&gt; ...</p>
- <p>Check the previous points 1/ and 2/ raised before, and please send
- patches.</p>
+ <p>It's hard to maintain the documentation in sync with the
+ code&lt;grin/&gt; ...</p>
+ <p>Check the previous points 1/ and 2/ raised before, and please
+ sendpatches.</p>
</li>
- <li><em>Where can I get more examples and information than provided on the
- web page?</em>
- <p>Ideally a libxml2 book would be nice. I have no such plan ... But you
- can:</p>
- <ul><li>check more deeply the <a href="html/libxml-lib.html">existing
- generated doc</a></li>
- <li>have a look at <a href="examples/index.html">the set of
- examples</a>.</li>
- <li>look for examples of use for libxml2 function using the Gnome code.
- For example the following will query the full Gnome CVS base for the
- use of the <strong>xmlAddChild()</strong> function:
+ <li><em>Where can I get more examples and information than provided on
+ theweb page?</em>
+ <p>Ideally a libxml2 book would be nice. I have no such plan ... But
+ youcan:</p>
+ <ul><li>check more deeply the <a href="html/libxml-lib.html">existinggenerated doc</a></li>
+ <li>have a look at <a href="examples/index.html">the set
+ ofexamples</a>.</li>
+ <li>look for examples of use for libxml2 function using the Gnome
+ code.For example the following will query the full Gnome CVS base for
+ theuse of the <strong>xmlAddChild()</strong>function:
<p><a href="http://cvs.gnome.org/lxr/search?string=xmlAddChild">http://cvs.gnome.org/lxr/search?string=xmlAddChild</a></p>
- <p>This may be slow, a large hardware donation to the gnome project
- could cure this :-)</p>
+ <p>This may be slow, a large hardware donation to the gnome
+ projectcould cure this :-)</p>
</li>
- <li><a href="http://cvs.gnome.org/bonsai/rview.cgi?cvsroot=/cvs/gnome&amp;dir=gnome-xml">Browse
- the libxml2 source</a> , I try to write code as clean and documented
- as possible, so looking at it may be helpful. In particular the code
- of xmllint.c and of the various testXXX.c test programs should
- provide good examples of how to do things with the library.</li>
+ <li><a href="http://cvs.gnome.org/bonsai/rview.cgi?cvsroot=/cvs/gnome&amp;dir=gnome-xml">Browsethe
+ libxml2 source</a>, I try to write code as clean and documentedas
+ possible, so looking at it may be helpful. In particular the codeof
+ xmllint.c and of the various testXXX.c test programs shouldprovide
+ good examples of how to do things with the library.</li>
</ul></li>
<li>What about C++ ?
- <p>libxml2 is written in pure C in order to allow easy reuse on a number
- of platforms, including embedded systems. I don't intend to convert to
- C++.</p>
+ <p>libxml2 is written in pure C in order to allow easy reuse on a
+ numberof platforms, including embedded systems. I don't intend to convert
+ toC++.</p>
<p>There is however a C++ wrapper which may fulfill your needs:</p>
<ul><li>by Ari Johnson &lt;ari@btigate.com&gt;:
<p>Website: <a href="http://libxmlplusplus.sourceforge.net/">http://libxmlplusplus.sourceforge.net/</a></p>
@@ -261,11 +258,10 @@ pnode=pxmlDoc-&gt;children-&gt;children;</pre>
-->
</ul></li>
<li>How to validate a document a posteriori ?
- <p>It is possible to validate documents which had not been validated at
- initial parsing time or documents which have been built from scratch
- using the API. Use the <a href="http://xmlsoft.org/html/libxml-valid.html#xmlValidateDtd">xmlValidateDtd()</a>
- function. It is also possible to simply add a DTD to an existing
- document:</p>
+ <p>It is possible to validate documents which had not been validated
+ atinitial parsing time or documents which have been built from
+ scratchusing the API. Use the <a href="http://xmlsoft.org/html/libxml-valid.html#xmlValidateDtd">xmlValidateDtd()</a>function.
+ It is also possible to simply add a DTD to an existingdocument:</p>
<pre>xmlDocPtr doc; /* your existing document */
xmlDtdPtr dtd = xmlParseDTD(NULL, filename_of_dtd); /* parse the DTD */
@@ -277,10 +273,10 @@ xmlDtdPtr dtd = xmlParseDTD(NULL, filename_of_dtd); /* parse the DTD */
</pre>
</li>
<li>So what is this funky "xmlChar" used all the time?
- <p>It is a null terminated sequence of utf-8 characters. And only utf-8!
- You need to convert strings encoded in different ways to utf-8 before
- passing them to the API. This can be accomplished with the iconv library
- for instance.</p>
+ <p>It is a null terminated sequence of utf-8 characters. And only
+ utf-8!You need to convert strings encoded in different ways to utf-8
+ beforepassing them to the API. This can be accomplished with the iconv
+ libraryfor instance.</p>
</li>
<li>etc ...</li>
</ol><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/XMLinfo.html b/doc/XMLinfo.html
index 474f9c1c..347f4002 100644
--- a/doc/XMLinfo.html
+++ b/doc/XMLinfo.html
@@ -7,9 +7,8 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>XML</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>XML</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p><a href="http://www.w3.org/TR/REC-xml">XML is a standard</a> for
-markup-based structured documents. Here is <a name="example" id="example">an example XML
-document</a>:</p><pre>&lt;?xml version="1.0"?&gt;
+</style><title>XML</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>XML</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p><a href="http://www.w3.org/TR/REC-xml">XML is a
+standard</a>formarkup-based structured documents. Here is <a name="example" id="example">an example XMLdocument</a>:</p><pre>&lt;?xml version="1.0"?&gt;
&lt;EXAMPLE prop1="gnome is great" prop2="&amp;amp; linux too"&gt;
&lt;head&gt;
&lt;title&gt;Welcome to Gnome&lt;/title&gt;
@@ -20,16 +19,16 @@ document</a>:</p><pre>&lt;?xml version="1.0"?&gt;
&lt;image href="linus.gif"/&gt;
&lt;p&gt;...&lt;/p&gt;
&lt;/chapter&gt;
-&lt;/EXAMPLE&gt;</pre><p>The first line specifies that it is an XML document and gives useful
-information about its encoding. Then the rest of the document is a text
-format whose structure is specified by tags between brackets. <strong>Each
-tag opened has to be closed</strong>. XML is pedantic about this. However, if
-a tag is empty (no content), a single tag can serve as both the opening and
-closing tag if it ends with <code>/&gt;</code> rather than with
-<code>&gt;</code>. Note that, for example, the image tag has no content (just
-an attribute) and is closed by ending the tag with <code>/&gt;</code>.</p><p>XML can be applied successfully to a wide range of tasks, ranging from
-long term structured document maintenance (where it follows the steps of
-SGML) to simple data encoding mechanisms like configuration file formatting
-(glade), spreadsheets (gnumeric), or even shorter lived documents such as
-WebDAV where it is used to encode remote calls between a client and a
-server.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+&lt;/EXAMPLE&gt;</pre><p>The first line specifies that it is an XML document and gives
+usefulinformation about its encoding. Then the rest of the document is a
+textformat whose structure is specified by tags between brackets.
+<strong>Eachtag opened has to be closed</strong>. XML is pedantic about this.
+However, ifa tag is empty (no content), a single tag can serve as both the
+opening andclosing tag if it ends with <code>/&gt;</code>rather than
+with<code>&gt;</code>. Note that, for example, the image tag has no content
+(justan attribute) and is closed by ending the tag with
+<code>/&gt;</code>.</p><p>XML can be applied successfully to a wide range of tasks, ranging fromlong
+term structured document maintenance (where it follows the steps ofSGML) to
+simple data encoding mechanisms like configuration file formatting(glade),
+spreadsheets (gnumeric), or even shorter lived documents such asWebDAV where
+it is used to encode remote calls between a client and aserver.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/XSLT.html b/doc/XSLT.html
index 657ead30..29385d99 100644
--- a/doc/XSLT.html
+++ b/doc/XSLT.html
@@ -7,7 +7,7 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>XSLT</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>XSLT</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Check <a href="http://xmlsoft.org/XSLT">the separate libxslt page</a></p><p><a href="http://www.w3.org/TR/xslt">XSL Transformations</a>, is a
-language for transforming XML documents into other XML documents (or
-HTML/textual output).</p><p>A separate library called libxslt is available implementing XSLT-1.0 for
-libxml2. This module "libxslt" too can be found in the Gnome CVS base.</p><p>You can check the progresses on the libxslt <a href="http://xmlsoft.org/XSLT/ChangeLog.html">Changelog</a>.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+</style><title>XSLT</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>XSLT</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Check <a href="http://xmlsoft.org/XSLT">the separate libxslt page</a></p><p><a href="http://www.w3.org/TR/xslt">XSL Transformations</a>, is alanguage
+for transforming XML documents into other XML documents (orHTML/textual
+output).</p><p>A separate library called libxslt is available implementing XSLT-1.0
+forlibxml2. This module "libxslt" too can be found in the Gnome CVS base.</p><p>You can check the progresses on the libxslt <a href="http://xmlsoft.org/XSLT/ChangeLog.html">Changelog</a>.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/architecture.html b/doc/architecture.html
index 906c5b2d..9623bb39 100644
--- a/doc/architecture.html
+++ b/doc/architecture.html
@@ -7,8 +7,8 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>libxml2 architecture</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>libxml2 architecture</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Libxml2 is made of multiple components; some of them are optional, and
-most of the block interfaces are public. The main components are:</p><ul><li>an Input/Output layer</li>
+</style><title>libxml2 architecture</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>libxml2 architecture</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Libxml2 is made of multiple components; some of them are optional, andmost
+of the block interfaces are public. The main components are:</p><ul><li>an Input/Output layer</li>
<li>FTP and HTTP client layers (optional)</li>
<li>an Internationalization layer managing the encodings support</li>
<li>a URI module</li>
@@ -17,7 +17,6 @@ most of the block interfaces are public. The main components are:</p><ul><li>an
<li>a SAX tree module to build an in-memory DOM representation</li>
<li>a tree module to manipulate the DOM representation</li>
<li>a validation module using the DOM representation (optional)</li>
- <li>an XPath module for global lookup in a DOM representation
- (optional)</li>
+ <li>an XPath module for global lookup in a DOM representation(optional)</li>
<li>a debug module (optional)</li>
</ul><p>Graphically this gives the following:</p><p><img src="libxml.gif" alt="a graphical view of the various" /></p><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/bugs.html b/doc/bugs.html
index 6415c85b..e69f3edb 100644
--- a/doc/bugs.html
+++ b/doc/bugs.html
@@ -7,62 +7,60 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Reporting bugs and getting help</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Reporting bugs and getting help</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Well, bugs or missing features are always possible, and I will make a
-point of fixing them in a timely fashion. The best way to report a bug is to
-use the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Gnome
-bug tracking database</a> (make sure to use the "libxml2" module name). I
-look at reports there regularly and it's good to have a reminder when a bug
-is still open. Be sure to specify that the bug is for the package libxml2.</p><p>For small problems you can try to get help on IRC, the #xml channel on
-irc.gnome.org (port 6667) usually have a few person subscribed which may help
-(but there is no garantee and if a real issue is raised it should go on the
-mailing-list for archival).</p><p>There is also a mailing-list <a href="mailto:xml@gnome.org">xml@gnome.org</a> for libxml, with an <a href="http://mail.gnome.org/archives/xml/">on-line archive</a> (<a href="http://xmlsoft.org/messages">old</a>). To subscribe to this list,
-please visit the <a href="http://mail.gnome.org/mailman/listinfo/xml">associated Web</a> page and
-follow the instructions. <strong>Do not send code, I won't debug it</strong>
-(but patches are really appreciated!).</p><p>Please note that with the current amount of virus and SPAM, sending mail
-to the list without being subscribed won't work. There is *far too many
-bounces* (in the order of a thousand a day !) I cannot approve them manually
-anymore. If your mail to the list bounced waiting for administrator approval,
-it is LOST ! Repost it and fix the problem triggering the error. Also please
-note that <span style="color: #FF0000; background-color: #FFFFFF">emails with
-a legal warning asking to not copy or redistribute freely the informations
-they contain</span> are <strong>NOT</strong> acceptable for the mailing-list,
-such mail will as much as possible be discarded automatically, and are less
-likely to be answered if they made it to the list, <strong>DO NOT</strong>
-post to the list from an email address where such legal requirements are
-automatically added, get private paying support if you can't share
-informations.</p><p>Check the following <strong><span style="color: #FF0000">before
-posting</span></strong>:</p><ul><li>Read the <a href="FAQ.html">FAQ</a> and <a href="search.php">use the
- search engine</a> to get information related to your problem.</li>
- <li>Make sure you are <a href="ftp://xmlsoft.org/libxml2/">using a recent
- version</a>, and that the problem still shows up in a recent version.</li>
- <li>Check the <a href="http://mail.gnome.org/archives/xml/">list
- archives</a> to see if the problem was reported already. In this case
- there is probably a fix available, similarly check the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">registered
- open bugs</a>.</li>
- <li>Make sure you can reproduce the bug with xmllint or one of the test
- programs found in source in the distribution.</li>
- <li>Please send the command showing the error as well as the input (as an
- attachment)</li>
-</ul><p>Then send the bug with associated information to reproduce it to the <a href="mailto:xml@gnome.org">xml@gnome.org</a> list; if it's really libxml
-related I will approve it. Please do not send mail to me directly, it makes
-things really hard to track and in some cases I am not the best person to
-answer a given question, ask on the list.</p><p>To <span style="color: #E50000">be really clear about support</span>:</p><ul><li>Support or help <span style="color: #E50000">requests MUST be sent to
- the list or on bugzilla</span> in case of problems, so that the Question
- and Answers can be shared publicly. Failing to do so carries the implicit
- message "I want free support but I don't want to share the benefits with
- others" and is not welcome. I will automatically Carbon-Copy the
- xml@gnome.org mailing list for any technical reply made about libxml2 or
- libxslt.</li>
- <li>There is <span style="color: #E50000">no garantee of support</span>, if
- your question remains unanswered after a week, repost it, making sure you
- gave all the detail needed and the information requested.</li>
- <li>Failing to provide information as requested or double checking first
- for prior feedback also carries the implicit message "the time of the
- library maintainers is less valuable than my time" and might not be
- welcome.</li>
-</ul><p>Of course, bugs reported with a suggested patch for fixing them will
-probably be processed faster than those without.</p><p>If you're looking for help, a quick look at <a href="http://mail.gnome.org/archives/xml/">the list archive</a> may actually
-provide the answer. I usually send source samples when answering libxml2
-usage questions. The <a href="http://xmlsoft.org/html/book1.html">auto-generated documentation</a> is
-not as polished as I would like (i need to learn more about DocBook), but
-it's a good starting point.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+</style><title>Reporting bugs and getting help</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Reporting bugs and getting help</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Well, bugs or missing features are always possible, and I will make apoint
+of fixing them in a timely fashion. The best way to report a bug is touse the
+<a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Gnomebug
+tracking database</a>(make sure to use the "libxml2" module name). Ilook at
+reports there regularly and it's good to have a reminder when a bugis still
+open. Be sure to specify that the bug is for the package libxml2.</p><p>For small problems you can try to get help on IRC, the #xml channel
+onirc.gnome.org (port 6667) usually have a few person subscribed which may
+help(but there is no garantee and if a real issue is raised it should go on
+themailing-list for archival).</p><p>There is also a mailing-list <a href="mailto:xml@gnome.org">xml@gnome.org</a>for libxml, with an <a href="http://mail.gnome.org/archives/xml/">on-line archive</a>(<a href="http://xmlsoft.org/messages">old</a>). To subscribe to this list,please
+visit the <a href="http://mail.gnome.org/mailman/listinfo/xml">associated
+Web</a>page andfollow the instructions. <strong>Do not send code, I won't
+debug it</strong>(but patches are really appreciated!).</p><p>Please note that with the current amount of virus and SPAM, sending mailto
+the list without being subscribed won't work. There is *far too manybounces*
+(in the order of a thousand a day !) I cannot approve them manuallyanymore.
+If your mail to the list bounced waiting for administrator approval,it is
+LOST ! Repost it and fix the problem triggering the error. Also pleasenote
+that <span style="color: #FF0000; background-color: #FFFFFF">emails witha
+legal warning asking to not copy or redistribute freely the informationsthey
+contain</span>are <strong>NOT</strong>acceptable for the mailing-list,such
+mail will as much as possible be discarded automatically, and are lesslikely
+to be answered if they made it to the list, <strong>DO NOT</strong>post to
+the list from an email address where such legal requirements areautomatically
+added, get private paying support if you can't shareinformations.</p><p>Check the following <strong><span style="color: #FF0000">beforeposting</span></strong>:</p><ul><li>Read the <a href="FAQ.html">FAQ</a>and <a href="search.php">use
+ thesearch engine</a>to get information related to your problem.</li>
+ <li>Make sure you are <a href="ftp://xmlsoft.org/libxml2/">using a
+ recentversion</a>, and that the problem still shows up in a recent
+ version.</li>
+ <li>Check the <a href="http://mail.gnome.org/archives/xml/">listarchives</a>to see if the
+ problem was reported already. In this casethere is probably a fix
+ available, similarly check the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">registeredopen
+ bugs</a>.</li>
+ <li>Make sure you can reproduce the bug with xmllint or one of the
+ testprograms found in source in the distribution.</li>
+ <li>Please send the command showing the error as well as the input (as
+ anattachment)</li>
+</ul><p>Then send the bug with associated information to reproduce it to the <a href="mailto:xml@gnome.org">xml@gnome.org</a>list; if it's really
+libxmlrelated I will approve it. Please do not send mail to me directly, it
+makesthings really hard to track and in some cases I am not the best person
+toanswer a given question, ask on the list.</p><p>To <span style="color: #E50000">be really clear about support</span>:</p><ul><li>Support or help <span style="color: #E50000">requests MUST be sent
+ tothe list or on bugzilla</span>in case of problems, so that the
+ Questionand Answers can be shared publicly. Failing to do so carries the
+ implicitmessage "I want free support but I don't want to share the
+ benefits withothers" and is not welcome. I will automatically Carbon-Copy
+ thexml@gnome.org mailing list for any technical reply made about libxml2
+ orlibxslt.</li>
+ <li>There is <span style="color: #E50000">no garantee of support</span>,
+ ifyour question remains unanswered after a week, repost it, making sure
+ yougave all the detail needed and the information requested.</li>
+ <li>Failing to provide information as requested or double checking firstfor
+ prior feedback also carries the implicit message "the time of thelibrary
+ maintainers is less valuable than my time" and might not bewelcome.</li>
+</ul><p>Of course, bugs reported with a suggested patch for fixing them
+willprobably be processed faster than those without.</p><p>If you're looking for help, a quick look at <a href="http://mail.gnome.org/archives/xml/">the list archive</a>may
+actuallyprovide the answer. I usually send source samples when answering
+libxml2usage questions. The <a href="http://xmlsoft.org/html/book1.html">auto-generated
+documentation</a>isnot as polished as I would like (i need to learn more
+about DocBook), butit's a good starting point.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/catalog.html b/doc/catalog.html
index 4100fed9..435990e5 100644
--- a/doc/catalog.html
+++ b/doc/catalog.html
@@ -14,77 +14,77 @@ A:link, A:visited, A:active { text-decoration: underline }
<li><a href="#reference">How to tune catalog usage</a></li>
<li><a href="#validate">How to debug catalog processing</a></li>
<li><a href="#Declaring">How to create and maintain catalogs</a></li>
- <li><a href="#implemento">The implementor corner quick review of the
- API</a></li>
+ <li><a href="#implemento">The implementor corner quick review of
+ theAPI</a></li>
<li><a href="#Other">Other resources</a></li>
-</ol><h3><a name="General2" id="General2">General overview</a></h3><p>What is a catalog? Basically it's a lookup mechanism used when an entity
-(a file or a remote resource) references another entity. The catalog lookup
-is inserted between the moment the reference is recognized by the software
-(XML parser, stylesheet processing, or even images referenced for inclusion
-in a rendering) and the time where loading that resource is actually
-started.</p><p>It is basically used for 3 things:</p><ul><li>mapping from "logical" names, the public identifiers and a more
- concrete name usable for download (and URI). For example it can associate
- the logical name
+</ol><h3><a name="General2" id="General2">General overview</a></h3><p>What is a catalog? Basically it's a lookup mechanism used when an entity(a
+file or a remote resource) references another entity. The catalog lookupis
+inserted between the moment the reference is recognized by the software(XML
+parser, stylesheet processing, or even images referenced for inclusionin a
+rendering) and the time where loading that resource is actuallystarted.</p><p>It is basically used for 3 things:</p><ul><li>mapping from "logical" names, the public identifiers and a moreconcrete
+ name usable for download (and URI). For example it can associatethe
+ logical name
<p>"-//OASIS//DTD DocBook XML V4.1.2//EN"</p>
- <p>of the DocBook 4.1.2 XML DTD with the actual URL where it can be
- downloaded</p>
+ <p>of the DocBook 4.1.2 XML DTD with the actual URL where it can
+ bedownloaded</p>
<p>http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd</p>
</li>
- <li>remapping from a given URL to another one, like an HTTP indirection
- saying that
+ <li>remapping from a given URL to another one, like an HTTP
+ indirectionsaying that
<p>"http://www.oasis-open.org/committes/tr.xsl"</p>
<p>should really be looked at</p>
<p>"http://www.oasis-open.org/committes/entity/stylesheets/base/tr.xsl"</p>
</li>
- <li>providing a local cache mechanism allowing to load the entities
- associated to public identifiers or remote resources, this is a really
- important feature for any significant deployment of XML or SGML since it
- allows to avoid the aleas and delays associated to fetching remote
- resources.</li>
-</ul><h3><a name="definition" id="definition">The definitions</a></h3><p>Libxml, as of 2.4.3 implements 2 kind of catalogs:</p><ul><li>the older SGML catalogs, the official spec is SGML Open Technical
- Resolution TR9401:1997, but is better understood by reading <a href="http://www.jclark.com/sp/catalog.htm">the SP Catalog page</a> from
- James Clark. This is relatively old and not the preferred mode of
- operation of libxml.</li>
- <li><a href="http://www.oasis-open.org/committees/entity/spec.html">XML
- Catalogs</a> is far more flexible, more recent, uses an XML syntax and
- should scale quite better. This is the default option of libxml.</li>
-</ul><p></p><h3><a name="Simple" id="Simple">Using catalog</a></h3><p>In a normal environment libxml2 will by default check the presence of a
-catalog in /etc/xml/catalog, and assuming it has been correctly populated,
-the processing is completely transparent to the document user. To take a
-concrete example, suppose you are authoring a DocBook document, this one
-starts with the following DOCTYPE definition:</p><pre>&lt;?xml version='1.0'?&gt;
+ <li>providing a local cache mechanism allowing to load the
+ entitiesassociated to public identifiers or remote resources, this is a
+ reallyimportant feature for any significant deployment of XML or SGML
+ since itallows to avoid the aleas and delays associated to fetching
+ remoteresources.</li>
+</ul><h3><a name="definition" id="definition">The definitions</a></h3><p>Libxml, as of 2.4.3 implements 2 kind of catalogs:</p><ul><li>the older SGML catalogs, the official spec is SGML Open
+ TechnicalResolution TR9401:1997, but is better understood by reading <a href="http://www.jclark.com/sp/catalog.htm">the SP Catalog
+ page</a>fromJames Clark. This is relatively old and not the preferred
+ mode ofoperation of libxml.</li>
+ <li><a href="http://www.oasis-open.org/committees/entity/spec.html">XMLCatalogs</a>is
+ far more flexible, more recent, uses an XML syntax andshould scale quite
+ better. This is the default option of libxml.</li>
+</ul><p></p><h3><a name="Simple" id="Simple">Using catalog</a></h3><p>In a normal environment libxml2 will by default check the presence of
+acatalog in /etc/xml/catalog, and assuming it has been correctly
+populated,the processing is completely transparent to the document user. To
+take aconcrete example, suppose you are authoring a DocBook document, this
+onestarts with the following DOCTYPE definition:</p><pre>&lt;?xml version='1.0'?&gt;
&lt;!DOCTYPE book PUBLIC "-//Norman Walsh//DTD DocBk XML V3.1.4//EN"
- "http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd"&gt;</pre><p>When validating the document with libxml, the catalog will be
-automatically consulted to lookup the public identifier "-//Norman Walsh//DTD
-DocBk XML V3.1.4//EN" and the system identifier
-"http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd", and if these entities have
-been installed on your system and the catalogs actually point to them, libxml
-will fetch them from the local disk.</p><p style="font-size: 10pt"><strong>Note</strong>: Really don't use this
-DOCTYPE example it's a really old version, but is fine as an example.</p><p>Libxml2 will check the catalog each time that it is requested to load an
-entity, this includes DTD, external parsed entities, stylesheets, etc ... If
-your system is correctly configured all the authoring phase and processing
-should use only local files, even if your document stays portable because it
-uses the canonical public and system ID, referencing the remote document.</p><h3><a name="Some" id="Some">Some examples:</a></h3><p>Here is a couple of fragments from XML Catalogs used in libxml2 early
-regression tests in <code>test/catalogs</code> :</p><pre>&lt;?xml version="1.0"?&gt;
+ "http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd"&gt;</pre><p>When validating the document with libxml, the catalog will beautomatically
+consulted to lookup the public identifier "-//Norman Walsh//DTDDocBk XML
+V3.1.4//EN" and the system
+identifier"http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd", and if these
+entities havebeen installed on your system and the catalogs actually point to
+them, libxmlwill fetch them from the local disk.</p><p style="font-size: 10pt"><strong>Note</strong>: Really don't use
+thisDOCTYPE example it's a really old version, but is fine as an example.</p><p>Libxml2 will check the catalog each time that it is requested to load
+anentity, this includes DTD, external parsed entities, stylesheets, etc ...
+Ifyour system is correctly configured all the authoring phase and
+processingshould use only local files, even if your document stays portable
+because ituses the canonical public and system ID, referencing the remote
+document.</p><h3><a name="Some" id="Some">Some examples:</a></h3><p>Here is a couple of fragments from XML Catalogs used in libxml2
+earlyregression tests in <code>test/catalogs</code>:</p><pre>&lt;?xml version="1.0"?&gt;
&lt;!DOCTYPE catalog PUBLIC
"-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
"http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd"&gt;
&lt;catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"&gt;
&lt;public publicId="-//OASIS//DTD DocBook XML V4.1.2//EN"
uri="http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"/&gt;
-...</pre><p>This is the beginning of a catalog for DocBook 4.1.2, XML Catalogs are
-written in XML, there is a specific namespace for catalog elements
-"urn:oasis:names:tc:entity:xmlns:xml:catalog". The first entry in this
-catalog is a <code>public</code> mapping it allows to associate a Public
-Identifier with an URI.</p><pre>...
+...</pre><p>This is the beginning of a catalog for DocBook 4.1.2, XML Catalogs
+arewritten in XML, there is a specific namespace for catalog
+elements"urn:oasis:names:tc:entity:xmlns:xml:catalog". The first entry in
+thiscatalog is a <code>public</code>mapping it allows to associate a
+PublicIdentifier with an URI.</p><pre>...
&lt;rewriteSystem systemIdStartString="http://www.oasis-open.org/docbook/"
rewritePrefix="file:///usr/share/xml/docbook/"/&gt;
-...</pre><p>A <code>rewriteSystem</code> is a very powerful instruction, it says that
-any URI starting with a given prefix should be looked at another URI
-constructed by replacing the prefix with an new one. In effect this acts like
-a cache system for a full area of the Web. In practice it is extremely useful
-with a file prefix if you have installed a copy of those resources on your
-local system.</p><pre>...
+...</pre><p>A <code>rewriteSystem</code>is a very powerful instruction, it says
+thatany URI starting with a given prefix should be looked at another
+URIconstructed by replacing the prefix with an new one. In effect this acts
+likea cache system for a full area of the Web. In practice it is extremely
+usefulwith a file prefix if you have installed a copy of those resources on
+yourlocal system.</p><pre>...
&lt;delegatePublic publicIdStartString="-//OASIS//DTD XML Catalog //"
catalog="file:///usr/share/xml/docbook.xml"/&gt;
&lt;delegatePublic publicIdStartString="-//OASIS//ENTITIES DocBook XML"
@@ -95,21 +95,21 @@ local system.</p><pre>...
catalog="file:///usr/share/xml/docbook.xml"/&gt;
&lt;delegateURI uriStartString="http://www.oasis-open.org/docbook/"
catalog="file:///usr/share/xml/docbook.xml"/&gt;
-...</pre><p>Delegation is the core features which allows to build a tree of catalogs,
-easier to maintain than a single catalog, based on Public Identifier, System
-Identifier or URI prefixes it instructs the catalog software to look up
-entries in another resource. This feature allow to build hierarchies of
-catalogs, the set of entries presented should be sufficient to redirect the
-resolution of all DocBook references to the specific catalog in
-<code>/usr/share/xml/docbook.xml</code> this one in turn could delegate all
-references for DocBook 4.2.1 to a specific catalog installed at the same time
-as the DocBook resources on the local machine.</p><h3><a name="reference" id="reference">How to tune catalog usage:</a></h3><p>The user can change the default catalog behaviour by redirecting queries
-to its own set of catalogs, this can be done by setting the
-<code>XML_CATALOG_FILES</code> environment variable to a list of catalogs, an
-empty one should deactivate loading the default <code>/etc/xml/catalog</code>
-default catalog</p><h3><a name="validate" id="validate">How to debug catalog processing:</a></h3><p>Setting up the <code>XML_DEBUG_CATALOG</code> environment variable will
-make libxml2 output debugging informations for each catalog operations, for
-example:</p><pre>orchis:~/XML -&gt; xmllint --memory --noout test/ent2
+...</pre><p>Delegation is the core features which allows to build a tree of
+catalogs,easier to maintain than a single catalog, based on Public
+Identifier, SystemIdentifier or URI prefixes it instructs the catalog
+software to look upentries in another resource. This feature allow to build
+hierarchies ofcatalogs, the set of entries presented should be sufficient to
+redirect theresolution of all DocBook references to the specific catalog
+in<code>/usr/share/xml/docbook.xml</code>this one in turn could delegate
+allreferences for DocBook 4.2.1 to a specific catalog installed at the same
+timeas the DocBook resources on the local machine.</p><h3><a name="reference" id="reference">How to tune catalog usage:</a></h3><p>The user can change the default catalog behaviour by redirecting queriesto
+its own set of catalogs, this can be done by setting
+the<code>XML_CATALOG_FILES</code>environment variable to a list of catalogs,
+anempty one should deactivate loading the default
+<code>/etc/xml/catalog</code>default catalog</p><h3><a name="validate" id="validate">How to debug catalog processing:</a></h3><p>Setting up the <code>XML_DEBUG_CATALOG</code>environment variable willmake
+libxml2 output debugging informations for each catalog operations,
+forexample:</p><pre>orchis:~/XML -&gt; xmllint --memory --noout test/ent2
warning: failed to load external entity "title.xml"
orchis:~/XML -&gt; export XML_DEBUG_CATALOG=
orchis:~/XML -&gt; xmllint --memory --noout test/ent2
@@ -117,26 +117,26 @@ Failed to parse catalog /etc/xml/catalog
Failed to parse catalog /etc/xml/catalog
warning: failed to load external entity "title.xml"
Catalogs cleanup
-orchis:~/XML -&gt; </pre><p>The test/ent2 references an entity, running the parser from memory makes
-the base URI unavailable and the the "title.xml" entity cannot be loaded.
-Setting up the debug environment variable allows to detect that an attempt is
-made to load the <code>/etc/xml/catalog</code> but since it's not present the
-resolution fails.</p><p>But the most advanced way to debug XML catalog processing is to use the
-<strong>xmlcatalog</strong> command shipped with libxml2, it allows to load
-catalogs and make resolution queries to see what is going on. This is also
-used for the regression tests:</p><pre>orchis:~/XML -&gt; ./xmlcatalog test/catalogs/docbook.xml \
+orchis:~/XML -&gt; </pre><p>The test/ent2 references an entity, running the parser from memory
+makesthe base URI unavailable and the the "title.xml" entity cannot be
+loaded.Setting up the debug environment variable allows to detect that an
+attempt ismade to load the <code>/etc/xml/catalog</code>but since it's not
+present theresolution fails.</p><p>But the most advanced way to debug XML catalog processing is to use
+the<strong>xmlcatalog</strong>command shipped with libxml2, it allows to
+loadcatalogs and make resolution queries to see what is going on. This is
+alsoused for the regression tests:</p><pre>orchis:~/XML -&gt; ./xmlcatalog test/catalogs/docbook.xml \
"-//OASIS//DTD DocBook XML V4.1.2//EN"
http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
-orchis:~/XML -&gt; </pre><p>For debugging what is going on, adding one -v flags increase the verbosity
-level to indicate the processing done (adding a second flag also indicate
-what elements are recognized at parsing):</p><pre>orchis:~/XML -&gt; ./xmlcatalog -v test/catalogs/docbook.xml \
+orchis:~/XML -&gt; </pre><p>For debugging what is going on, adding one -v flags increase the
+verbositylevel to indicate the processing done (adding a second flag also
+indicatewhat elements are recognized at parsing):</p><pre>orchis:~/XML -&gt; ./xmlcatalog -v test/catalogs/docbook.xml \
"-//OASIS//DTD DocBook XML V4.1.2//EN"
Parsing catalog test/catalogs/docbook.xml's content
Found public match -//OASIS//DTD DocBook XML V4.1.2//EN
http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
Catalogs cleanup
-orchis:~/XML -&gt; </pre><p>A shell interface is also available to debug and process multiple queries
-(and for regression tests):</p><pre>orchis:~/XML -&gt; ./xmlcatalog -shell test/catalogs/docbook.xml \
+orchis:~/XML -&gt; </pre><p>A shell interface is also available to debug and process multiple
+queries(and for regression tests):</p><pre>orchis:~/XML -&gt; ./xmlcatalog -shell test/catalogs/docbook.xml \
"-//OASIS//DTD DocBook XML V4.1.2//EN"
&gt; help
Commands available:
@@ -152,18 +152,18 @@ exit: quit the shell
&gt; public "-//OASIS//DTD DocBook XML V4.1.2//EN"
http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
&gt; quit
-orchis:~/XML -&gt; </pre><p>This should be sufficient for most debugging purpose, this was actually
-used heavily to debug the XML Catalog implementation itself.</p><h3><a name="Declaring" id="Declaring">How to create and maintain</a> catalogs:</h3><p>Basically XML Catalogs are XML files, you can either use XML tools to
-manage them or use <strong>xmlcatalog</strong> for this. The basic step is
-to create a catalog the -create option provide this facility:</p><pre>orchis:~/XML -&gt; ./xmlcatalog --create tst.xml
+orchis:~/XML -&gt; </pre><p>This should be sufficient for most debugging purpose, this was
+actuallyused heavily to debug the XML Catalog implementation itself.</p><h3><a name="Declaring" id="Declaring">How to create and maintain</a>catalogs:</h3><p>Basically XML Catalogs are XML files, you can either use XML tools
+tomanage them or use <strong>xmlcatalog</strong>for this. The basic step
+isto create a catalog the -create option provide this facility:</p><pre>orchis:~/XML -&gt; ./xmlcatalog --create tst.xml
&lt;?xml version="1.0"?&gt;
&lt;!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
"http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd"&gt;
&lt;catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"/&gt;
-orchis:~/XML -&gt; </pre><p>By default xmlcatalog does not overwrite the original catalog and save the
-result on the standard output, this can be overridden using the -noout
-option. The <code>-add</code> command allows to add entries in the
-catalog:</p><pre>orchis:~/XML -&gt; ./xmlcatalog --noout --create --add "public" \
+orchis:~/XML -&gt; </pre><p>By default xmlcatalog does not overwrite the original catalog and save
+theresult on the standard output, this can be overridden using the
+-nooutoption. The <code>-add</code>command allows to add entries in
+thecatalog:</p><pre>orchis:~/XML -&gt; ./xmlcatalog --noout --create --add "public" \
"-//OASIS//DTD DocBook XML V4.1.2//EN" \
http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd tst.xml
orchis:~/XML -&gt; cat tst.xml
@@ -174,83 +174,82 @@ orchis:~/XML -&gt; cat tst.xml
&lt;public publicId="-//OASIS//DTD DocBook XML V4.1.2//EN"
uri="http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"/&gt;
&lt;/catalog&gt;
-orchis:~/XML -&gt; </pre><p>The <code>-add</code> option will always take 3 parameters even if some of
-the XML Catalog constructs (like nextCatalog) will have only a single
-argument, just pass a third empty string, it will be ignored.</p><p>Similarly the <code>-del</code> option remove matching entries from the
-catalog:</p><pre>orchis:~/XML -&gt; ./xmlcatalog --del \
+orchis:~/XML -&gt; </pre><p>The <code>-add</code>option will always take 3 parameters even if some
+ofthe XML Catalog constructs (like nextCatalog) will have only a
+singleargument, just pass a third empty string, it will be ignored.</p><p>Similarly the <code>-del</code>option remove matching entries from
+thecatalog:</p><pre>orchis:~/XML -&gt; ./xmlcatalog --del \
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" tst.xml
&lt;?xml version="1.0"?&gt;
&lt;!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
"http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd"&gt;
&lt;catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"/&gt;
-orchis:~/XML -&gt; </pre><p>The catalog is now empty. Note that the matching of <code>-del</code> is
-exact and would have worked in a similar fashion with the Public ID
-string.</p><p>This is rudimentary but should be sufficient to manage a not too complex
-catalog tree of resources.</p><h3><a name="implemento" id="implemento">The implementor corner quick review of the
-API:</a></h3><p>First, and like for every other module of libxml, there is an
-automatically generated <a href="html/libxml-catalog.html">API page for
-catalog support</a>.</p><p>The header for the catalog interfaces should be included as:</p><pre>#include &lt;libxml/catalog.h&gt;</pre><p>The API is voluntarily kept very simple. First it is not obvious that
-applications really need access to it since it is the default behaviour of
-libxml2 (Note: it is possible to completely override libxml2 default catalog
-by using <a href="html/libxml-parser.html">xmlSetExternalEntityLoader</a> to
-plug an application specific resolver).</p><p>Basically libxml2 support 2 catalog lists:</p><ul><li>the default one, global shared by all the application</li>
- <li>a per-document catalog, this one is built if the document uses the
- <code>oasis-xml-catalog</code> PIs to specify its own catalog list, it is
- associated to the parser context and destroyed when the parsing context
- is destroyed.</li>
-</ul><p>the document one will be used first if it exists.</p><h4>Initialization routines:</h4><p>xmlInitializeCatalog(), xmlLoadCatalog() and xmlLoadCatalogs() should be
-used at startup to initialize the catalog, if the catalog should be
-initialized with specific values xmlLoadCatalog() or xmlLoadCatalogs()
-should be called before xmlInitializeCatalog() which would otherwise do a
-default initialization first.</p><p>The xmlCatalogAddLocal() call is used by the parser to grow the document
-own catalog list if needed.</p><h4>Preferences setup:</h4><p>The XML Catalog spec requires the possibility to select default
-preferences between public and system delegation,
-xmlCatalogSetDefaultPrefer() allows this, xmlCatalogSetDefaults() and
-xmlCatalogGetDefaults() allow to control if XML Catalogs resolution should
-be forbidden, allowed for global catalog, for document catalog or both, the
-default is to allow both.</p><p>And of course xmlCatalogSetDebug() allows to generate debug messages
-(through the xmlGenericError() mechanism).</p><h4>Querying routines:</h4><p>xmlCatalogResolve(), xmlCatalogResolveSystem(), xmlCatalogResolvePublic()
-and xmlCatalogResolveURI() are relatively explicit if you read the XML
-Catalog specification they correspond to section 7 algorithms, they should
-also work if you have loaded an SGML catalog with a simplified semantic.</p><p>xmlCatalogLocalResolve() and xmlCatalogLocalResolveURI() are the same but
-operate on the document catalog list</p><h4>Cleanup and Miscellaneous:</h4><p>xmlCatalogCleanup() free-up the global catalog, xmlCatalogFreeLocal() is
-the per-document equivalent.</p><p>xmlCatalogAdd() and xmlCatalogRemove() are used to dynamically modify the
-first catalog in the global list, and xmlCatalogDump() allows to dump a
-catalog state, those routines are primarily designed for xmlcatalog, I'm not
-sure that exposing more complex interfaces (like navigation ones) would be
-really useful.</p><p>The xmlParseCatalogFile() is a function used to load XML Catalog files,
-it's similar as xmlParseFile() except it bypass all catalog lookups, it's
-provided because this functionality may be useful for client tools.</p><h4>threaded environments:</h4><p>Since the catalog tree is built progressively, some care has been taken to
-try to avoid troubles in multithreaded environments. The code is now thread
-safe assuming that the libxml2 library has been compiled with threads
-support.</p><p></p><h3><a name="Other" id="Other">Other resources</a></h3><p>The XML Catalog specification is relatively recent so there isn't much
-literature to point at:</p><ul><li>You can find a good rant from Norm Walsh about <a href="http://www.arbortext.com/Think_Tank/XML_Resources/Issue_Three/issue_three.html">the
- need for catalogs</a>, it provides a lot of context informations even if
- I don't agree with everything presented. Norm also wrote a more recent
- article <a href="http://wwws.sun.com/software/xml/developers/resolver/article/">XML
- entities and URI resolvers</a> describing them.</li>
- <li>An <a href="http://home.ccil.org/~cowan/XML/XCatalog.html">old XML
- catalog proposal</a> from John Cowan</li>
- <li>The <a href="http://www.rddl.org/">Resource Directory Description
- Language</a> (RDDL) another catalog system but more oriented toward
- providing metadata for XML namespaces.</li>
- <li>the page from the OASIS Technical <a href="http://www.oasis-open.org/committees/entity/">Committee on Entity
- Resolution</a> who maintains XML Catalog, you will find pointers to the
- specification update, some background and pointers to others tools
- providing XML Catalog support</li>
- <li>There is a <a href="buildDocBookCatalog">shell script</a> to generate
- XML Catalogs for DocBook 4.1.2 . If it can write to the /etc/xml/
- directory, it will set-up /etc/xml/catalog and /etc/xml/docbook based on
- the resources found on the system. Otherwise it will just create
- ~/xmlcatalog and ~/dbkxmlcatalog and doing:
+orchis:~/XML -&gt; </pre><p>The catalog is now empty. Note that the matching of
+<code>-del</code>isexact and would have worked in a similar fashion with the
+Public IDstring.</p><p>This is rudimentary but should be sufficient to manage a not too
+complexcatalog tree of resources.</p><h3><a name="implemento" id="implemento">The implementor corner quick review of
+theAPI:</a></h3><p>First, and like for every other module of libxml, there is anautomatically
+generated <a href="html/libxml-catalog.html">API page forcatalog
+support</a>.</p><p>The header for the catalog interfaces should be included as:</p><pre>#include &lt;libxml/catalog.h&gt;</pre><p>The API is voluntarily kept very simple. First it is not obvious
+thatapplications really need access to it since it is the default behaviour
+oflibxml2 (Note: it is possible to completely override libxml2 default
+catalogby using <a href="html/libxml-parser.html">xmlSetExternalEntityLoader</a>toplug an
+application specific resolver).</p><p>Basically libxml2 support 2 catalog lists:</p><ul><li>the default one, global shared by all the application</li>
+ <li>a per-document catalog, this one is built if the document uses
+ the<code>oasis-xml-catalog</code>PIs to specify its own catalog list, it
+ isassociated to the parser context and destroyed when the parsing
+ contextis destroyed.</li>
+</ul><p>the document one will be used first if it exists.</p><h4>Initialization routines:</h4><p>xmlInitializeCatalog(), xmlLoadCatalog() and xmlLoadCatalogs() should
+beused at startup to initialize the catalog, if the catalog should
+beinitialized with specific values xmlLoadCatalog() or
+xmlLoadCatalogs()should be called before xmlInitializeCatalog() which would
+otherwise do adefault initialization first.</p><p>The xmlCatalogAddLocal() call is used by the parser to grow the
+documentown catalog list if needed.</p><h4>Preferences setup:</h4><p>The XML Catalog spec requires the possibility to select defaultpreferences
+between public and system delegation,xmlCatalogSetDefaultPrefer() allows
+this, xmlCatalogSetDefaults() andxmlCatalogGetDefaults() allow to control if
+XML Catalogs resolution shouldbe forbidden, allowed for global catalog, for
+document catalog or both, thedefault is to allow both.</p><p>And of course xmlCatalogSetDebug() allows to generate debug
+messages(through the xmlGenericError() mechanism).</p><h4>Querying routines:</h4><p>xmlCatalogResolve(), xmlCatalogResolveSystem(),
+xmlCatalogResolvePublic()and xmlCatalogResolveURI() are relatively explicit
+if you read the XMLCatalog specification they correspond to section 7
+algorithms, they shouldalso work if you have loaded an SGML catalog with a
+simplified semantic.</p><p>xmlCatalogLocalResolve() and xmlCatalogLocalResolveURI() are the same
+butoperate on the document catalog list</p><h4>Cleanup and Miscellaneous:</h4><p>xmlCatalogCleanup() free-up the global catalog, xmlCatalogFreeLocal()
+isthe per-document equivalent.</p><p>xmlCatalogAdd() and xmlCatalogRemove() are used to dynamically modify
+thefirst catalog in the global list, and xmlCatalogDump() allows to dump
+acatalog state, those routines are primarily designed for xmlcatalog, I'm
+notsure that exposing more complex interfaces (like navigation ones) would
+bereally useful.</p><p>The xmlParseCatalogFile() is a function used to load XML Catalog
+files,it's similar as xmlParseFile() except it bypass all catalog lookups,
+it'sprovided because this functionality may be useful for client tools.</p><h4>threaded environments:</h4><p>Since the catalog tree is built progressively, some care has been taken
+totry to avoid troubles in multithreaded environments. The code is now
+threadsafe assuming that the libxml2 library has been compiled with
+threadssupport.</p><p></p><h3><a name="Other" id="Other">Other resources</a></h3><p>The XML Catalog specification is relatively recent so there isn't
+muchliterature to point at:</p><ul><li>You can find a good rant from Norm Walsh about <a href="http://www.arbortext.com/Think_Tank/XML_Resources/Issue_Three/issue_three.html">theneed
+ for catalogs</a>, it provides a lot of context informations even ifI
+ don't agree with everything presented. Norm also wrote a more
+ recentarticle <a href="http://wwws.sun.com/software/xml/developers/resolver/article/">XMLentities
+ and URI resolvers</a>describing them.</li>
+ <li>An <a href="http://home.ccil.org/~cowan/XML/XCatalog.html">old
+ XMLcatalog proposal</a>from John Cowan</li>
+ <li>The <a href="http://www.rddl.org/">Resource Directory
+ DescriptionLanguage</a>(RDDL) another catalog system but more oriented
+ towardproviding metadata for XML namespaces.</li>
+ <li>the page from the OASIS Technical <a href="http://www.oasis-open.org/committees/entity/">Committee on
+ EntityResolution</a>who maintains XML Catalog, you will find pointers to
+ thespecification update, some background and pointers to others
+ toolsproviding XML Catalog support</li>
+ <li>There is a <a href="buildDocBookCatalog">shell script</a>to generateXML
+ Catalogs for DocBook 4.1.2 . If it can write to the /etc/xml/directory,
+ it will set-up /etc/xml/catalog and /etc/xml/docbook based onthe
+ resources found on the system. Otherwise it will just create~/xmlcatalog
+ and ~/dbkxmlcatalog and doing:
<p><code>export XML_CATALOG_FILES=$HOME/xmlcatalog</code></p>
- <p>should allow to process DocBook documentations without requiring
- network accesses for the DTD or stylesheets</p>
+ <p>should allow to process DocBook documentations without
+ requiringnetwork accesses for the DTD or stylesheets</p>
</li>
- <li>I have uploaded <a href="ftp://xmlsoft.org/libxml2/test/dbk412catalog.tar.gz">a
- small tarball</a> containing XML Catalogs for DocBook 4.1.2 which seems
- to work fine for me too</li>
- <li>The <a href="http://www.xmlsoft.org/xmlcatalog_man.html">xmlcatalog
- manual page</a></li>
-</ul><p>If you have suggestions for corrections or additions, simply contact
-me:</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+ <li>I have uploaded <a href="ftp://xmlsoft.org/libxml2/test/dbk412catalog.tar.gz">asmall
+ tarball</a>containing XML Catalogs for DocBook 4.1.2 which seemsto work
+ fine for me too</li>
+ <li>The <a href="http://www.xmlsoft.org/xmlcatalog_man.html">xmlcatalogmanual
+ page</a></li>
+</ul><p>If you have suggestions for corrections or additions, simply contactme:</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/contribs.html b/doc/contribs.html
index e493eb3b..8f1abb3b 100644
--- a/doc/contribs.html
+++ b/doc/contribs.html
@@ -7,34 +7,33 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Contributions</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Contributions</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><ul><li>Bjorn Reese, William Brack and Thomas Broyer have provided a number of
- patches, Gary Pennington worked on the validation API, threading support
- and Solaris port.</li>
+</style><title>Contributions</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Contributions</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><ul><li>Bjorn Reese, William Brack and Thomas Broyer have provided a number
+ ofpatches, Gary Pennington worked on the validation API, threading
+ supportand Solaris port.</li>
<li>John Fleck helps maintaining the documentation and man pages.</li>
- <li><a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a> is now the
- maintainer of the Windows port, <a href="http://www.zlatkovic.com/projects/libxml/index.html">he provides
- binaries</a></li>
- <li><a href="mailto:Gary.Pennington@sun.com">Gary Pennington</a> provides
- <a href="http://garypennington.net/libxml2/">Solaris binaries</a></li>
- <li><a href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">Matt
- Sergeant</a> developed <a href="http://axkit.org/download/">XML::LibXSLT</a>, a Perl wrapper for
- libxml2/libxslt as part of the <a href="http://axkit.com/">AxKit XML
- application server</a></li>
- <li><a href="mailto:fnatter@gmx.net">Felix Natter</a> and <a href="mailto:geertk@ai.rug.nl">Geert Kloosterman</a> provide <a href="libxml-doc.el">an emacs module</a> to lookup libxml(2) functions
- documentation</li>
- <li><a href="mailto:sherwin@nlm.nih.gov">Ziying Sherwin</a> provided <a href="http://xmlsoft.org/messages/0488.html">man pages</a></li>
- <li>there is a module for <a href="http://acs-misc.sourceforge.net/nsxml.html">libxml/libxslt support
- in OpenNSD/AOLServer</a></li>
- <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a> provided the
- first version of libxml/libxslt <a href="http://www.rexx.com/~dkuhlman">wrappers for Python</a></li>
- <li>Petr Kozelka provides <a href="http://sourceforge.net/projects/libxml2-pas">Pascal units to glue
- libxml2</a> with Kylix and Delphi and other Pascal compilers</li>
- <li><a href="mailto:aleksey@aleksey.com">Aleksey Sanin</a> implemented the
- <a href="http://www.w3.org/Signature/">XML Canonicalization and XML
- Digital Signature</a> <a href="http://www.aleksey.com/xmlsec/">implementations for libxml2</a></li>
- <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a> and
- contributors maintain <a href="http://tclxml.sourceforge.net/">tcl
- bindings for libxml2 and libxslt</a>, as well as <a href="http://tclxml.sf.net/tkxmllint.html">tkxmllint</a> a GUI for
- xmllint and <a href="http://tclxml.sf.net/tkxsltproc.html">tkxsltproc</a>
- a GUI for xsltproc.</li>
+ <li><a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a>is now
+ themaintainer of the Windows port, <a href="http://www.zlatkovic.com/projects/libxml/index.html">he
+ providesbinaries</a></li>
+ <li><a href="mailto:Gary.Pennington@sun.com">Gary Pennington</a>provides<a href="http://garypennington.net/libxml2/">Solaris binaries</a></li>
+ <li><a href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">MattSergeant</a>developed
+ <a href="http://axkit.org/download/">XML::LibXSLT</a>, a Perl wrapper
+ forlibxml2/libxslt as part of the <a href="http://axkit.com/">AxKit
+ XMLapplication server</a></li>
+ <li><a href="mailto:fnatter@gmx.net">Felix Natter</a>and <a href="mailto:geertk@ai.rug.nl">Geert Kloosterman</a>provide <a href="libxml-doc.el">an emacs module</a>to lookup libxml(2)
+ functionsdocumentation</li>
+ <li><a href="mailto:sherwin@nlm.nih.gov">Ziying Sherwin</a>provided <a href="http://xmlsoft.org/messages/0488.html">man pages</a></li>
+ <li>there is a module for <a href="http://acs-misc.sourceforge.net/nsxml.html">libxml/libxslt
+ supportin OpenNSD/AOLServer</a></li>
+ <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a>provided
+ thefirst version of libxml/libxslt <a href="http://www.rexx.com/~dkuhlman">wrappers for Python</a></li>
+ <li>Petr Kozelka provides <a href="http://sourceforge.net/projects/libxml2-pas">Pascal units to
+ gluelibxml2</a>with Kylix and Delphi and other Pascal compilers</li>
+ <li><a href="mailto:aleksey@aleksey.com">Aleksey Sanin</a>implemented the<a href="http://www.w3.org/Signature/">XML Canonicalization and XMLDigital
+ Signature</a><a href="http://www.aleksey.com/xmlsec/">implementations for
+ libxml2</a></li>
+ <li><a href="mailto:Steve.Ball@explain.com.au">Steve
+ Ball</a>andcontributors maintain <a href="http://tclxml.sourceforge.net/">tclbindings for libxml2 and
+ libxslt</a>, as well as <a href="http://tclxml.sf.net/tkxmllint.html">tkxmllint</a>a GUI forxmllint
+ and <a href="http://tclxml.sf.net/tkxsltproc.html">tkxsltproc</a>a GUI
+ for xsltproc.</li>
</ul><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/devhelp/libxml2-xmlerror.html b/doc/devhelp/libxml2-xmlerror.html
index d0eb4770..7545da48 100644
--- a/doc/devhelp/libxml2-xmlerror.html
+++ b/doc/devhelp/libxml2-xmlerror.html
@@ -707,6 +707,7 @@ void <a href="#xmlResetError">xmlResetError</a> (<a href="libxml2-xmlerror.htm
<a name="XML_SCHEMAV_CVC_TYPE_2">XML_SCHEMAV_CVC_TYPE_2</a> = 1876 /* 1876 */
<a name="XML_SCHEMAV_CVC_IDC">XML_SCHEMAV_CVC_IDC</a> = 1877 /* 1877 */
<a name="XML_SCHEMAV_CVC_WILDCARD">XML_SCHEMAV_CVC_WILDCARD</a> = 1878 /* 1878 */
+ <a name="XML_SCHEMAV_MISC">XML_SCHEMAV_MISC</a> = 1879 /* 1879 */
<a name="XML_XPTR_UNKNOWN_SCHEME">XML_XPTR_UNKNOWN_SCHEME</a> = 1900
<a name="XML_XPTR_CHILDSEQ_START">XML_XPTR_CHILDSEQ_START</a> = 1901 /* 1901 */
<a name="XML_XPTR_EVAL_FAILED">XML_XPTR_EVAL_FAILED</a> = 1902 /* 1902 */
diff --git a/doc/devhelp/libxml2-xpath.html b/doc/devhelp/libxml2-xpath.html
index 4d1a4ccf..f3fe7a67 100644
--- a/doc/devhelp/libxml2-xpath.html
+++ b/doc/devhelp/libxml2-xpath.html
@@ -72,6 +72,7 @@ int <a href="#xmlXPathCastNodeSetToBoolean">xmlXPathCastNodeSetToBoolean</a> (<a
typedef <a href="libxml2-xpath.html#xmlXPathFunction">xmlXPathFunction</a> <a href="#xmlXPathFuncLookupFunc">xmlXPathFuncLookupFunc</a> (void * ctxt, <br/> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * ns_uri);
<a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * <a href="#xmlXPathCastNodeToString">xmlXPathCastNodeToString</a> (<a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> node);
int <a href="#xmlXPathIsNaN">xmlXPathIsNaN</a> (double val);
+int <a href="#xmlXPathContextSetCache">xmlXPathContextSetCache</a> (<a href="libxml2-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctxt, <br/> int active, <br/> int value, <br/> int options);
<a href="libxml2-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="#xmlXPathConvertString">xmlXPathConvertString</a> (<a href="libxml2-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
<a href="libxml2-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="#xmlXPathConvertBoolean">xmlXPathConvertBoolean</a> (<a href="libxml2-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
int <a href="#xmlXPathIsInf">xmlXPathIsInf</a> (double val);
@@ -209,7 +210,8 @@ The content of this structure is not made public by the API.
<a href="libxml2-xmlerror.html#xmlError">xmlError</a> lastError : the last error
<a href="libxml2-tree.html#xmlNodePtr">xmlNodePtr</a> debugNode : the source node XSLT dictionnary
<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict : dictionnary if any
- int flags : flags to control compilation
+ int flags : flags to control compilation Cache for reusal of XPath objects
+ void * cache
} xmlXPathContext;
</pre><p/>
</div>
@@ -436,6 +438,10 @@ The content of this structure is not made public by the API.
</pre><p>Evaluate the Precompiled XPath expression in the given context.</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>comp</tt></i>:</span></td><td>the compiled XPath expression</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td>the XPath context</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the <a href="libxml2-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> resulting from the evaluation or NULL. the caller has to free the object.</td></tr></tbody></table></div></div>
<hr/>
+ <div class="refsect2" lang="en"><h3><a name="xmlXPathContextSetCache"/>xmlXPathContextSetCache ()</h3><pre class="programlisting">int xmlXPathContextSetCache (<a href="libxml2-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctxt, <br/> int active, <br/> int value, <br/> int options)<br/>
+</pre><p>Creates/frees an object cache on the XPath context. If activates XPath objects (xmlXPathObject) will be cached internally to be reused. @options: 0: This will set the XPath object caching: @value: This will set the maximum number of XPath objects to be cached per slot There are 5 slots for: node-set, string, number, boolean, and misc objects. Use &lt;0 for the default number (100). Other values for @options have currently no effect.</p>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td>the XPath context</td></tr><tr><td><span class="term"><i><tt>active</tt></i>:</span></td><td>enables/disables (creates/frees) the cache</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td>a value with semantics dependant on @options</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td>options (currently only the value 0 is used)</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 if the setting succeeded, and -1 on API or internal errors.</td></tr></tbody></table></div></div>
+ <hr/>
<div class="refsect2" lang="en"><h3><a name="xmlXPathConvertBoolean"/>xmlXPathConvertBoolean ()</h3><pre class="programlisting"><a href="libxml2-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathConvertBoolean (<a href="libxml2-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val)<br/>
</pre><p>Converts an existing object to its boolean() equivalent</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td>an XPath object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the new object, the old one is freed (or the operation is done directly on @val)</td></tr></tbody></table></div></div>
diff --git a/doc/devhelp/libxml2.devhelp b/doc/devhelp/libxml2.devhelp
index ca79c03f..e0af8368 100644
--- a/doc/devhelp/libxml2.devhelp
+++ b/doc/devhelp/libxml2.devhelp
@@ -1297,6 +1297,7 @@
<function name="XML_SCHEMAV_INVALIDATTR" link="libxml2-xmlerror.html#XML_SCHEMAV_INVALIDATTR"/>
<function name="XML_SCHEMAV_INVALIDELEM" link="libxml2-xmlerror.html#XML_SCHEMAV_INVALIDELEM"/>
<function name="XML_SCHEMAV_ISABSTRACT" link="libxml2-xmlerror.html#XML_SCHEMAV_ISABSTRACT"/>
+ <function name="XML_SCHEMAV_MISC" link="libxml2-xmlerror.html#XML_SCHEMAV_MISC"/>
<function name="XML_SCHEMAV_MISSING" link="libxml2-xmlerror.html#XML_SCHEMAV_MISSING"/>
<function name="XML_SCHEMAV_NOROLLBACK" link="libxml2-xmlerror.html#XML_SCHEMAV_NOROLLBACK"/>
<function name="XML_SCHEMAV_NOROOT" link="libxml2-xmlerror.html#XML_SCHEMAV_NOROOT"/>
@@ -3320,6 +3321,7 @@
<function name="xmlXPathCompiledEval ()" link="libxml2-xpath.html#xmlXPathCompiledEval"/>
<function name="xmlXPathConcatFunction ()" link="libxml2-xpathInternals.html#xmlXPathConcatFunction"/>
<function name="xmlXPathContainsFunction ()" link="libxml2-xpathInternals.html#xmlXPathContainsFunction"/>
+ <function name="xmlXPathContextSetCache ()" link="libxml2-xpath.html#xmlXPathContextSetCache"/>
<function name="xmlXPathConvertBoolean ()" link="libxml2-xpath.html#xmlXPathConvertBoolean"/>
<function name="xmlXPathConvertNumber ()" link="libxml2-xpath.html#xmlXPathConvertNumber"/>
<function name="xmlXPathConvertString ()" link="libxml2-xpath.html#xmlXPathConvertString"/>
diff --git a/doc/docs.html b/doc/docs.html
index 4c5fe555..49b86d9a 100644
--- a/doc/docs.html
+++ b/doc/docs.html
@@ -7,27 +7,25 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Developer Menu</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Developer Menu</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>There are several on-line resources related to using libxml:</p><ol><li>Use the <a href="search.php">search engine</a> to look up
- information.</li>
+</style><title>Developer Menu</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Developer Menu</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>There are several on-line resources related to using libxml:</p><ol><li>Use the <a href="search.php">search engine</a>to look
+ upinformation.</li>
<li>Check the <a href="FAQ.html">FAQ.</a></li>
- <li>Check the <a href="http://xmlsoft.org/html/libxml-lib.html">extensive
- documentation</a> automatically extracted from code comments.</li>
- <li>Look at the documentation about <a href="encoding.html">libxml
- internationalization support</a>.</li>
- <li>This page provides a global overview and <a href="example.html">some
- examples</a> on how to use libxml.</li>
+ <li>Check the <a href="http://xmlsoft.org/html/libxml-lib.html">extensivedocumentation</a>automatically
+ extracted from code comments.</li>
+ <li>Look at the documentation about <a href="encoding.html">libxmlinternationalization support</a>.</li>
+ <li>This page provides a global overview and <a href="example.html">someexamples</a>on how to use libxml.</li>
<li><a href="examples/index.html">Code examples</a></li>
- <li>John Fleck's libxml2 tutorial: <a href="tutorial/index.html">html</a>
- or <a href="tutorial/xmltutorial.pdf">pdf</a>.</li>
- <li>If you need to parse large files, check the <a href="xmlreader.html">xmlReader</a> API tutorial</li>
- <li><a href="mailto:james@daa.com.au">James Henstridge</a> wrote <a href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">some nice
- documentation</a> explaining how to use the libxml SAX interface.</li>
- <li>George Lebl wrote <a href="http://www-106.ibm.com/developerworks/library/l-gnome3/">an article
- for IBM developerWorks</a> about using libxml.</li>
- <li>Check <a href="http://cvs.gnome.org/lxr/source/gnome-xml/TODO">the TODO
- file</a>.</li>
- <li>Read the <a href="upgrade.html">1.x to 2.x upgrade path</a>
- description. If you are starting a new project using libxml you should
- really use the 2.x version.</li>
+ <li>John Fleck's libxml2 tutorial: <a href="tutorial/index.html">html</a>or
+ <a href="tutorial/xmltutorial.pdf">pdf</a>.</li>
+ <li>If you need to parse large files, check the <a href="xmlreader.html">xmlReader</a>API tutorial</li>
+ <li><a href="mailto:james@daa.com.au">James Henstridge</a>wrote <a href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">some
+ nicedocumentation</a>explaining how to use the libxml SAX interface.</li>
+ <li>George Lebl wrote <a href="http://www-106.ibm.com/developerworks/library/l-gnome3/">an
+ articlefor IBM developerWorks</a>about using libxml.</li>
+ <li>Check <a href="http://cvs.gnome.org/lxr/source/gnome-xml/TODO">the
+ TODOfile</a>.</li>
+ <li>Read the <a href="upgrade.html">1.x to 2.x upgrade path</a>description.
+ If you are starting a new project using libxml you shouldreally use the
+ 2.x version.</li>
<li>And don't forget to look at the <a href="http://mail.gnome.org/archives/xml/">mailing-list archive</a>.</li>
</ol><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/downloads.html b/doc/downloads.html
index e49f4835..d12420eb 100644
--- a/doc/downloads.html
+++ b/doc/downloads.html
@@ -7,30 +7,30 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Downloads</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Downloads</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>The latest versions of libxml2 can be found on the <a href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a> server ( <a href="http://xmlsoft.org/sources/">HTTP</a>, <a href="ftp://xmlsoft.org/libxml2/">FTP</a> and rsync are available), there is also
-mirrors (<a href="ftp://ftp.planetmirror.com/pub/xmlsoft/">Australia</a>( <a href="http://xmlsoft.planetmirror.com/">Web</a>), <a href="ftp://fr.rpmfind.net/pub/libxml/">France</a>) or on the <a href="ftp://ftp.gnome.org/pub/GNOME/MIRRORS.html">Gnome FTP server</a> as <a href="ftp://ftp.gnome.org/pub/GNOME/sources/libxml2/2.6/">source archive</a>
-, Antonin Sprinzl also provide <a href="ftp://gd.tuwien.ac.at/pub/libxml/">a
-mirror in Austria</a>. (NOTE that you need both the <a href="http://rpmfind.net/linux/RPM/libxml2.html">libxml(2)</a> and <a href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml(2)-devel</a>
-packages installed to compile applications using libxml.)</p><p>You can find all the history of libxml(2) and libxslt releases in the <a href="http://xmlsoft.org/sources/old/">old</a> directory. The precompiled
-Windows binaries made by Igor Zlatovic are available in the <a href="http://xmlsoft.org/sources/win32/">win32</a> directory.</p><p>Binary ports:</p><ul><li>Red Hat RPMs for i386 are available directly on <a href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a>, the source RPM will compile on
- any architecture supported by Red Hat.</li>
- <li><a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a> is now the
- maintainer of the Windows port, <a href="http://www.zlatkovic.com/projects/libxml/index.html">he provides
- binaries</a>.</li>
- <li>Blastwave provides <a href="http://www.blastwave.org/packages.php/libxml2">Solaris
- binaries</a>.</li>
- <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a> provides <a href="http://www.explain.com.au/oss/libxml2xslt.html">Mac Os X
- binaries</a>.</li>
+</style><title>Downloads</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Downloads</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>The latest versions of libxml2 can be found on the <a href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a>server ( <a href="http://xmlsoft.org/sources/">HTTP</a>, <a href="ftp://xmlsoft.org/libxml2/">FTP</a>and rsync are available), there is
+alsomirrors (<a href="ftp://ftp.planetmirror.com/pub/xmlsoft/">Australia</a>(
+<a href="http://xmlsoft.planetmirror.com/">Web</a>), <a href="ftp://fr.rpmfind.net/pub/libxml/">France</a>) or on the <a href="ftp://ftp.gnome.org/pub/GNOME/MIRRORS.html">Gnome FTP server</a>as <a href="ftp://ftp.gnome.org/pub/GNOME/sources/libxml2/2.6/">source archive</a>,
+Antonin Sprinzl also provide <a href="ftp://gd.tuwien.ac.at/pub/libxml/">amirror in Austria</a>. (NOTE that
+you need both the <a href="http://rpmfind.net/linux/RPM/libxml2.html">libxml(2)</a>and <a href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml(2)-devel</a>packages
+installed to compile applications using libxml.)</p><p>You can find all the history of libxml(2) and libxslt releases in the <a href="http://xmlsoft.org/sources/old/">old</a>directory. The
+precompiledWindows binaries made by Igor Zlatovic are available in the <a href="http://xmlsoft.org/sources/win32/">win32</a>directory.</p><p>Binary ports:</p><ul><li>Red Hat RPMs for i386 are available directly on <a href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a>, the source RPM will
+ compile onany architecture supported by Red Hat.</li>
+ <li><a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a>is now
+ themaintainer of the Windows port, <a href="http://www.zlatkovic.com/projects/libxml/index.html">he
+ providesbinaries</a>.</li>
+ <li>Blastwave provides <a href="http://www.blastwave.org/packages.php/libxml2">Solarisbinaries</a>.</li>
+ <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a>provides <a href="http://www.explain.com.au/oss/libxml2xslt.html">Mac Os
+ Xbinaries</a>.</li>
<li>The HP-UX porting center provides <a href="http://hpux.connect.org.uk/hppd/hpux/Gnome/">HP-UX binaries</a></li>
- <li>Bull provides precompiled <a href="http://gnome.bullfreeware.com/new_index.html">RPMs for AIX</a> as
- patr of their GNOME packages</li>
+ <li>Bull provides precompiled <a href="http://gnome.bullfreeware.com/new_index.html">RPMs for
+ AIX</a>aspatr of their GNOME packages</li>
</ul><p>If you know other supported binary ports, please <a href="http://veillard.com/">contact me</a>.</p><p><a name="Snapshot" id="Snapshot">Snapshot:</a></p><ul><li>Code from the W3C cvs base libxml2 module, updated hourly <a href="ftp://xmlsoft.org/libxml2/libxml2-cvs-snapshot.tar.gz">libxml2-cvs-snapshot.tar.gz</a>.</li>
<li>Docs, content of the web site, the list archive included <a href="ftp://xmlsoft.org/libxml2/libxml-docs.tar.gz">libxml-docs.tar.gz</a>.</li>
-</ul><p><a name="Contribs" id="Contribs">Contributions:</a></p><p>I do accept external contributions, especially if compiling on another
-platform, get in touch with the list to upload the package, wrappers for
-various languages have been provided, and can be found in the <a href="python.html">bindings section</a></p><p>Libxml2 is also available from CVS:</p><ul><li><p>The <a href="http://cvs.gnome.org/viewcvs/libxml2/">Gnome CVS
- base</a>. Check the <a href="http://developer.gnome.org/tools/cvs.html">Gnome CVS Tools</a>
- page; the CVS module is <b>libxml2</b>.</p>
+</ul><p><a name="Contribs" id="Contribs">Contributions:</a></p><p>I do accept external contributions, especially if compiling on
+anotherplatform, get in touch with the list to upload the package, wrappers
+forvarious languages have been provided, and can be found in the <a href="python.html">bindings section</a></p><p>Libxml2 is also available from CVS:</p><ul><li><p>The <a href="http://cvs.gnome.org/viewcvs/libxml2/">Gnome
+ CVSbase</a>. Check the <a href="http://developer.gnome.org/tools/cvs.html">Gnome CVS Tools</a>page;
+ the CVS module is <b>libxml2</b>.</p>
</li>
- <li>The <strong>libxslt</strong> module is also present there</li>
+ <li>The <strong>libxslt</strong>module is also present there</li>
</ul><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/encoding.html b/doc/encoding.html
index 1f4558d4..4b6d0d47 100644
--- a/doc/encoding.html
+++ b/doc/encoding.html
@@ -7,44 +7,44 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Encodings support</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Encodings support</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>If you are not really familiar with Internationalization (usual shortcut
-is I18N) , Unicode, characters and glyphs, I suggest you read a <a href="http://www.tbray.org/ongoing/When/200x/2003/04/06/Unicode">presentation</a>
-by Tim Bray on Unicode and why you should care about it.</p><p>If you don't understand why <b>it does not make sense to have a string
-without knowing what encoding it uses</b>, then as Joel Spolsky said <a href="http://www.joelonsoftware.com/articles/Unicode.html">please do not
-write another line of code until you finish reading that article.</a>. It is
-a prerequisite to understand this page, and avoid a lot of problems with
-libxml2, XML or text processing in general.</p><p>Table of Content:</p><ol><li><a href="encoding.html#What">What does internationalization support
- mean ?</a></li>
- <li><a href="encoding.html#internal">The internal encoding, how and
- why</a></li>
+</style><title>Encodings support</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Encodings support</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>If you are not really familiar with Internationalization (usual shortcutis
+I18N) , Unicode, characters and glyphs, I suggest you read a <a href="http://www.tbray.org/ongoing/When/200x/2003/04/06/Unicode">presentation</a>by
+Tim Bray on Unicode and why you should care about it.</p><p>If you don't understand why <b>it does not make sense to have a
+stringwithout knowing what encoding it uses</b>, then as Joel Spolsky said <a href="http://www.joelonsoftware.com/articles/Unicode.html">please do notwrite
+another line of code until you finish reading that article.</a>. It isa
+prerequisite to understand this page, and avoid a lot of problems
+withlibxml2, XML or text processing in general.</p><p>Table of Content:</p><ol><li><a href="encoding.html#What">What does internationalization supportmean
+ ?</a></li>
+ <li><a href="encoding.html#internal">The internal encoding, how
+ andwhy</a></li>
<li><a href="encoding.html#implemente">How is it implemented ?</a></li>
<li><a href="encoding.html#Default">Default supported encodings</a></li>
- <li><a href="encoding.html#extend">How to extend the existing
- support</a></li>
-</ol><h3><a name="What" id="What">What does internationalization support mean ?</a></h3><p>XML was designed from the start to allow the support of any character set
-by using Unicode. Any conformant XML parser has to support the UTF-8 and
-UTF-16 default encodings which can both express the full unicode ranges. UTF8
-is a variable length encoding whose greatest points are to reuse the same
-encoding for ASCII and to save space for Western encodings, but it is a bit
-more complex to handle in practice. UTF-16 use 2 bytes per character (and
-sometimes combines two pairs), it makes implementation easier, but looks a
-bit overkill for Western languages encoding. Moreover the XML specification
-allows the document to be encoded in other encodings at the condition that
-they are clearly labeled as such. For example the following is a wellformed
-XML document encoded in ISO-8859-1 and using accentuated letters that we
-French like for both markup and content:</p><pre>&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;
+ <li><a href="encoding.html#extend">How to extend the
+ existingsupport</a></li>
+</ol><h3><a name="What" id="What">What does internationalization support mean ?</a></h3><p>XML was designed from the start to allow the support of any character
+setby using Unicode. Any conformant XML parser has to support the UTF-8
+andUTF-16 default encodings which can both express the full unicode ranges.
+UTF8is a variable length encoding whose greatest points are to reuse the
+sameencoding for ASCII and to save space for Western encodings, but it is a
+bitmore complex to handle in practice. UTF-16 use 2 bytes per character
+(andsometimes combines two pairs), it makes implementation easier, but looks
+abit overkill for Western languages encoding. Moreover the XML
+specificationallows the document to be encoded in other encodings at the
+condition thatthey are clearly labeled as such. For example the following is
+a wellformedXML document encoded in ISO-8859-1 and using accentuated letters
+that weFrench like for both markup and content:</p><pre>&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;
&lt;très&gt;là&lt;/très&gt;</pre><p>Having internationalization support in libxml2 means the following:</p><ul><li>the document is properly parsed</li>
<li>informations about it's encoding are saved</li>
<li>it can be modified</li>
<li>it can be saved in its original encoding</li>
- <li>it can also be saved in another encoding supported by libxml2 (for
- example straight UTF8 or even an ASCII form)</li>
-</ul><p>Another very important point is that the whole libxml2 API, with the
-exception of a few routines to read with a specific encoding or save to a
-specific encoding, is completely agnostic about the original encoding of the
-document.</p><p>It should be noted too that the HTML parser embedded in libxml2 now obey
-the same rules too, the following document will be (as of 2.2.2) handled in
-an internationalized fashion by libxml2 too:</p><pre>&lt;!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
+ <li>it can also be saved in another encoding supported by libxml2
+ (forexample straight UTF8 or even an ASCII form)</li>
+</ul><p>Another very important point is that the whole libxml2 API, with
+theexception of a few routines to read with a specific encoding or save to
+aspecific encoding, is completely agnostic about the original encoding of
+thedocument.</p><p>It should be noted too that the HTML parser embedded in libxml2 now
+obeythe same rules too, the following document will be (as of 2.2.2) handled
+inan internationalized fashion by libxml2 too:</p><pre>&lt;!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd"&gt;
&lt;html lang="fr"&gt;
&lt;head&gt;
@@ -52,59 +52,60 @@ an internationalized fashion by libxml2 too:</p><pre>&lt;!DOCTYPE HTML PUBLIC "-
&lt;/head&gt;
&lt;body&gt;
&lt;p&gt;W3C crée des standards pour le Web.&lt;/body&gt;
-&lt;/html&gt;</pre><h3><a name="internal" id="internal">The internal encoding, how and why</a></h3><p>One of the core decisions was to force all documents to be converted to a
-default internal encoding, and that encoding to be UTF-8, here are the
-rationales for those choices:</p><ul><li>keeping the native encoding in the internal form would force the libxml
- users (or the code associated) to be fully aware of the encoding of the
- original document, for examples when adding a text node to a document,
- the content would have to be provided in the document encoding, i.e. the
- client code would have to check it before hand, make sure it's conformant
- to the encoding, etc ... Very hard in practice, though in some specific
- cases this may make sense.</li>
- <li>the second decision was which encoding. From the XML spec only UTF8 and
- UTF16 really makes sense as being the two only encodings for which there
- is mandatory support. UCS-4 (32 bits fixed size encoding) could be
- considered an intelligent choice too since it's a direct Unicode mapping
- support. I selected UTF-8 on the basis of efficiency and compatibility
- with surrounding software:
- <ul><li>UTF-8 while a bit more complex to convert from/to (i.e. slightly
- more costly to import and export CPU wise) is also far more compact
- than UTF-16 (and UCS-4) for a majority of the documents I see it used
- for right now (RPM RDF catalogs, advogato data, various configuration
- file formats, etc.) and the key point for today's computer
- architecture is efficient uses of caches. If one nearly double the
- memory requirement to store the same amount of data, this will trash
- caches (main memory/external caches/internal caches) and my take is
- that this harms the system far more than the CPU requirements needed
- for the conversion to UTF-8</li>
- <li>Most of libxml2 version 1 users were using it with straight ASCII
- most of the time, doing the conversion with an internal encoding
- requiring all their code to be rewritten was a serious show-stopper
- for using UTF-16 or UCS-4.</li>
- <li>UTF-8 is being used as the de-facto internal encoding standard for
- related code like the <a href="http://www.pango.org/">pango</a>
- upcoming Gnome text widget, and a lot of Unix code (yet another place
- where Unix programmer base takes a different approach from Microsoft
- - they are using UTF-16)</li>
+&lt;/html&gt;</pre><h3><a name="internal" id="internal">The internal encoding, how and why</a></h3><p>One of the core decisions was to force all documents to be converted to
+adefault internal encoding, and that encoding to be UTF-8, here are
+therationales for those choices:</p><ul><li>keeping the native encoding in the internal form would force the
+ libxmlusers (or the code associated) to be fully aware of the encoding of
+ theoriginal document, for examples when adding a text node to a
+ document,the content would have to be provided in the document encoding,
+ i.e. theclient code would have to check it before hand, make sure it's
+ conformantto the encoding, etc ... Very hard in practice, though in some
+ specificcases this may make sense.</li>
+ <li>the second decision was which encoding. From the XML spec only UTF8
+ andUTF16 really makes sense as being the two only encodings for which
+ thereis mandatory support. UCS-4 (32 bits fixed size encoding) could
+ beconsidered an intelligent choice too since it's a direct Unicode
+ mappingsupport. I selected UTF-8 on the basis of efficiency and
+ compatibilitywith surrounding software:
+ <ul><li>UTF-8 while a bit more complex to convert from/to (i.e.
+ slightlymore costly to import and export CPU wise) is also far more
+ compactthan UTF-16 (and UCS-4) for a majority of the documents I see
+ it usedfor right now (RPM RDF catalogs, advogato data, various
+ configurationfile formats, etc.) and the key point for today's
+ computerarchitecture is efficient uses of caches. If one nearly
+ double thememory requirement to store the same amount of data, this
+ will trashcaches (main memory/external caches/internal caches) and my
+ take isthat this harms the system far more than the CPU requirements
+ neededfor the conversion to UTF-8</li>
+ <li>Most of libxml2 version 1 users were using it with straight
+ ASCIImost of the time, doing the conversion with an internal
+ encodingrequiring all their code to be rewritten was a serious
+ show-stopperfor using UTF-16 or UCS-4.</li>
+ <li>UTF-8 is being used as the de-facto internal encoding standard
+ forrelated code like the <a href="http://www.pango.org/">pango</a>upcoming Gnome text widget, and
+ a lot of Unix code (yet another placewhere Unix programmer base takes
+ a different approach from Microsoft- they are using UTF-16)</li>
</ul></li>
-</ul><p>What does this mean in practice for the libxml2 user:</p><ul><li>xmlChar, the libxml2 data type is a byte, those bytes must be assembled
- as UTF-8 valid strings. The proper way to terminate an xmlChar * string
- is simply to append 0 byte, as usual.</li>
- <li>One just need to make sure that when using chars outside the ASCII set,
- the values has been properly converted to UTF-8</li>
-</ul><h3><a name="implemente" id="implemente">How is it implemented ?</a></h3><p>Let's describe how all this works within libxml, basically the I18N
-(internationalization) support get triggered only during I/O operation, i.e.
-when reading a document or saving one. Let's look first at the reading
-sequence:</p><ol><li>when a document is processed, we usually don't know the encoding, a
- simple heuristic allows to detect UTF-16 and UCS-4 from encodings where
- the ASCII range (0-0x7F) maps with ASCII</li>
- <li>the xml declaration if available is parsed, including the encoding
- declaration. At that point, if the autodetected encoding is different
- from the one declared a call to xmlSwitchEncoding() is issued.</li>
- <li>If there is no encoding declaration, then the input has to be in either
- UTF-8 or UTF-16, if it is not then at some point when processing the
- input, the converter/checker of UTF-8 form will raise an encoding error.
- You may end-up with a garbled document, or no document at all ! Example:
+</ul><p>What does this mean in practice for the libxml2 user:</p><ul><li>xmlChar, the libxml2 data type is a byte, those bytes must be
+ assembledas UTF-8 valid strings. The proper way to terminate an xmlChar *
+ stringis simply to append 0 byte, as usual.</li>
+ <li>One just need to make sure that when using chars outside the ASCII
+ set,the values has been properly converted to UTF-8</li>
+</ul><h3><a name="implemente" id="implemente">How is it implemented ?</a></h3><p>Let's describe how all this works within libxml, basically the
+I18N(internationalization) support get triggered only during I/O operation,
+i.e.when reading a document or saving one. Let's look first at the
+readingsequence:</p><ol><li>when a document is processed, we usually don't know the encoding,
+ asimple heuristic allows to detect UTF-16 and UCS-4 from encodings
+ wherethe ASCII range (0-0x7F) maps with ASCII</li>
+ <li>the xml declaration if available is parsed, including the
+ encodingdeclaration. At that point, if the autodetected encoding is
+ differentfrom the one declared a call to xmlSwitchEncoding() is
+ issued.</li>
+ <li>If there is no encoding declaration, then the input has to be in
+ eitherUTF-8 or UTF-16, if it is not then at some point when processing
+ theinput, the converter/checker of UTF-8 form will raise an encoding
+ error.You may end-up with a garbled document, or no document at all !
+ Example:
<pre>~/XML -&gt; ./xmllint err.xml
err.xml:1: error: Input is not proper UTF-8, indicate encoding !
&lt;très&gt;là&lt;/très&gt;
@@ -113,94 +114,94 @@ err.xml:1: error: Bytes: 0xE8 0x73 0x3E 0x6C
&lt;très&gt;là&lt;/très&gt;
^</pre>
</li>
- <li>xmlSwitchEncoding() does an encoding name lookup, canonicalize it, and
- then search the default registered encoding converters for that encoding.
- If it's not within the default set and iconv() support has been compiled
- it, it will ask iconv for such an encoder. If this fails then the parser
- will report an error and stops processing:
+ <li>xmlSwitchEncoding() does an encoding name lookup, canonicalize it,
+ andthen search the default registered encoding converters for that
+ encoding.If it's not within the default set and iconv() support has been
+ compiledit, it will ask iconv for such an encoder. If this fails then the
+ parserwill report an error and stops processing:
<pre>~/XML -&gt; ./xmllint err2.xml
err2.xml:1: error: Unsupported encoding UnsupportedEnc
&lt;?xml version="1.0" encoding="UnsupportedEnc"?&gt;
^</pre>
</li>
- <li>From that point the encoder processes progressively the input (it is
- plugged as a front-end to the I/O module) for that entity. It captures
- and converts on-the-fly the document to be parsed to UTF-8. The parser
- itself just does UTF-8 checking of this input and process it
- transparently. The only difference is that the encoding information has
- been added to the parsing context (more precisely to the input
- corresponding to this entity).</li>
- <li>The result (when using DOM) is an internal form completely in UTF-8
- with just an encoding information on the document node.</li>
-</ol><p>Ok then what happens when saving the document (assuming you
-collected/built an xmlDoc DOM like structure) ? It depends on the function
-called, xmlSaveFile() will just try to save in the original encoding, while
-xmlSaveFileTo() and xmlSaveFileEnc() can optionally save to a given
-encoding:</p><ol><li>if no encoding is given, libxml2 will look for an encoding value
- associated to the document and if it exists will try to save to that
- encoding,
+ <li>From that point the encoder processes progressively the input (it
+ isplugged as a front-end to the I/O module) for that entity. It
+ capturesand converts on-the-fly the document to be parsed to UTF-8. The
+ parseritself just does UTF-8 checking of this input and process
+ ittransparently. The only difference is that the encoding information
+ hasbeen added to the parsing context (more precisely to the
+ inputcorresponding to this entity).</li>
+ <li>The result (when using DOM) is an internal form completely in UTF-8with
+ just an encoding information on the document node.</li>
+</ol><p>Ok then what happens when saving the document (assuming youcollected/built
+an xmlDoc DOM like structure) ? It depends on the functioncalled,
+xmlSaveFile() will just try to save in the original encoding,
+whilexmlSaveFileTo() and xmlSaveFileEnc() can optionally save to a
+givenencoding:</p><ol><li>if no encoding is given, libxml2 will look for an encoding
+ valueassociated to the document and if it exists will try to save to
+ thatencoding,
<p>otherwise everything is written in the internal form, i.e. UTF-8</p>
</li>
- <li>so if an encoding was specified, either at the API level or on the
- document, libxml2 will again canonicalize the encoding name, lookup for a
- converter in the registered set or through iconv. If not found the
- function will return an error code</li>
- <li>the converter is placed before the I/O buffer layer, as another kind of
- buffer, then libxml2 will simply push the UTF-8 serialization to through
- that buffer, which will then progressively be converted and pushed onto
- the I/O layer.</li>
- <li>It is possible that the converter code fails on some input, for example
- trying to push an UTF-8 encoded Chinese character through the UTF-8 to
- ISO-8859-1 converter won't work. Since the encoders are progressive they
- will just report the error and the number of bytes converted, at that
- point libxml2 will decode the offending character, remove it from the
- buffer and replace it with the associated charRef encoding &amp;#123; and
- resume the conversion. This guarantees that any document will be saved
- without losses (except for markup names where this is not legal, this is
- a problem in the current version, in practice avoid using non-ascii
- characters for tag or attribute names). A special "ascii" encoding name
- is used to save documents to a pure ascii form can be used when
- portability is really crucial</li>
+ <li>so if an encoding was specified, either at the API level or on
+ thedocument, libxml2 will again canonicalize the encoding name, lookup
+ for aconverter in the registered set or through iconv. If not found
+ thefunction will return an error code</li>
+ <li>the converter is placed before the I/O buffer layer, as another kind
+ ofbuffer, then libxml2 will simply push the UTF-8 serialization to
+ throughthat buffer, which will then progressively be converted and pushed
+ ontothe I/O layer.</li>
+ <li>It is possible that the converter code fails on some input, for
+ exampletrying to push an UTF-8 encoded Chinese character through the
+ UTF-8 toISO-8859-1 converter won't work. Since the encoders are
+ progressive theywill just report the error and the number of bytes
+ converted, at thatpoint libxml2 will decode the offending character,
+ remove it from thebuffer and replace it with the associated charRef
+ encoding &amp;#123; andresume the conversion. This guarantees that any
+ document will be savedwithout losses (except for markup names where this
+ is not legal, this isa problem in the current version, in practice avoid
+ using non-asciicharacters for tag or attribute names). A special "ascii"
+ encoding nameis used to save documents to a pure ascii form can be used
+ whenportability is really crucial</li>
</ol><p>Here are a few examples based on the same test document:</p><pre>~/XML -&gt; ./xmllint isolat1
&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;
&lt;très&gt;là&lt;/très&gt;
~/XML -&gt; ./xmllint --encode UTF-8 isolat1
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;très&gt;là  &lt;/très&gt;
-~/XML -&gt; </pre><p>The same processing is applied (and reuse most of the code) for HTML I18N
-processing. Looking up and modifying the content encoding is a bit more
-difficult since it is located in a &lt;meta&gt; tag under the &lt;head&gt;,
-so a couple of functions htmlGetMetaEncoding() and htmlSetMetaEncoding() have
-been provided. The parser also attempts to switch encoding on the fly when
-detecting such a tag on input. Except for that the processing is the same
-(and again reuses the same code).</p><h3><a name="Default" id="Default">Default supported encodings</a></h3><p>libxml2 has a set of default converters for the following encodings
-(located in encoding.c):</p><ol><li>UTF-8 is supported by default (null handlers)</li>
+~/XML -&gt; </pre><p>The same processing is applied (and reuse most of the code) for HTML
+I18Nprocessing. Looking up and modifying the content encoding is a bit
+moredifficult since it is located in a &lt;meta&gt; tag under the
+&lt;head&gt;,so a couple of functions htmlGetMetaEncoding() and
+htmlSetMetaEncoding() havebeen provided. The parser also attempts to switch
+encoding on the fly whendetecting such a tag on input. Except for that the
+processing is the same(and again reuses the same code).</p><h3><a name="Default" id="Default">Default supported encodings</a></h3><p>libxml2 has a set of default converters for the following
+encodings(located in encoding.c):</p><ol><li>UTF-8 is supported by default (null handlers)</li>
<li>UTF-16, both little and big endian</li>
<li>ISO-Latin-1 (ISO-8859-1) covering most western languages</li>
<li>ASCII, useful mostly for saving</li>
- <li>HTML, a specific handler for the conversion of UTF-8 to ASCII with HTML
- predefined entities like &amp;copy; for the Copyright sign.</li>
-</ol><p>More over when compiled on an Unix platform with iconv support the full
-set of encodings supported by iconv can be instantly be used by libxml. On a
-linux machine with glibc-2.1 the list of supported encodings and aliases fill
-3 full pages, and include UCS-4, the full set of ISO-Latin encodings, and the
-various Japanese ones.</p><p>To convert from the UTF-8 values returned from the API to another encoding
-then it is possible to use the function provided from <a href="html/libxml-encoding.html">the encoding module</a> like <a href="html/libxml-encoding.html#UTF8Toisolat1">UTF8Toisolat1</a>, or use the
-POSIX <a href="http://www.opengroup.org/onlinepubs/009695399/functions/iconv.html">iconv()</a>
-API directly.</p><h4>Encoding aliases</h4><p>From 2.2.3, libxml2 has support to register encoding names aliases. The
-goal is to be able to parse document whose encoding is supported but where
-the name differs (for example from the default set of names accepted by
-iconv). The following functions allow to register and handle new aliases for
-existing encodings. Once registered libxml2 will automatically lookup the
-aliases when handling a document:</p><ul><li>int xmlAddEncodingAlias(const char *name, const char *alias);</li>
+ <li>HTML, a specific handler for the conversion of UTF-8 to ASCII with
+ HTMLpredefined entities like &amp;copy; for the Copyright sign.</li>
+</ol><p>More over when compiled on an Unix platform with iconv support the fullset
+of encodings supported by iconv can be instantly be used by libxml. On alinux
+machine with glibc-2.1 the list of supported encodings and aliases fill3 full
+pages, and include UCS-4, the full set of ISO-Latin encodings, and thevarious
+Japanese ones.</p><p>To convert from the UTF-8 values returned from the API to another
+encodingthen it is possible to use the function provided from <a href="html/libxml-encoding.html">the encoding module</a>like <a href="html/libxml-encoding.html#UTF8Toisolat1">UTF8Toisolat1</a>, or use
+thePOSIX <a href="http://www.opengroup.org/onlinepubs/009695399/functions/iconv.html">iconv()</a>API
+directly.</p><h4>Encoding aliases</h4><p>From 2.2.3, libxml2 has support to register encoding names aliases.
+Thegoal is to be able to parse document whose encoding is supported but
+wherethe name differs (for example from the default set of names accepted
+byiconv). The following functions allow to register and handle new aliases
+forexisting encodings. Once registered libxml2 will automatically lookup
+thealiases when handling a document:</p><ul><li>int xmlAddEncodingAlias(const char *name, const char *alias);</li>
<li>int xmlDelEncodingAlias(const char *alias);</li>
<li>const char * xmlGetEncodingAlias(const char *alias);</li>
<li>void xmlCleanupEncodingAliases(void);</li>
-</ul><h3><a name="extend" id="extend">How to extend the existing support</a></h3><p>Well adding support for new encoding, or overriding one of the encoders
-(assuming it is buggy) should not be hard, just write input and output
-conversion routines to/from UTF-8, and register them using
-xmlNewCharEncodingHandler(name, xxxToUTF8, UTF8Toxxx), and they will be
-called automatically if the parser(s) encounter such an encoding name
-(register it uppercase, this will help). The description of the encoders,
-their arguments and expected return values are described in the encoding.h
-header.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+</ul><h3><a name="extend" id="extend">How to extend the existing support</a></h3><p>Well adding support for new encoding, or overriding one of the
+encoders(assuming it is buggy) should not be hard, just write input and
+outputconversion routines to/from UTF-8, and register them
+usingxmlNewCharEncodingHandler(name, xxxToUTF8, UTF8Toxxx), and they will
+becalled automatically if the parser(s) encounter such an encoding
+name(register it uppercase, this will help). The description of the
+encoders,their arguments and expected return values are described in the
+encoding.hheader.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/entities.html b/doc/entities.html
index c234b41e..413dccef 100644
--- a/doc/entities.html
+++ b/doc/entities.html
@@ -7,34 +7,35 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Entities or no entities</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Entities or no entities</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Entities in principle are similar to simple C macros. An entity defines an
-abbreviation for a given string that you can reuse many times throughout the
-content of your document. Entities are especially useful when a given string
-may occur frequently within a document, or to confine the change needed to a
-document to a restricted area in the internal subset of the document (at the
-beginning). Example:</p><pre>1 &lt;?xml version="1.0"?&gt;
+</style><title>Entities or no entities</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Entities or no entities</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Entities in principle are similar to simple C macros. An entity defines
+anabbreviation for a given string that you can reuse many times throughout
+thecontent of your document. Entities are especially useful when a given
+stringmay occur frequently within a document, or to confine the change needed
+to adocument to a restricted area in the internal subset of the document (at
+thebeginning). Example:</p><pre>1 &lt;?xml version="1.0"?&gt;
2 &lt;!DOCTYPE EXAMPLE SYSTEM "example.dtd" [
3 &lt;!ENTITY xml "Extensible Markup Language"&gt;
4 ]&gt;
5 &lt;EXAMPLE&gt;
6 &amp;xml;
-7 &lt;/EXAMPLE&gt;</pre><p>Line 3 declares the xml entity. Line 6 uses the xml entity, by prefixing
-its name with '&amp;' and following it by ';' without any spaces added. There
-are 5 predefined entities in libxml2 allowing you to escape characters with
-predefined meaning in some parts of the xml document content:
-<strong>&amp;lt;</strong> for the character '&lt;', <strong>&amp;gt;</strong>
-for the character '&gt;', <strong>&amp;apos;</strong> for the character ''',
-<strong>&amp;quot;</strong> for the character '"', and
-<strong>&amp;amp;</strong> for the character '&amp;'.</p><p>One of the problems related to entities is that you may want the parser to
-substitute an entity's content so that you can see the replacement text in
-your application. Or you may prefer to keep entity references as such in the
-content to be able to save the document back without losing this usually
-precious information (if the user went through the pain of explicitly
-defining entities, he may have a a rather negative attitude if you blindly
-substitute them as saving time). The <a href="html/libxml-parser.html#xmlSubstituteEntitiesDefault">xmlSubstituteEntitiesDefault()</a>
-function allows you to check and change the behaviour, which is to not
-substitute entities by default.</p><p>Here is the DOM tree built by libxml2 for the previous document in the
-default case:</p><pre>/gnome/src/gnome-xml -&gt; ./xmllint --debug test/ent1
+7 &lt;/EXAMPLE&gt;</pre><p>Line 3 declares the xml entity. Line 6 uses the xml entity, by
+prefixingits name with '&amp;' and following it by ';' without any spaces
+added. Thereare 5 predefined entities in libxml2 allowing you to escape
+characters withpredefined meaning in some parts of the xml document
+content:<strong>&amp;lt;</strong>for the character '&lt;',
+<strong>&amp;gt;</strong>for the character '&gt;',
+<strong>&amp;apos;</strong>for the character
+''',<strong>&amp;quot;</strong>for the character '"',
+and<strong>&amp;amp;</strong>for the character '&amp;'.</p><p>One of the problems related to entities is that you may want the parser
+tosubstitute an entity's content so that you can see the replacement text
+inyour application. Or you may prefer to keep entity references as such in
+thecontent to be able to save the document back without losing this
+usuallyprecious information (if the user went through the pain of
+explicitlydefining entities, he may have a a rather negative attitude if you
+blindlysubstitute them as saving time). The <a href="html/libxml-parser.html#xmlSubstituteEntitiesDefault">xmlSubstituteEntitiesDefault()</a>function
+allows you to check and change the behaviour, which is to notsubstitute
+entities by default.</p><p>Here is the DOM tree built by libxml2 for the previous document in
+thedefault case:</p><pre>/gnome/src/gnome-xml -&gt; ./xmllint --debug test/ent1
DOCUMENT
version=1.0
ELEMENT EXAMPLE
@@ -49,16 +50,16 @@ DOCUMENT
version=1.0
ELEMENT EXAMPLE
TEXT
- content= Extensible Markup Language</pre><p>So, entities or no entities? Basically, it depends on your use case. I
-suggest that you keep the non-substituting default behaviour and avoid using
-entities in your XML document or data if you are not willing to handle the
-entity references elements in the DOM tree.</p><p>Note that at save time libxml2 enforces the conversion of the predefined
-entities where necessary to prevent well-formedness problems, and will also
-transparently replace those with chars (i.e. it will not generate entity
-reference elements in the DOM tree or call the reference() SAX callback when
-finding them in the input).</p><p><span style="background-color: #FF0000">WARNING</span>: handling entities
-on top of the libxml2 SAX interface is difficult!!! If you plan to use
-non-predefined entities in your documents, then the learning curve to handle
-then using the SAX API may be long. If you plan to use complex documents, I
-strongly suggest you consider using the DOM interface instead and let libxml
-deal with the complexity rather than trying to do it yourself.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+ content= Extensible Markup Language</pre><p>So, entities or no entities? Basically, it depends on your use case.
+Isuggest that you keep the non-substituting default behaviour and avoid
+usingentities in your XML document or data if you are not willing to handle
+theentity references elements in the DOM tree.</p><p>Note that at save time libxml2 enforces the conversion of the
+predefinedentities where necessary to prevent well-formedness problems, and
+will alsotransparently replace those with chars (i.e. it will not generate
+entityreference elements in the DOM tree or call the reference() SAX callback
+whenfinding them in the input).</p><p><span style="background-color: #FF0000">WARNING</span>: handling
+entitieson top of the libxml2 SAX interface is difficult!!! If you plan to
+usenon-predefined entities in your documents, then the learning curve to
+handlethen using the SAX API may be long. If you plan to use complex
+documents, Istrongly suggest you consider using the DOM interface instead and
+let libxmldeal with the complexity rather than trying to do it yourself.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/example.html b/doc/example.html
index 894f03ad..37883aba 100644
--- a/doc/example.html
+++ b/doc/example.html
@@ -7,11 +7,11 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>A real example</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>A real example</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Here is a real size example, where the actual content of the application
-data is not kept in the DOM tree but uses internal structures. It is based on
-a proposal to keep a database of jobs related to Gnome, with an XML based
-storage structure. Here is an <a href="gjobs.xml">XML encoded jobs
-base</a>:</p><pre>&lt;?xml version="1.0"?&gt;
+</style><title>A real example</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>A real example</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Here is a real size example, where the actual content of the
+applicationdata is not kept in the DOM tree but uses internal structures. It
+is based ona proposal to keep a database of jobs related to Gnome, with an
+XML basedstorage structure. Here is an <a href="gjobs.xml">XML encoded
+jobsbase</a>:</p><pre>&lt;?xml version="1.0"?&gt;
&lt;gjob:Helping xmlns:gjob="http://www.gnome.org/some-location"&gt;
&lt;gjob:Jobs&gt;
@@ -66,13 +66,14 @@ base</a>:</p><pre>&lt;?xml version="1.0"?&gt;
&lt;/gjob:Job&gt;
&lt;/gjob:Jobs&gt;
-&lt;/gjob:Helping&gt;</pre><p>While loading the XML file into an internal DOM tree is a matter of
-calling only a couple of functions, browsing the tree to gather the data and
-generate the internal structures is harder, and more error prone.</p><p>The suggested principle is to be tolerant with respect to the input
-structure. For example, the ordering of the attributes is not significant,
-the XML specification is clear about it. It's also usually a good idea not to
-depend on the order of the children of a given node, unless it really makes
-things harder. Here is some code to parse the information for a person:</p><pre>/*
+&lt;/gjob:Helping&gt;</pre><p>While loading the XML file into an internal DOM tree is a matter ofcalling
+only a couple of functions, browsing the tree to gather the data andgenerate
+the internal structures is harder, and more error prone.</p><p>The suggested principle is to be tolerant with respect to the
+inputstructure. For example, the ordering of the attributes is not
+significant,the XML specification is clear about it. It's also usually a good
+idea not todepend on the order of the children of a given node, unless it
+really makesthings harder. Here is some code to parse the information for a
+person:</p><pre>/*
* A person record
*/
typedef struct person {
@@ -113,21 +114,22 @@ DEBUG("parsePerson\n");
}
return(ret);
-}</pre><p>Here are a couple of things to notice:</p><ul><li>Usually a recursive parsing style is the more convenient one: XML data
- is by nature subject to repetitive constructs and usually exhibits highly
- structured patterns.</li>
- <li>The two arguments of type <em>xmlDocPtr</em> and <em>xmlNsPtr</em>,
- i.e. the pointer to the global XML document and the namespace reserved to
- the application. Document wide information are needed for example to
- decode entities and it's a good coding practice to define a namespace for
- your application set of data and test that the element and attributes
- you're analyzing actually pertains to your application space. This is
- done by a simple equality test (cur-&gt;ns == ns).</li>
- <li>To retrieve text and attributes value, you can use the function
- <em>xmlNodeListGetString</em> to gather all the text and entity reference
- nodes generated by the DOM output and produce an single text string.</li>
-</ul><p>Here is another piece of code used to parse another level of the
-structure:</p><pre>#include &lt;libxml/tree.h&gt;
+}</pre><p>Here are a couple of things to notice:</p><ul><li>Usually a recursive parsing style is the more convenient one: XML
+ datais by nature subject to repetitive constructs and usually exhibits
+ highlystructured patterns.</li>
+ <li>The two arguments of type <em>xmlDocPtr</em>and <em>xmlNsPtr</em>,i.e.
+ the pointer to the global XML document and the namespace reserved tothe
+ application. Document wide information are needed for example todecode
+ entities and it's a good coding practice to define a namespace foryour
+ application set of data and test that the element and attributesyou're
+ analyzing actually pertains to your application space. This isdone by a
+ simple equality test (cur-&gt;ns == ns).</li>
+ <li>To retrieve text and attributes value, you can use the
+ function<em>xmlNodeListGetString</em>to gather all the text and entity
+ referencenodes generated by the DOM output and produce an single text
+ string.</li>
+</ul><p>Here is another piece of code used to parse another level of
+thestructure:</p><pre>#include &lt;libxml/tree.h&gt;
/*
* a Description for a Job
*/
@@ -177,10 +179,10 @@ DEBUG("parseJob\n");
}
return(ret);
-}</pre><p>Once you are used to it, writing this kind of code is quite simple, but
-boring. Ultimately, it could be possible to write stubbers taking either C
-data structure definitions, a set of XML examples or an XML DTD and produce
-the code needed to import and export the content between C data and XML
-storage. This is left as an exercise to the reader :-)</p><p>Feel free to use <a href="example/gjobread.c">the code for the full C
-parsing example</a> as a template, it is also available with Makefile in the
-Gnome CVS base under gnome-xml/example</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+}</pre><p>Once you are used to it, writing this kind of code is quite simple,
+butboring. Ultimately, it could be possible to write stubbers taking either
+Cdata structure definitions, a set of XML examples or an XML DTD and
+producethe code needed to import and export the content between C data and
+XMLstorage. This is left as an exercise to the reader :-)</p><p>Feel free to use <a href="example/gjobread.c">the code for the full
+Cparsing example</a>as a template, it is also available with Makefile in
+theGnome CVS base under gnome-xml/example</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/help.html b/doc/help.html
index 55590074..f539bfb5 100644
--- a/doc/help.html
+++ b/doc/help.html
@@ -7,19 +7,18 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>How to help</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>How to help</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>You can help the project in various ways, the best thing to do first is to
-subscribe to the mailing-list as explained before, check the <a href="http://mail.gnome.org/archives/xml/">archives </a>and the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Gnome bug
-database</a>:</p><ol><li>Provide patches when you find problems.</li>
- <li>Provide the diffs when you port libxml2 to a new platform. They may not
- be integrated in all cases but help pinpointing portability problems
- and</li>
- <li>Provide documentation fixes (either as patches to the code comments or
- as HTML diffs).</li>
- <li>Provide new documentations pieces (translations, examples, etc
- ...).</li>
+</style><title>How to help</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>How to help</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>You can help the project in various ways, the best thing to do first is
+tosubscribe to the mailing-list as explained before, check the <a href="http://mail.gnome.org/archives/xml/">archives </a>and the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Gnome
+bugdatabase</a>:</p><ol><li>Provide patches when you find problems.</li>
+ <li>Provide the diffs when you port libxml2 to a new platform. They may
+ notbe integrated in all cases but help pinpointing portability
+ problemsand</li>
+ <li>Provide documentation fixes (either as patches to the code comments
+ oras HTML diffs).</li>
+ <li>Provide new documentations pieces (translations, examples, etc...).</li>
<li>Check the TODO file and try to close one of the items.</li>
- <li>Take one of the points raised in the archive or the bug database and
- provide a fix. <a href="mailto:daniel@veillard.com">Get in touch with me
- </a>before to avoid synchronization problems and check that the suggested
- fix will fit in nicely :-)</li>
+ <li>Take one of the points raised in the archive or the bug database
+ andprovide a fix. <a href="mailto:daniel@veillard.com">Get in touch with
+ me</a>before to avoid synchronization problems and check that the
+ suggestedfix will fit in nicely :-)</li>
</ol><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/html/libxml-xmlerror.html b/doc/html/libxml-xmlerror.html
index f526e690..aefa9673 100644
--- a/doc/html/libxml-xmlerror.html
+++ b/doc/html/libxml-xmlerror.html
@@ -657,6 +657,7 @@ void <a href="#xmlStructuredErrorFunc">xmlStructuredErrorFunc</a> (void * userD
<a name="XML_SCHEMAV_CVC_TYPE_2" id="XML_SCHEMAV_CVC_TYPE_2">XML_SCHEMAV_CVC_TYPE_2</a> = 1876 : 1876
<a name="XML_SCHEMAV_CVC_IDC" id="XML_SCHEMAV_CVC_IDC">XML_SCHEMAV_CVC_IDC</a> = 1877 : 1877
<a name="XML_SCHEMAV_CVC_WILDCARD" id="XML_SCHEMAV_CVC_WILDCARD">XML_SCHEMAV_CVC_WILDCARD</a> = 1878 : 1878
+ <a name="XML_SCHEMAV_MISC" id="XML_SCHEMAV_MISC">XML_SCHEMAV_MISC</a> = 1879 : 1879
<a name="XML_XPTR_UNKNOWN_SCHEME" id="XML_XPTR_UNKNOWN_SCHEME">XML_XPTR_UNKNOWN_SCHEME</a> = 1900
<a name="XML_XPTR_CHILDSEQ_START" id="XML_XPTR_CHILDSEQ_START">XML_XPTR_CHILDSEQ_START</a> = 1901 : 1901
<a name="XML_XPTR_EVAL_FAILED" id="XML_XPTR_EVAL_FAILED">XML_XPTR_EVAL_FAILED</a> = 1902 : 1902
diff --git a/doc/html/libxml-xpath.html b/doc/html/libxml-xpath.html
index 4cfb2bc4..a0d9ba74 100644
--- a/doc/html/libxml-xpath.html
+++ b/doc/html/libxml-xpath.html
@@ -51,6 +51,7 @@ The content of this structure is not made public by the API.
<pre class="programlisting">int <a href="#xmlXPathCmpNodes">xmlXPathCmpNodes</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node1, <br /> <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2)</pre>
<pre class="programlisting"><a href="libxml-xpath.html#xmlXPathCompExprPtr">xmlXPathCompExprPtr</a> <a href="#xmlXPathCompile">xmlXPathCompile</a> (const <a href="libxml-xmlstring.html#xmlChar">xmlChar</a> * str)</pre>
<pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="#xmlXPathCompiledEval">xmlXPathCompiledEval</a> (<a href="libxml-xpath.html#xmlXPathCompExprPtr">xmlXPathCompExprPtr</a> comp, <br /> <a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctx)</pre>
+<pre class="programlisting">int <a href="#xmlXPathContextSetCache">xmlXPathContextSetCache</a> (<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctxt, <br /> int active, <br /> int value, <br /> int options)</pre>
<pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="#xmlXPathConvertBoolean">xmlXPathConvertBoolean</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val)</pre>
<pre class="programlisting">Function type: <a href="#xmlXPathConvertFunc">xmlXPathConvertFunc</a>
int <a href="#xmlXPathConvertFunc">xmlXPathConvertFunc</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> obj, <br /> int type)
@@ -138,7 +139,8 @@ The content of this structure is not made public by the API.
<a href="libxml-xmlerror.html#xmlError">xmlError</a> lastError : the last error
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> debugNode : the source node XSLT dictionnary
<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict : dictionnary if any
- int flags : flags to control compilation
+ int flags : flags to control compilation Cache for
+ void * cache
}</pre><h3>Enum <a name="xmlXPathError" id="xmlXPathError">xmlXPathError</a></h3><pre class="programlisting">Enum xmlXPathError {
<a name="XPATH_EXPRESSION_OK" id="XPATH_EXPRESSION_OK">XPATH_EXPRESSION_OK</a> = 0
<a name="XPATH_NUMBER_ERROR" id="XPATH_NUMBER_ERROR">XPATH_NUMBER_ERROR</a> = 1
@@ -244,7 +246,9 @@ The content of this structure is not made public by the API.
</pre><p>Compile an XPath expression</p>
<div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td>the XPath expression</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the <a href="libxml-xpath.html#xmlXPathCompExprPtr">xmlXPathCompExprPtr</a> resulting from the compilation or NULL. the caller has to free the object.</td></tr></tbody></table></div><h3><a name="xmlXPathCompiledEval" id="xmlXPathCompiledEval"></a>Function: xmlXPathCompiledEval</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathCompiledEval (<a href="libxml-xpath.html#xmlXPathCompExprPtr">xmlXPathCompExprPtr</a> comp, <br /> <a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctx)<br />
</pre><p>Evaluate the Precompiled XPath expression in the given context.</p>
-<div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>comp</tt></i>:</span></td><td>the compiled XPath expression</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td>the XPath context</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the <a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> resulting from the evaluation or NULL. the caller has to free the object.</td></tr></tbody></table></div><h3><a name="xmlXPathConvertBoolean" id="xmlXPathConvertBoolean"></a>Function: xmlXPathConvertBoolean</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathConvertBoolean (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val)<br />
+<div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>comp</tt></i>:</span></td><td>the compiled XPath expression</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td>the XPath context</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the <a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> resulting from the evaluation or NULL. the caller has to free the object.</td></tr></tbody></table></div><h3><a name="xmlXPathContextSetCache" id="xmlXPathContextSetCache"></a>Function: xmlXPathContextSetCache</h3><pre class="programlisting">int xmlXPathContextSetCache (<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctxt, <br /> int active, <br /> int value, <br /> int options)<br />
+</pre><p>Creates/frees an object cache on the XPath context. If activates XPath objects (xmlXPathObject) will be cached internally to be reused. @options: 0: This will set the XPath object caching: @value: This will set the maximum number of XPath objects to be cached per slot There are 5 slots for: node-set, string, number, boolean, and misc objects. Use &lt;0 for the default number (100). Other values for @options have currently no effect.</p>
+<div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td>the XPath context</td></tr><tr><td><span class="term"><i><tt>active</tt></i>:</span></td><td>enables/disables (creates/frees) the cache</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td>a value with semantics dependant on @options</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td>options (currently only the value 0 is used)</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 if the setting succeeded, and -1 on API or internal errors.</td></tr></tbody></table></div><h3><a name="xmlXPathConvertBoolean" id="xmlXPathConvertBoolean"></a>Function: xmlXPathConvertBoolean</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathConvertBoolean (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val)<br />
</pre><p>Converts an existing object to its boolean() equivalent</p>
<div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td>an XPath object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the new object, the old one is freed (or the operation is done directly on @val)</td></tr></tbody></table></div><h3><a name="xmlXPathConvertFunc" id="xmlXPathConvertFunc"></a>Function type: xmlXPathConvertFunc</h3><pre class="programlisting">Function type: xmlXPathConvertFunc
int xmlXPathConvertFunc (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> obj, <br /> int type)
diff --git a/doc/index.html b/doc/index.html
index 21d61eb3..6cbf99bd 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -216,74 +216,73 @@ A:link, A:visited, A:active { text-decoration: underline }
<tr>
<td bgcolor="#fffacd">
<p></p>
- <p style="text-align: right; font-style: italic; font-size: 10pt">"Programming
-with libxml2 is like the thrilling embrace of an exotic stranger." <a href="http://diveintomark.org/archives/2004/02/18/libxml2">Mark
-Pilgrim</a></p>
- <p>Libxml2 is the XML C parser and toolkit developed for the Gnome project
-(but usable outside of the Gnome platform), it is free software available
-under the <a href="http://www.opensource.org/licenses/mit-license.html">MIT
-License</a>. XML itself is a metalanguage to design markup languages, i.e.
-text language where semantic and structure are added to the content using
-extra "markup" information enclosed between angle brackets. HTML is the most
-well-known markup language. Though the library is written in C <a href="python.html">a variety of language bindings</a> make it available in
-other environments.</p>
- <p>Libxml2 is known to be very portable, the library should build and work
-without serious troubles on a variety of systems (Linux, Unix, Windows,
-CygWin, MacOS, MacOS X, RISC Os, OS/2, VMS, QNX, MVS, ...)</p>
- <p>Libxml2 implements a number of existing standards related to markup
-languages:</p>
+ <p style="text-align: right; font-style: italic; font-size: 10pt">"Programmingwith
+libxml2 is like the thrilling embrace of an exotic stranger." <a href="http://diveintomark.org/archives/2004/02/18/libxml2">MarkPilgrim</a></p>
+ <p>Libxml2 is the XML C parser and toolkit developed for the Gnome
+project(but usable outside of the Gnome platform), it is free software
+availableunder the <a href="http://www.opensource.org/licenses/mit-license.html">MITLicense</a>.
+XML itself is a metalanguage to design markup languages, i.e.text language
+where semantic and structure are added to the content usingextra "markup"
+information enclosed between angle brackets. HTML is the mostwell-known
+markup language. Though the library is written in C <a href="python.html">a
+variety of language bindings</a>make it available inother environments.</p>
+ <p>Libxml2 is known to be very portable, the library should build and
+workwithout serious troubles on a variety of systems (Linux, Unix,
+Windows,CygWin, MacOS, MacOS X, RISC Os, OS/2, VMS, QNX, MVS, ...)</p>
+ <p>Libxml2 implements a number of existing standards related to
+markuplanguages:</p>
<ul><li>the XML standard: <a href="http://www.w3.org/TR/REC-xml">http://www.w3.org/TR/REC-xml</a></li>
<li>Namespaces in XML: <a href="http://www.w3.org/TR/REC-xml-names/">http://www.w3.org/TR/REC-xml-names/</a></li>
<li>XML Base: <a href="http://www.w3.org/TR/xmlbase/">http://www.w3.org/TR/xmlbase/</a></li>
- <li><a href="http://www.cis.ohio-state.edu/rfc/rfc2396.txt">RFC 2396</a> :
- Uniform Resource Identifiers <a href="http://www.ietf.org/rfc/rfc2396.txt">http://www.ietf.org/rfc/rfc2396.txt</a></li>
+ <li><a href="http://www.cis.ohio-state.edu/rfc/rfc2396.txt">RFC
+ 2396</a>:Uniform Resource Identifiers <a href="http://www.ietf.org/rfc/rfc2396.txt">http://www.ietf.org/rfc/rfc2396.txt</a></li>
<li>XML Path Language (XPath) 1.0: <a href="http://www.w3.org/TR/xpath">http://www.w3.org/TR/xpath</a></li>
<li>HTML4 parser: <a href="http://www.w3.org/TR/html401/">http://www.w3.org/TR/html401/</a></li>
<li>XML Pointer Language (XPointer) Version 1.0: <a href="http://www.w3.org/TR/xptr">http://www.w3.org/TR/xptr</a></li>
<li>XML Inclusions (XInclude) Version 1.0: <a href="http://www.w3.org/TR/xinclude/">http://www.w3.org/TR/xinclude/</a></li>
- <li>ISO-8859-x encodings, as well as <a href="http://www.cis.ohio-state.edu/rfc/rfc2044.txt">rfc2044</a> [UTF-8]
- and <a href="http://www.cis.ohio-state.edu/rfc/rfc2781.txt">rfc2781</a>
- [UTF-16] Unicode encodings, and more if using iconv support</li>
+ <li>ISO-8859-x encodings, as well as <a href="http://www.cis.ohio-state.edu/rfc/rfc2044.txt">rfc2044</a>[UTF-8]and
+ <a href="http://www.cis.ohio-state.edu/rfc/rfc2781.txt">rfc2781</a>[UTF-16]
+ Unicode encodings, and more if using iconv support</li>
<li>part of SGML Open Technical Resolution TR9401:1997</li>
<li>XML Catalogs Working Draft 06 August 2001: <a href="http://www.oasis-open.org/committees/entity/spec-2001-08-06.html">http://www.oasis-open.org/committees/entity/spec-2001-08-06.html</a></li>
- <li>Canonical XML Version 1.0: <a href="http://www.w3.org/TR/xml-c14n">http://www.w3.org/TR/xml-c14n</a>
- and the Exclusive XML Canonicalization CR draft <a href="http://www.w3.org/TR/xml-exc-c14n">http://www.w3.org/TR/xml-exc-c14n</a></li>
+ <li>Canonical XML Version 1.0: <a href="http://www.w3.org/TR/xml-c14n">http://www.w3.org/TR/xml-c14n</a>and
+ the Exclusive XML Canonicalization CR draft <a href="http://www.w3.org/TR/xml-exc-c14n">http://www.w3.org/TR/xml-exc-c14n</a></li>
<li>Relax NG, ISO/IEC 19757-2:2003, <a href="http://www.oasis-open.org/committees/relax-ng/spec-20011203.html">http://www.oasis-open.org/committees/relax-ng/spec-20011203.html</a></li>
- <li>W3C XML Schemas Part 2: Datatypes <a href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">REC 02 May
- 2001</a></li>
- <li>W3C <a href="http://www.w3.org/TR/xml-id/">xml:id</a> Working Draft 7
- April 2004</li>
+ <li>W3C XML Schemas Part 2: Datatypes <a href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">REC 02
+ May2001</a></li>
+ <li>W3C <a href="http://www.w3.org/TR/xml-id/">xml:id</a>Working Draft
+ 7April 2004</li>
</ul>
- <p>In most cases libxml2 tries to implement the specifications in a
-relatively strictly compliant way. As of release 2.4.16, libxml2 passed all
-1800+ tests from the <a href="http://www.oasis-open.org/committees/xml-conformance/">OASIS XML Tests
-Suite</a>.</p>
- <p>To some extent libxml2 provides support for the following additional
-specifications but doesn't claim to implement them completely:</p>
- <ul><li>Document Object Model (DOM) <a href="http://www.w3.org/TR/DOM-Level-2-Core/">http://www.w3.org/TR/DOM-Level-2-Core/</a>
- the document model, but it doesn't implement the API itself, gdome2 does
- this on top of libxml2</li>
- <li><a href="http://www.cis.ohio-state.edu/rfc/rfc959.txt">RFC 959</a> :
- libxml2 implements a basic FTP client code</li>
- <li><a href="http://www.cis.ohio-state.edu/rfc/rfc1945.txt">RFC 1945</a> :
- HTTP/1.0, again a basic HTTP client code</li>
- <li>SAX: a SAX2 like interface and a minimal SAX1 implementation compatible
- with early expat versions</li>
+ <p>In most cases libxml2 tries to implement the specifications in arelatively
+strictly compliant way. As of release 2.4.16, libxml2 passed all1800+ tests
+from the <a href="http://www.oasis-open.org/committees/xml-conformance/">OASIS XML
+TestsSuite</a>.</p>
+ <p>To some extent libxml2 provides support for the following
+additionalspecifications but doesn't claim to implement them completely:</p>
+ <ul><li>Document Object Model (DOM) <a href="http://www.w3.org/TR/DOM-Level-2-Core/">http://www.w3.org/TR/DOM-Level-2-Core/</a>the
+ document model, but it doesn't implement the API itself, gdome2 doesthis
+ on top of libxml2</li>
+ <li><a href="http://www.cis.ohio-state.edu/rfc/rfc959.txt">RFC
+ 959</a>:libxml2 implements a basic FTP client code</li>
+ <li><a href="http://www.cis.ohio-state.edu/rfc/rfc1945.txt">RFC
+ 1945</a>:HTTP/1.0, again a basic HTTP client code</li>
+ <li>SAX: a SAX2 like interface and a minimal SAX1 implementation
+ compatiblewith early expat versions</li>
</ul>
- <p>A partial implementation of <a href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/">XML Schemas Part
-1: Structure</a> is being worked on but it would be far too early to make any
-conformance statement about it at the moment.</p>
+ <p>A partial implementation of <a href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/">XML Schemas Part1:
+Structure</a>is being worked on but it would be far too early to make
+anyconformance statement about it at the moment.</p>
<p>Separate documents:</p>
- <ul><li><a href="http://xmlsoft.org/XSLT/">the libxslt page</a> providing an
- implementation of XSLT 1.0 and common extensions like EXSLT for
- libxml2</li>
- <li><a href="http://www.cs.unibo.it/~casarini/gdome2/">the gdome2 page</a>
- : a standard DOM2 implementation for libxml2</li>
- <li><a href="http://www.aleksey.com/xmlsec/">the XMLSec page</a>: an
- implementation of <a href="http://www.w3.org/TR/xmldsig-core/">W3C XML
- Digital Signature</a> for libxml2</li>
- <li>also check the related links section below for more related and active
- projects.</li>
+ <ul><li><a href="http://xmlsoft.org/XSLT/">the libxslt page</a>providing
+ animplementation of XSLT 1.0 and common extensions like EXSLT
+ forlibxml2</li>
+ <li><a href="http://www.cs.unibo.it/~casarini/gdome2/">the gdome2 page</a>:
+ a standard DOM2 implementation for libxml2</li>
+ <li><a href="http://www.aleksey.com/xmlsec/">the XMLSec page</a>:
+ animplementation of <a href="http://www.w3.org/TR/xmldsig-core/">W3C
+ XMLDigital Signature</a>for libxml2</li>
+ <li>also check the related links section below for more related and
+ activeprojects.</li>
</ul>
<p>Logo designed by <a href="mailto:liyanage@access.ch">Marc Liyanage</a>.</p>
<p>
diff --git a/doc/interface.html b/doc/interface.html
index 8163c410..f1698d66 100644
--- a/doc/interface.html
+++ b/doc/interface.html
@@ -7,19 +7,18 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>The SAX interface</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>The SAX interface</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Sometimes the DOM tree output is just too large to fit reasonably into
-memory. In that case (and if you don't expect to save back the XML document
-loaded using libxml), it's better to use the SAX interface of libxml. SAX is
-a <strong>callback-based interface</strong> to the parser. Before parsing,
-the application layer registers a customized set of callbacks which are
-called by the library as it progresses through the XML input.</p><p>To get more detailed step-by-step guidance on using the SAX interface of
-libxml, see the <a href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">nice
-documentation</a>.written by <a href="mailto:james@daa.com.au">James
-Henstridge</a>.</p><p>You can debug the SAX behaviour by using the <strong>testSAX</strong>
-program located in the gnome-xml module (it's usually not shipped in the
-binary packages of libxml, but you can find it in the tar source
-distribution). Here is the sequence of callbacks that would be reported by
-testSAX when parsing the example XML document shown earlier:</p><pre>SAX.setDocumentLocator()
+</style><title>The SAX interface</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>The SAX interface</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Sometimes the DOM tree output is just too large to fit reasonably
+intomemory. In that case (and if you don't expect to save back the XML
+documentloaded using libxml), it's better to use the SAX interface of libxml.
+SAX isa <strong>callback-based interface</strong>to the parser. Before
+parsing,the application layer registers a customized set of callbacks which
+arecalled by the library as it progresses through the XML input.</p><p>To get more detailed step-by-step guidance on using the SAX interface
+oflibxml, see the <a href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">nicedocumentation</a>.written
+by <a href="mailto:james@daa.com.au">JamesHenstridge</a>.</p><p>You can debug the SAX behaviour by using the
+<strong>testSAX</strong>program located in the gnome-xml module (it's usually
+not shipped in thebinary packages of libxml, but you can find it in the tar
+sourcedistribution). Here is the sequence of callbacks that would be reported
+bytestSAX when parsing the example XML document shown earlier:</p><pre>SAX.setDocumentLocator()
SAX.startDocument()
SAX.getEntity(amp)
SAX.startElement(EXAMPLE, prop1='gnome is great', prop2='&amp;amp; linux too')
@@ -52,8 +51,8 @@ SAX.characters( , 3)
SAX.endElement(chapter)
SAX.characters( , 1)
SAX.endElement(EXAMPLE)
-SAX.endDocument()</pre><p>Most of the other interfaces of libxml2 are based on the DOM tree-building
-facility, so nearly everything up to the end of this document presupposes the
-use of the standard DOM tree build. Note that the DOM tree itself is built by
-a set of registered default callbacks, without internal specific
-interface.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+SAX.endDocument()</pre><p>Most of the other interfaces of libxml2 are based on the DOM
+tree-buildingfacility, so nearly everything up to the end of this document
+presupposes theuse of the standard DOM tree build. Note that the DOM tree
+itself is built bya set of registered default callbacks, without internal
+specificinterface.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/intro.html b/doc/intro.html
index 650eccbb..93ee1dfe 100644
--- a/doc/intro.html
+++ b/doc/intro.html
@@ -7,25 +7,23 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Introduction</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Introduction</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>This document describes libxml, the <a href="http://www.w3.org/XML/">XML</a> C parser and toolkit developed for the
-<a href="http://www.gnome.org/">Gnome</a> project. <a href="http://www.w3.org/XML/">XML is a standard</a> for building tag-based
-structured documents/data.</p><p>Here are some key points about libxml:</p><ul><li>Libxml2 exports Push (progressive) and Pull (blocking) type parser
- interfaces for both XML and HTML.</li>
- <li>Libxml2 can do DTD validation at parse time, using a parsed document
- instance, or with an arbitrary DTD.</li>
- <li>Libxml2 includes complete <a href="http://www.w3.org/TR/xpath">XPath</a>, <a href="http://www.w3.org/TR/xptr">XPointer</a> and <a href="http://www.w3.org/TR/xinclude">XInclude</a> implementations.</li>
- <li>It is written in plain C, making as few assumptions as possible, and
- sticking closely to ANSI C/POSIX for easy embedding. Works on
- Linux/Unix/Windows, ported to a number of other platforms.</li>
- <li>Basic support for HTTP and FTP client allowing applications to fetch
- remote resources.</li>
+</style><title>Introduction</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Introduction</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>This document describes libxml, the <a href="http://www.w3.org/XML/">XML</a>C parser and toolkit developed for the<a href="http://www.gnome.org/">Gnome</a>project. <a href="http://www.w3.org/XML/">XML is a standard</a>for building
+tag-basedstructured documents/data.</p><p>Here are some key points about libxml:</p><ul><li>Libxml2 exports Push (progressive) and Pull (blocking) type
+ parserinterfaces for both XML and HTML.</li>
+ <li>Libxml2 can do DTD validation at parse time, using a parsed
+ documentinstance, or with an arbitrary DTD.</li>
+ <li>Libxml2 includes complete <a href="http://www.w3.org/TR/xpath">XPath</a>, <a href="http://www.w3.org/TR/xptr">XPointer</a>and <a href="http://www.w3.org/TR/xinclude">XInclude</a>implementations.</li>
+ <li>It is written in plain C, making as few assumptions as possible,
+ andsticking closely to ANSI C/POSIX for easy embedding. Works
+ onLinux/Unix/Windows, ported to a number of other platforms.</li>
+ <li>Basic support for HTTP and FTP client allowing applications to
+ fetchremote resources.</li>
<li>The design is modular, most of the extensions can be compiled out.</li>
- <li>The internal document representation is as close as possible to the <a href="http://www.w3.org/DOM/">DOM</a> interfaces.</li>
- <li>Libxml2 also has a <a href="http://www.megginson.com/SAX/index.html">SAX like interface</a>;
- the interface is designed to be compatible with <a href="http://www.jclark.com/xml/expat.html">Expat</a>.</li>
- <li>This library is released under the <a href="http://www.opensource.org/licenses/mit-license.html">MIT
- License</a>. See the Copyright file in the distribution for the precise
- wording.</li>
-</ul><p>Warning: unless you are forced to because your application links with a
-Gnome-1.X library requiring it, <strong><span style="background-color: #FF0000">Do Not Use libxml1</span></strong>, use
-libxml2</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+ <li>The internal document representation is as close as possible to the <a href="http://www.w3.org/DOM/">DOM</a>interfaces.</li>
+ <li>Libxml2 also has a <a href="http://www.megginson.com/SAX/index.html">SAX like interface</a>;the
+ interface is designed to be compatible with <a href="http://www.jclark.com/xml/expat.html">Expat</a>.</li>
+ <li>This library is released under the <a href="http://www.opensource.org/licenses/mit-license.html">MITLicense</a>.
+ See the Copyright file in the distribution for the precisewording.</li>
+</ul><p>Warning: unless you are forced to because your application links with
+aGnome-1.X library requiring it, <strong><span style="background-color: #FF0000">Do Not Use libxml1</span></strong>,
+uselibxml2</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/library.html b/doc/library.html
index b5faade6..98a605b9 100644
--- a/doc/library.html
+++ b/doc/library.html
@@ -7,27 +7,26 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>The parser interfaces</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>The parser interfaces</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>This section is directly intended to help programmers getting bootstrapped
-using the XML tollkit from the C language. It is not intended to be
-extensive. I hope the automatically generated documents will provide the
-completeness required, but as a separate set of documents. The interfaces of
-the XML parser are by principle low level, Those interested in a higher level
-API should <a href="#DOM">look at DOM</a>.</p><p>The <a href="html/libxml-parser.html">parser interfaces for XML</a> are
-separated from the <a href="html/libxml-htmlparser.html">HTML parser
-interfaces</a>. Let's have a look at how the XML parser can be called:</p><h3><a name="Invoking" id="Invoking">Invoking the parser : the pull method</a></h3><p>Usually, the first thing to do is to read an XML input. The parser accepts
-documents either from in-memory strings or from files. The functions are
-defined in "parser.h":</p><dl><dt><code>xmlDocPtr xmlParseMemory(char *buffer, int size);</code></dt>
+</style><title>The parser interfaces</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>The parser interfaces</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>This section is directly intended to help programmers getting
+bootstrappedusing the XML tollkit from the C language. It is not intended to
+beextensive. I hope the automatically generated documents will provide
+thecompleteness required, but as a separate set of documents. The interfaces
+ofthe XML parser are by principle low level, Those interested in a higher
+levelAPI should <a href="#DOM">look at DOM</a>.</p><p>The <a href="html/libxml-parser.html">parser interfaces for
+XML</a>areseparated from the <a href="html/libxml-htmlparser.html">HTML
+parserinterfaces</a>. Let's have a look at how the XML parser can be
+called:</p><h3><a name="Invoking" id="Invoking">Invoking the parser : the pull method</a></h3><p>Usually, the first thing to do is to read an XML input. The parser
+acceptsdocuments either from in-memory strings or from files. The functions
+aredefined in "parser.h":</p><dl><dt><code>xmlDocPtr xmlParseMemory(char *buffer, int size);</code></dt>
<dd><p>Parse a null-terminated string containing the document.</p>
</dd>
</dl><dl><dt><code>xmlDocPtr xmlParseFile(const char *filename);</code></dt>
- <dd><p>Parse an XML document contained in a (possibly compressed)
- file.</p>
+ <dd><p>Parse an XML document contained in a (possibly compressed)file.</p>
</dd>
-</dl><p>The parser returns a pointer to the document structure (or NULL in case of
-failure).</p><h3 id="Invoking1">Invoking the parser: the push method</h3><p>In order for the application to keep the control when the document is
-being fetched (which is common for GUI based programs) libxml2 provides a
-push interface, too, as of version 1.8.3. Here are the interface
-functions:</p><pre>xmlParserCtxtPtr xmlCreatePushParserCtxt(xmlSAXHandlerPtr sax,
+</dl><p>The parser returns a pointer to the document structure (or NULL in case
+offailure).</p><h3 id="Invoking1">Invoking the parser: the push method</h3><p>In order for the application to keep the control when the document isbeing
+fetched (which is common for GUI based programs) libxml2 provides apush
+interface, too, as of version 1.8.3. Here are the interfacefunctions:</p><pre>xmlParserCtxtPtr xmlCreatePushParserCtxt(xmlSAXHandlerPtr sax,
void *user_data,
const char *chunk,
int size,
@@ -54,17 +53,16 @@ int xmlParseChunk (xmlParserCtxtPtr ctxt,
doc = ctxt-&gt;myDoc;
xmlFreeParserCtxt(ctxt);
}
- }</pre><p>The HTML parser embedded into libxml2 also has a push interface; the
-functions are just prefixed by "html" rather than "xml".</p><h3 id="Invoking2">Invoking the parser: the SAX interface</h3><p>The tree-building interface makes the parser memory-hungry, first loading
-the document in memory and then building the tree itself. Reading a document
-without building the tree is possible using the SAX interfaces (see SAX.h and
-<a href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">James
-Henstridge's documentation</a>). Note also that the push interface can be
-limited to SAX: just use the two first arguments of
-<code>xmlCreatePushParserCtxt()</code>.</p><h3><a name="Building" id="Building">Building a tree from scratch</a></h3><p>The other way to get an XML tree in memory is by building it. Basically
-there is a set of functions dedicated to building new elements. (These are
-also described in &lt;libxml/tree.h&gt;.) For example, here is a piece of
-code that produces the XML document used in the previous examples:</p><pre> #include &lt;libxml/tree.h&gt;
+ }</pre><p>The HTML parser embedded into libxml2 also has a push interface;
+thefunctions are just prefixed by "html" rather than "xml".</p><h3 id="Invoking2">Invoking the parser: the SAX interface</h3><p>The tree-building interface makes the parser memory-hungry, first
+loadingthe document in memory and then building the tree itself. Reading a
+documentwithout building the tree is possible using the SAX interfaces (see
+SAX.h and<a href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">JamesHenstridge's
+documentation</a>). Note also that the push interface can belimited to SAX:
+just use the two first arguments of<code>xmlCreatePushParserCtxt()</code>.</p><h3><a name="Building" id="Building">Building a tree from scratch</a></h3><p>The other way to get an XML tree in memory is by building it.
+Basicallythere is a set of functions dedicated to building new elements.
+(These arealso described in &lt;libxml/tree.h&gt;.) For example, here is a
+piece ofcode that produces the XML document used in the previous examples:</p><pre> #include &lt;libxml/tree.h&gt;
xmlDocPtr doc;
xmlNodePtr tree, subtree;
@@ -78,59 +76,59 @@ code that produces the XML document used in the previous examples:</p><pre> #
subtree = xmlNewChild(tree, NULL, "title", "The Linux adventure");
subtree = xmlNewChild(tree, NULL, "p", "bla bla bla ...");
subtree = xmlNewChild(tree, NULL, "image", NULL);
- xmlSetProp(subtree, "href", "linus.gif");</pre><p>Not really rocket science ...</p><h3><a name="Traversing" id="Traversing">Traversing the tree</a></h3><p>Basically by <a href="html/libxml-tree.html">including "tree.h"</a> your
-code has access to the internal structure of all the elements of the tree.
-The names should be somewhat simple like <strong>parent</strong>,
-<strong>children</strong>, <strong>next</strong>, <strong>prev</strong>,
-<strong>properties</strong>, etc... For example, still with the previous
-example:</p><pre><code>doc-&gt;children-&gt;children-&gt;children</code></pre><p>points to the title element,</p><pre>doc-&gt;children-&gt;children-&gt;next-&gt;children-&gt;children</pre><p>points to the text node containing the chapter title "The Linux
-adventure".</p><p><strong>NOTE</strong>: XML allows <em>PI</em>s and <em>comments</em> to be
-present before the document root, so <code>doc-&gt;children</code> may point
-to an element which is not the document Root Element; a function
-<code>xmlDocGetRootElement()</code> was added for this purpose.</p><h3><a name="Modifying" id="Modifying">Modifying the tree</a></h3><p>Functions are provided for reading and writing the document content. Here
-is an excerpt from the <a href="html/libxml-tree.html">tree API</a>:</p><dl><dt><code>xmlAttrPtr xmlSetProp(xmlNodePtr node, const xmlChar *name, const
- xmlChar *value);</code></dt>
- <dd><p>This sets (or changes) an attribute carried by an ELEMENT node.
- The value can be NULL.</p>
+ xmlSetProp(subtree, "href", "linus.gif");</pre><p>Not really rocket science ...</p><h3><a name="Traversing" id="Traversing">Traversing the tree</a></h3><p>Basically by <a href="html/libxml-tree.html">including
+"tree.h"</a>yourcode has access to the internal structure of all the elements
+of the tree.The names should be somewhat simple like
+<strong>parent</strong>,<strong>children</strong>, <strong>next</strong>,
+<strong>prev</strong>,<strong>properties</strong>, etc... For example, still
+with the previousexample:</p><pre><code>doc-&gt;children-&gt;children-&gt;children</code></pre><p>points to the title element,</p><pre>doc-&gt;children-&gt;children-&gt;next-&gt;children-&gt;children</pre><p>points to the text node containing the chapter title "The
+Linuxadventure".</p><p><strong>NOTE</strong>: XML allows <em>PI</em>s and <em>comments</em>to
+bepresent before the document root, so <code>doc-&gt;children</code>may
+pointto an element which is not the document Root Element; a
+function<code>xmlDocGetRootElement()</code>was added for this purpose.</p><h3><a name="Modifying" id="Modifying">Modifying the tree</a></h3><p>Functions are provided for reading and writing the document content.
+Hereis an excerpt from the <a href="html/libxml-tree.html">tree API</a>:</p><dl><dt><code>xmlAttrPtr xmlSetProp(xmlNodePtr node, const xmlChar *name,
+ constxmlChar *value);</code></dt>
+ <dd><p>This sets (or changes) an attribute carried by an ELEMENT node.The
+ value can be NULL.</p>
</dd>
-</dl><dl><dt><code>const xmlChar *xmlGetProp(xmlNodePtr node, const xmlChar
- *name);</code></dt>
- <dd><p>This function returns a pointer to new copy of the property
- content. Note that the user must deallocate the result.</p>
+</dl><dl><dt><code>const xmlChar *xmlGetProp(xmlNodePtr node, const
+ xmlChar*name);</code></dt>
+ <dd><p>This function returns a pointer to new copy of the
+ propertycontent. Note that the user must deallocate the result.</p>
</dd>
-</dl><p>Two functions are provided for reading and writing the text associated
-with elements:</p><dl><dt><code>xmlNodePtr xmlStringGetNodeList(xmlDocPtr doc, const xmlChar
- *value);</code></dt>
- <dd><p>This function takes an "external" string and converts it to one
- text node or possibly to a list of entity and text nodes. All
- non-predefined entity references like &amp;Gnome; will be stored
- internally as entity nodes, hence the result of the function may not be
- a single node.</p>
+</dl><p>Two functions are provided for reading and writing the text associatedwith
+elements:</p><dl><dt><code>xmlNodePtr xmlStringGetNodeList(xmlDocPtr doc, const
+ xmlChar*value);</code></dt>
+ <dd><p>This function takes an "external" string and converts it to
+ onetext node or possibly to a list of entity and text nodes.
+ Allnon-predefined entity references like &amp;Gnome; will be
+ storedinternally as entity nodes, hence the result of the function may
+ not bea single node.</p>
</dd>
-</dl><dl><dt><code>xmlChar *xmlNodeListGetString(xmlDocPtr doc, xmlNodePtr list, int
- inLine);</code></dt>
- <dd><p>This function is the inverse of
- <code>xmlStringGetNodeList()</code>. It generates a new string
- containing the content of the text and entity nodes. Note the extra
- argument inLine. If this argument is set to 1, the function will expand
- entity references. For example, instead of returning the &amp;Gnome;
- XML encoding in the string, it will substitute it with its value (say,
- "GNU Network Object Model Environment").</p>
+</dl><dl><dt><code>xmlChar *xmlNodeListGetString(xmlDocPtr doc, xmlNodePtr list,
+ intinLine);</code></dt>
+ <dd><p>This function is the inverse
+ of<code>xmlStringGetNodeList()</code>. It generates a new
+ stringcontaining the content of the text and entity nodes. Note the
+ extraargument inLine. If this argument is set to 1, the function will
+ expandentity references. For example, instead of returning the
+ &amp;Gnome;XML encoding in the string, it will substitute it with its
+ value (say,"GNU Network Object Model Environment").</p>
</dd>
-</dl><h3><a name="Saving" id="Saving">Saving a tree</a></h3><p>Basically 3 options are possible:</p><dl><dt><code>void xmlDocDumpMemory(xmlDocPtr cur, xmlChar**mem, int
- *size);</code></dt>
+</dl><h3><a name="Saving" id="Saving">Saving a tree</a></h3><p>Basically 3 options are possible:</p><dl><dt><code>void xmlDocDumpMemory(xmlDocPtr cur, xmlChar**mem,
+ int*size);</code></dt>
<dd><p>Returns a buffer into which the document has been saved.</p>
</dd>
</dl><dl><dt><code>extern void xmlDocDump(FILE *f, xmlDocPtr doc);</code></dt>
<dd><p>Dumps a document to an open file descriptor.</p>
</dd>
</dl><dl><dt><code>int xmlSaveFile(const char *filename, xmlDocPtr cur);</code></dt>
- <dd><p>Saves the document to a file. In this case, the compression
- interface is triggered if it has been turned on.</p>
+ <dd><p>Saves the document to a file. In this case, the
+ compressioninterface is triggered if it has been turned on.</p>
</dd>
-</dl><h3><a name="Compressio" id="Compressio">Compression</a></h3><p>The library transparently handles compression when doing file-based
-accesses. The level of compression on saves can be turned on either globally
-or individually for one file:</p><dl><dt><code>int xmlGetDocCompressMode (xmlDocPtr doc);</code></dt>
+</dl><h3><a name="Compressio" id="Compressio">Compression</a></h3><p>The library transparently handles compression when doing
+file-basedaccesses. The level of compression on saves can be turned on either
+globallyor individually for one file:</p><dl><dt><code>int xmlGetDocCompressMode (xmlDocPtr doc);</code></dt>
<dd><p>Gets the document compression ratio (0-9).</p>
</dd>
</dl><dl><dt><code>void xmlSetDocCompressMode (xmlDocPtr doc, int mode);</code></dt>
diff --git a/doc/libxml2-api.xml b/doc/libxml2-api.xml
index 1affb28c..2dbf900e 100644
--- a/doc/libxml2-api.xml
+++ b/doc/libxml2-api.xml
@@ -2270,6 +2270,7 @@
<exports symbol='XML_SCHEMAP_COS_ST_RESTRICTS_2_3_2_3' type='enum'/>
<exports symbol='XML_ERR_ENCODING_NAME' type='enum'/>
<exports symbol='XML_SCHEMAP_COS_ST_RESTRICTS_2_3_2_5' type='enum'/>
+ <exports symbol='XML_SCHEMAV_MISC' type='enum'/>
<exports symbol='XML_IO_ECONNREFUSED' type='enum'/>
<exports symbol='XML_ERR_XMLDECL_NOT_FINISHED' type='enum'/>
<exports symbol='XML_SCHEMAP_P_PROPS_CORRECT_1' type='enum'/>
@@ -3498,6 +3499,7 @@
<exports symbol='xmlXPathFuncLookupFunc' type='function'/>
<exports symbol='xmlXPathCastNodeToString' type='function'/>
<exports symbol='xmlXPathIsNaN' type='function'/>
+ <exports symbol='xmlXPathContextSetCache' type='function'/>
<exports symbol='xmlXPathConvertString' type='function'/>
<exports symbol='xmlXPathConvertBoolean' type='function'/>
<exports symbol='xmlXPathIsInf' type='function'/>
@@ -5521,6 +5523,7 @@
<enum name='XML_SCHEMAV_INVALIDATTR' file='xmlerror' value='1814' type='xmlParserErrors' info='1814'/>
<enum name='XML_SCHEMAV_INVALIDELEM' file='xmlerror' value='1815' type='xmlParserErrors' info='1815'/>
<enum name='XML_SCHEMAV_ISABSTRACT' file='xmlerror' value='1808' type='xmlParserErrors' info='1808'/>
+ <enum name='XML_SCHEMAV_MISC' file='xmlerror' value='1879' type='xmlParserErrors' info='1879'/>
<enum name='XML_SCHEMAV_MISSING' file='xmlerror' value='1804' type='xmlParserErrors' info='1804'/>
<enum name='XML_SCHEMAV_NOROLLBACK' file='xmlerror' value='1807' type='xmlParserErrors' info='1807'/>
<enum name='XML_SCHEMAV_NOROOT' file='xmlerror' value='1801' type='xmlParserErrors'/>
@@ -6686,7 +6689,8 @@ Could we use @subtypes for this?'/>
<field name='lastError' type='xmlError' info=' the last error'/>
<field name='debugNode' type='xmlNodePtr' info=' the source node XSLT dictionnary'/>
<field name='dict' type='xmlDictPtr' info=' dictionnary if any'/>
- <field name='flags' type='int' info=' flags to control compilation'/>
+ <field name='flags' type='int' info=' flags to control compilation Cache for reusal of XPath objects'/>
+ <field name='cache' type='void *' info=''/>
</struct>
<typedef name='xmlXPathContextPtr' file='xpath' type='xmlXPathContext *'/>
<typedef name='xmlXPathError' file='xpath' type='enum'/>
@@ -16980,6 +16984,15 @@ Could we use @subtypes for this?'/>
<arg name='ctxt' type='xmlXPathParserContextPtr' info='the XPath Parser context'/>
<arg name='nargs' type='int' info='the number of arguments'/>
</function>
+ <function name='xmlXPathContextSetCache' file='xpath' module='xpath'>
+ <cond>defined(LIBXML_XPATH_ENABLED)</cond>
+ <info>Creates/frees an object cache on the XPath context. If activates XPath objects (xmlXPathObject) will be cached internally to be reused. @options: 0: This will set the XPath object caching: @value: This will set the maximum number of XPath objects to be cached per slot There are 5 slots for: node-set, string, number, boolean, and misc objects. Use &lt;0 for the default number (100). Other values for @options have currently no effect.</info>
+ <return type='int' info='0 if the setting succeeded, and -1 on API or internal errors.'/>
+ <arg name='ctxt' type='xmlXPathContextPtr' info='the XPath context'/>
+ <arg name='active' type='int' info='enables/disables (creates/frees) the cache'/>
+ <arg name='value' type='int' info='a value with semantics dependant on @options'/>
+ <arg name='options' type='int' info='options (currently only the value 0 is used)'/>
+ </function>
<function name='xmlXPathConvertBoolean' file='xpath' module='xpath'>
<cond>defined(LIBXML_XPATH_ENABLED)</cond>
<info>Converts an existing object to its boolean() equivalent</info>
diff --git a/doc/libxml2-refs.xml b/doc/libxml2-refs.xml
index e4d63414..30a8bbd9 100644
--- a/doc/libxml2-refs.xml
+++ b/doc/libxml2-refs.xml
@@ -1193,6 +1193,7 @@
<reference name='XML_SCHEMAV_INVALIDATTR' href='html/libxml-xmlerror.html#XML_SCHEMAV_INVALIDATTR'/>
<reference name='XML_SCHEMAV_INVALIDELEM' href='html/libxml-xmlerror.html#XML_SCHEMAV_INVALIDELEM'/>
<reference name='XML_SCHEMAV_ISABSTRACT' href='html/libxml-xmlerror.html#XML_SCHEMAV_ISABSTRACT'/>
+ <reference name='XML_SCHEMAV_MISC' href='html/libxml-xmlerror.html#XML_SCHEMAV_MISC'/>
<reference name='XML_SCHEMAV_MISSING' href='html/libxml-xmlerror.html#XML_SCHEMAV_MISSING'/>
<reference name='XML_SCHEMAV_NOROLLBACK' href='html/libxml-xmlerror.html#XML_SCHEMAV_NOROLLBACK'/>
<reference name='XML_SCHEMAV_NOROOT' href='html/libxml-xmlerror.html#XML_SCHEMAV_NOROOT'/>
@@ -3286,6 +3287,7 @@
<reference name='xmlXPathContainsFunction' href='html/libxml-xpathInternals.html#xmlXPathContainsFunction'/>
<reference name='xmlXPathContext' href='html/libxml-xpath.html#xmlXPathContext'/>
<reference name='xmlXPathContextPtr' href='html/libxml-xpath.html#xmlXPathContextPtr'/>
+ <reference name='xmlXPathContextSetCache' href='html/libxml-xpath.html#xmlXPathContextSetCache'/>
<reference name='xmlXPathConvertBoolean' href='html/libxml-xpath.html#xmlXPathConvertBoolean'/>
<reference name='xmlXPathConvertFunc' href='html/libxml-xpath.html#xmlXPathConvertFunc'/>
<reference name='xmlXPathConvertNumber' href='html/libxml-xpath.html#xmlXPathConvertNumber'/>
@@ -4693,6 +4695,7 @@
<ref name='XML_SCHEMAV_INVALIDATTR'/>
<ref name='XML_SCHEMAV_INVALIDELEM'/>
<ref name='XML_SCHEMAV_ISABSTRACT'/>
+ <ref name='XML_SCHEMAV_MISC'/>
<ref name='XML_SCHEMAV_MISSING'/>
<ref name='XML_SCHEMAV_NOROLLBACK'/>
<ref name='XML_SCHEMAV_NOROOT'/>
@@ -6822,6 +6825,7 @@
<ref name='xmlXPathContainsFunction'/>
<ref name='xmlXPathContext'/>
<ref name='xmlXPathContextPtr'/>
+ <ref name='xmlXPathContextSetCache'/>
<ref name='xmlXPathConvertBoolean'/>
<ref name='xmlXPathConvertFunc'/>
<ref name='xmlXPathConvertNumber'/>
@@ -10313,6 +10317,7 @@
</type>
<type name='xmlXPathContextPtr'>
<ref name='xmlXPathCompiledEval'/>
+ <ref name='xmlXPathContextSetCache'/>
<ref name='xmlXPathCtxtCompile'/>
<ref name='xmlXPathEval'/>
<ref name='xmlXPathEvalExpression'/>
@@ -12960,6 +12965,7 @@
<ref name='XML_SCHEMAV_INVALIDATTR'/>
<ref name='XML_SCHEMAV_INVALIDELEM'/>
<ref name='XML_SCHEMAV_ISABSTRACT'/>
+ <ref name='XML_SCHEMAV_MISC'/>
<ref name='XML_SCHEMAV_MISSING'/>
<ref name='XML_SCHEMAV_NOROLLBACK'/>
<ref name='XML_SCHEMAV_NOROOT'/>
@@ -13803,6 +13809,7 @@
<ref name='xmlXPathCompiledEval'/>
<ref name='xmlXPathContext'/>
<ref name='xmlXPathContextPtr'/>
+ <ref name='xmlXPathContextSetCache'/>
<ref name='xmlXPathConvertBoolean'/>
<ref name='xmlXPathConvertFunc'/>
<ref name='xmlXPathConvertNumber'/>
@@ -14490,6 +14497,9 @@
<word name='CWD'>
<ref name='xmlNanoFTPCwd'/>
</word>
+ <word name='Cache'>
+ <ref name='_xmlXPathContext'/>
+ </word>
<word name='Call'>
<ref name='htmlInitAutoClose'/>
<ref name='xmlInitParser'/>
@@ -14821,6 +14831,7 @@
<ref name='xmlExpNewCtxt'/>
<ref name='xmlNewDoc'/>
<ref name='xmlXIncludeNewContext'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='Creation'>
<ref name='xmlNewCDataBlock'/>
@@ -16553,6 +16564,9 @@
<word name='Osmanya'>
<ref name='xmlUCSIsOsmanya'/>
</word>
+ <word name='Other'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='Otherwise'>
<ref name='xmlStreamPush'/>
<ref name='xmlStreamPushAttr'/>
@@ -17683,6 +17697,7 @@
</word>
<word name='There'>
<ref name='xmlExpParse'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='Those'>
<ref name='_xmlParserCtxt'/>
@@ -17892,6 +17907,7 @@
<ref name='xmlTextReaderSchemaValidate'/>
<ref name='xmlTextReaderSchemaValidateCtxt'/>
<ref name='xmlTextReaderSetSchema'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='Used'>
<ref name='XML_SCHEMAS_ANY_LAX'/>
@@ -18445,6 +18461,9 @@
<ref name='xmlTextReaderSchemaValidateCtxt'/>
<ref name='xmlTextReaderSetSchema'/>
</word>
+ <word name='activates'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='activation'>
<ref name='xmlGetLineNo'/>
</word>
@@ -19468,6 +19487,15 @@
</chunk>
<chunk name='chunk12'>
<letter name='c'>
+ <word name='cache'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
+ <word name='cached'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
+ <word name='caching:'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='calculated'>
<ref name='xmlStrncatNew'/>
</word>
@@ -20627,6 +20655,7 @@
<ref name='xmlAutomataNewTransition2'/>
<ref name='xmlCreateURI'/>
<ref name='xmlStrncatNew'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='creating'>
<ref name='xmlDOMWrapAdoptNode'/>
@@ -20677,6 +20706,7 @@
<ref name='xmlMemGet'/>
<ref name='xmlMemUsed'/>
<ref name='xmlOutputBufferCreateFilename'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='custom'>
<ref name='xmlDOMWrapAdoptNode'/>
@@ -20938,6 +20968,9 @@
<word name='deletion'>
<ref name='xmlCatalogSetDefaultPrefer'/>
</word>
+ <word name='dependant'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='depending'>
<ref name='xmlIsID'/>
<ref name='xmlIsRef'/>
@@ -21266,6 +21299,9 @@
<ref name='_xmlParserCtxt'/>
<ref name='xmlParseURIRaw'/>
</word>
+ <word name='disables'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='disabling'>
<ref name='xmlNoNetExternalEntityLoader'/>
</word>
@@ -21499,6 +21535,9 @@
<word name='edition'>
<ref name='xmlCheckLanguageID'/>
</word>
+ <word name='effect'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='effective'>
<ref name='xmlLoadCatalog'/>
<ref name='xmlLoadCatalogs'/>
@@ -21601,6 +21640,9 @@
<ref name='xmlSaveFile'/>
<ref name='xmlSaveFormatFile'/>
</word>
+ <word name='enables'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='enabling'>
<ref name='xmlLineNumbersDefault'/>
<ref name='xmlPedanticParserDefault'/>
@@ -22396,6 +22438,7 @@
</word>
<word name='for:'>
<ref name='xmlSchemaGetCanonValue'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='forbid'>
<ref name='XML_XPATH_NOVAR'/>
@@ -22499,6 +22542,7 @@
</word>
<word name='frees'>
<ref name='xmlBufferFree'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='front'>
<ref name='xmlValidateNCName'/>
@@ -23650,6 +23694,7 @@
<ref name='xmlRelaxNGNewDocParserCtxt'/>
<ref name='xmlRemoveID'/>
<ref name='xmlRemoveRef'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='interned'>
<ref name='xmlPatterncompile'/>
@@ -24429,6 +24474,7 @@
<ref name='xmlExpMaxToken'/>
<ref name='xmlExpNewCtxt'/>
<ref name='xmlPatternMaxDepth'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='maybe'>
<ref name='_xmlSchemaElement'/>
@@ -24566,6 +24612,9 @@
<word name='minute'>
<ref name='ftpListCallback'/>
</word>
+ <word name='misc'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='misleading'>
<ref name='xmlParsePEReference'/>
<ref name='xmlParserHandlePEReference'/>
@@ -25147,7 +25196,9 @@
<ref name='xmlXPathStringFunction'/>
</word>
<word name='objects'>
+ <ref name='_xmlXPathContext'/>
<ref name='xmlXPathCompareValues'/>
+ <ref name='xmlXPathContextSetCache'/>
<ref name='xmlXPathDivValues'/>
<ref name='xmlXPathEqualValues'/>
<ref name='xmlXPathFreeNodeSetList'/>
@@ -25416,6 +25467,7 @@
<ref name='xmlSaveToFilename'/>
<ref name='xmlSaveToIO'/>
<ref name='xmlTextReaderSchemaValidateCtxt'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='ordered'>
<ref name='xmlListAppend'/>
@@ -25725,6 +25777,7 @@
<ref name='xmlGetLastError'/>
<ref name='xmlParseAttributeType'/>
<ref name='xmlValidateElementDecl'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='performance'>
<ref name='xmlGetBufferAllocationScheme'/>
@@ -27125,11 +27178,17 @@
<word name='returning'>
<ref name='xmlXPathStringFunction'/>
</word>
+ <word name='reusal'>
+ <ref name='_xmlXPathContext'/>
+ </word>
<word name='reuse'>
<ref name='xmlReconciliateNs'/>
<ref name='xmlRegExecPushString'/>
<ref name='xmlRegExecPushString2'/>
</word>
+ <word name='reused'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='reuses'>
<ref name='htmlCtxtReadDoc'/>
<ref name='htmlCtxtReadFd'/>
@@ -27449,6 +27508,9 @@
<ref name='xmlAutomataNewNegTrans'/>
<ref name='xmlXPathNodeSetFreeNs'/>
</word>
+ <word name='semantics'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='sense'>
<ref name='xmlCreateEntitiesTable'/>
</word>
@@ -27565,6 +27627,7 @@
</word>
<word name='setting'>
<ref name='xmlSetGenericErrorFunc'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='setups'>
<ref name='xmlParseEncodingDecl'/>
@@ -27751,6 +27814,12 @@
<ref name='xmlParseElementMixedContentDecl'/>
<ref name='xmlSkipBlankChars'/>
</word>
+ <word name='slot'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
+ <word name='slots'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='smallest'>
<ref name='xmlXPathCeilingFunction'/>
</word>
@@ -28377,6 +28446,7 @@
<ref name='xmlHashUpdateEntry3'/>
<ref name='xmlSchemaValueAppend'/>
<ref name='xmlXPathCompareValues'/>
+ <ref name='xmlXPathContextSetCache'/>
</word>
<word name='succeeds'>
<ref name='xmlCheckFilename'/>
@@ -30698,6 +30768,9 @@
<word name='xmlXPathNodeTrailingSorted'>
<ref name='xmlXPathNodeTrailing'/>
</word>
+ <word name='xmlXPathObject'>
+ <ref name='xmlXPathContextSetCache'/>
+ </word>
<word name='xmlXPathObjectPtr'>
<ref name='xmlXPathCompiledEval'/>
<ref name='xmlXPathEval'/>
diff --git a/doc/libxml2.xsa b/doc/libxml2.xsa
index 65374b22..5dd19baa 100644
--- a/doc/libxml2.xsa
+++ b/doc/libxml2.xsa
@@ -8,51 +8,32 @@
</vendor>
<product id="libxml2">
<name>libxml2</name>
- <version>2.6.23</version>
- <last-release> Jan 5 2006</last-release>
+ <version>2.6.24</version>
+ <last-release> Apr 28 2006</last-release>
<info-url>http://xmlsoft.org/</info-url>
- <changes> - portability fixes: Windows (Rob Richards), getaddrinfo on Windows
- (Kolja Nowak, Rob Richards), icc warnings (Kjartan Maraas),
- --with-minimum compilation fixes (William Brack), error case handling fix
- on Solaris (Albert Chin), don't use 'list' as parameter name reported by
- Samuel Diaz Garcia, more old Unices portability fixes (Albert Chin),
- MinGW compilation (Mark Junker), HP-UX compiler warnings (Rick
- Jones),
- - code cleanup: xmlReportError (Adrian Mouat), remove xmlBufferClose
- (Geert Jansen), unreachable code (Oleksandr Kononenko), refactoring
- parsing code (Bjorn Reese)
- - bug fixes: xmlBuildRelativeURI and empty path (William Brack),
- combinatory explosion and performances in regexp code, leak in
- xmlTextReaderReadString(), xmlStringLenDecodeEntities problem (Massimo
- Morara), Identity Constraints bugs and a segfault (Kasimier Buchcik),
- XPath pattern based evaluation bugs (DV &amp; Kasimier),
- xmlSchemaContentModelDump() memory leak (Kasimier), potential leak in
- xmlSchemaCheckCSelectorXPath(), xmlTextWriterVSprintf() misuse of
- vsnprintf (William Brack), XHTML serialization fix (Rob Richards), CRLF
- split problem (William), issues with non-namespaced attributes in
- xmlAddChild() xmlAddNextSibling() and xmlAddPrevSibling() (Rob Richards),
- HTML parsing of script, Python must not output to stdout (Nic Ferrier),
- exclusive C14N namespace visibility (Aleksey Sanin), XSD dataype
- totalDigits bug (Kasimier Buchcik), error handling when writing to an
- xmlBuffer (Rob Richards), runtest schemas error not reported (Hisashi
- Fujinaka), signed/unsigned problem in date/time code (Albert Chin), fix
- XSI driven XSD validation (Kasimier), parsing of xs:decimal (Kasimier),
- fix DTD writer output (Rob Richards), leak in xmlTextReaderReadInnerXml
- (Gary Coady), regexp bug affecting schemas (Kasimier), configuration of
- runtime debugging (Kasimier), xmlNodeBufGetContent bug on entity refs
- (Oleksandr Kononenko), xmlRegExecPushString2 bug (Sreeni Nair),
- compilation and build fixes (Michael Day), removed dependancies on
- xmlSchemaValidError (Kasimier), bug with &lt;xml:foo/&gt;, more XPath
- pattern based evaluation fixes (Kasimier)
- - improvements: XSD Schemas redefinitions/restrictions (Kasimier
- Buchcik), node copy checks and fix for attribute (Rob Richards), counted
- transition bug in regexps, ctxt-&gt;standalone = -2 to indicate no
- standalone attribute was found, add xmlSchemaSetParserStructuredErrors()
- (Kasimier Buchcik), add xmlTextReaderSchemaValidateCtxt() to API
- (Kasimier), handle gzipped HTTP resources (Gary Coady), add
- htmlDocDumpMemoryFormat. (Rob Richards),
- - documentation: typo (Michael Day), libxml man page (Albert Chin), save
- function to XML buffer (Geert Jansen), small doc fix (Aron Stansvik),
+ <changes> - Portability fixes: configure on Windows, testapi compile on
+ windows(Kasimier Buchcik, venkat naidu), Borland C++ 6 compile (Eric
+ Zurcher),HP-UX compiler workaround (Rick Jones), xml2-config bugfix,
+ gcc-4.1cleanups, Python detection scheme (Joseph Sacco), UTF-8 file paths
+ onWindows (Roland Schwingel).
+ - Improvements: xmlDOMWrapReconcileNamespaces xmlDOMWrapCloneNode
+ (KasimierBuchcik), XML catalog debugging (Rick Jones), update to Unicode
+ 4.01.
+ - Bug fixes: xmlParseChunk() problem in 2.6.23, xmlParseInNodeContext()on
+ HTML docs, URI behaviour on Windows (Rob Richards), comment streamingbug,
+ xmlParseComment (with William Brack), regexp bug fixes (DV &amp;Youri
+ Golovanov), xmlGetNodePath on text/CDATA (Kasimier),one Relax-NG
+ interleave bug, xmllint --path and --valid,XSD bugfixes (Kasimier),
+ remove debugleft in Python bindings (Nic Ferrier), xmlCatalogAdd bug
+ (Martin Cole),xmlSetProp fixes (Rob Richards), HTML IDness (Rob
+ Richards), a largenumber of cleanups and small fixes based on Coverity
+ reports, bugin character ranges, Unicode tables const (Aivars Kalvans),
+ schemasfix (Stefan Kost), xmlRelaxNGParse error
+ deallocation,xmlSchemaAddSchemaDoc error deallocation, error handling on
+ unallowedcode point, ixmllint --nonet to never reach the net (Gary
+ Coady),line break in writer after end PI (Jason Viers).
+ - Documentation: man pages updates and cleanups (Daniel Leidert).
+ - New features: Relax NG structure error handlers.
</changes>
</product>
diff --git a/doc/namespaces.html b/doc/namespaces.html
index 32c7787e..463bc48c 100644
--- a/doc/namespaces.html
+++ b/doc/namespaces.html
@@ -7,44 +7,44 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Namespaces</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Namespaces</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>The libxml2 library implements <a href="http://www.w3.org/TR/REC-xml-names/">XML namespaces</a> support by
-recognizing namespace constructs in the input, and does namespace lookup
-automatically when building the DOM tree. A namespace declaration is
-associated with an in-memory structure and all elements or attributes within
-that namespace point to it. Hence testing the namespace is a simple and fast
-equality operation at the user level.</p><p>I suggest that people using libxml2 use a namespace, and declare it in the
-root element of their document as the default namespace. Then they don't need
-to use the prefix in the content but we will have a basis for future semantic
-refinement and merging of data from different sources. This doesn't increase
-the size of the XML output significantly, but significantly increases its
-value in the long-term. Example:</p><pre>&lt;mydoc xmlns="http://mydoc.example.org/schemas/"&gt;
+</style><title>Namespaces</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Namespaces</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>The libxml2 library implements <a href="http://www.w3.org/TR/REC-xml-names/">XML namespaces</a>support
+byrecognizing namespace constructs in the input, and does namespace
+lookupautomatically when building the DOM tree. A namespace declaration
+isassociated with an in-memory structure and all elements or attributes
+withinthat namespace point to it. Hence testing the namespace is a simple and
+fastequality operation at the user level.</p><p>I suggest that people using libxml2 use a namespace, and declare it in
+theroot element of their document as the default namespace. Then they don't
+needto use the prefix in the content but we will have a basis for future
+semanticrefinement and merging of data from different sources. This doesn't
+increasethe size of the XML output significantly, but significantly increases
+itsvalue in the long-term. Example:</p><pre>&lt;mydoc xmlns="http://mydoc.example.org/schemas/"&gt;
&lt;elem1&gt;...&lt;/elem1&gt;
&lt;elem2&gt;...&lt;/elem2&gt;
-&lt;/mydoc&gt;</pre><p>The namespace value has to be an absolute URL, but the URL doesn't have to
-point to any existing resource on the Web. It will bind all the element and
-attributes with that URL. I suggest to use an URL within a domain you
-control, and that the URL should contain some kind of version information if
-possible. For example, <code>"http://www.gnome.org/gnumeric/1.0/"</code> is a
-good namespace scheme.</p><p>Then when you load a file, make sure that a namespace carrying the
-version-independent prefix is installed on the root element of your document,
-and if the version information don't match something you know, warn the user
-and be liberal in what you accept as the input. Also do *not* try to base
-namespace checking on the prefix value. &lt;foo:text&gt; may be exactly the
-same as &lt;bar:text&gt; in another document. What really matters is the URI
-associated with the element or the attribute, not the prefix string (which is
-just a shortcut for the full URI). In libxml, element and attributes have an
-<code>ns</code> field pointing to an xmlNs structure detailing the namespace
-prefix and its URI.</p><p>@@Interfaces@@</p><pre>xmlNodePtr node;
+&lt;/mydoc&gt;</pre><p>The namespace value has to be an absolute URL, but the URL doesn't have
+topoint to any existing resource on the Web. It will bind all the element
+andattributes with that URL. I suggest to use an URL within a domain
+youcontrol, and that the URL should contain some kind of version information
+ifpossible. For example, <code>"http://www.gnome.org/gnumeric/1.0/"</code>is
+agood namespace scheme.</p><p>Then when you load a file, make sure that a namespace carrying
+theversion-independent prefix is installed on the root element of your
+document,and if the version information don't match something you know, warn
+the userand be liberal in what you accept as the input. Also do *not* try to
+basenamespace checking on the prefix value. &lt;foo:text&gt; may be exactly
+thesame as &lt;bar:text&gt; in another document. What really matters is the
+URIassociated with the element or the attribute, not the prefix string (which
+isjust a shortcut for the full URI). In libxml, element and attributes have
+an<code>ns</code>field pointing to an xmlNs structure detailing the
+namespaceprefix and its URI.</p><p>@@Interfaces@@</p><pre>xmlNodePtr node;
if(!strncmp(node-&gt;name,"mytag",5)
&amp;&amp; node-&gt;ns
&amp;&amp; !strcmp(node-&gt;ns-&gt;href,"http://www.mysite.com/myns/1.0")) {
...
-}</pre><p>Usually people object to using namespaces together with validity checking.
-I will try to make sure that using namespaces won't break validity checking,
-so even if you plan to use or currently are using validation I strongly
-suggest adding namespaces to your document. A default namespace scheme
-<code>xmlns="http://...."</code> should not break validity even on less
-flexible parsers. Using namespaces to mix and differentiate content coming
-from multiple DTDs will certainly break current validation schemes. To check
-such documents one needs to use schema-validation, which is supported in
-libxml2 as well. See <a href="http://www.relaxng.org/">relagx-ng</a> and <a href="http://www.w3c.org/XML/Schema">w3c-schema</a>.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+}</pre><p>Usually people object to using namespaces together with validity
+checking.I will try to make sure that using namespaces won't break validity
+checking,so even if you plan to use or currently are using validation I
+stronglysuggest adding namespaces to your document. A default namespace
+scheme<code>xmlns="http://...."</code>should not break validity even on
+lessflexible parsers. Using namespaces to mix and differentiate content
+comingfrom multiple DTDs will certainly break current validation schemes. To
+checksuch documents one needs to use schema-validation, which is supported
+inlibxml2 as well. See <a href="http://www.relaxng.org/">relagx-ng</a>and <a href="http://www.w3c.org/XML/Schema">w3c-schema</a>.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/news.html b/doc/news.html
index a75db522..47fc8862 100644
--- a/doc/news.html
+++ b/doc/news.html
@@ -7,470 +7,483 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Releases</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Releases</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Items not finished and worked on, get in touch with the list if you want
-to help those</p><ul><li>More testing on RelaxNG</li>
- <li>Finishing up <a href="http://www.w3.org/TR/xmlschema-1/">XML
- Schemas</a></li>
-</ul><p>The <a href="ChangeLog.html">change log</a> describes the recents commits
-to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p><p>There is the list of public releases:</p><h3>2.6.24: Apr 28 2006</h3><ul><li>Portability fixes: configure on Windows, testapi compile on windows
- (Kasimier Buchcik, venkat naidu), Borland C++ 6 compile (Eric Zurcher),
- HP-UX compiler workaround (Rick Jones), xml2-config bugfix, gcc-4.1
- cleanups, Python detection scheme (Joseph Sacco), UTF-8 file paths on
- Windows (Roland Schwingel).
- </li>
- <li>Improvements: xmlDOMWrapReconcileNamespaces xmlDOMWrapCloneNode (Kasimier
- Buchcik), XML catalog debugging (Rick Jones), update to Unicode 4.01.</li>
- <li>Bug fixes: xmlParseChunk() problem in 2.6.23, xmlParseInNodeContext()
- on HTML docs, URI behaviour on Windows (Rob Richards), comment streaming
- bug, xmlParseComment (with William Brack), regexp bug fixes (DV &amp;
- Youri Golovanov), xmlGetNodePath on text/CDATA (Kasimier),
- one Relax-NG interleave bug, xmllint --path and --valid,
- XSD bugfixes (Kasimier), remove debug
- left in Python bindings (Nic Ferrier), xmlCatalogAdd bug (Martin Cole),
- xmlSetProp fixes (Rob Richards), HTML IDness (Rob Richards), a large
- number of cleanups and small fixes based on Coverity reports, bug
- in character ranges, Unicode tables const (Aivars Kalvans), schemas
- fix (Stefan Kost), xmlRelaxNGParse error deallocation,
- xmlSchemaAddSchemaDoc error deallocation, error handling on unallowed
- code point, ixmllint --nonet to never reach the net (Gary Coady),
- line break in writer after end PI (Jason Viers). </li>
+</style><title>Releases</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Releases</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="html/index.html">Reference Manual</a></li><li><a href="intro.html">Introduction</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="docs.html" style="font-weight:bold">Developer Menu</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="help.html">How to help</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="news.html">Releases</a></li><li><a href="XMLinfo.html">XML</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="xmldtd.html">Validation &amp; DTDs</a></li><li><a href="encoding.html">Encodings support</a></li><li><a href="catalog.html">Catalog support</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="contribs.html">Contributions</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="html/index.html" style="font-weight:bold">API Menu</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Items not finished and worked on, get in touch with the list if you wantto
+help those</p><ul><li>More testing on RelaxNG</li>
+ <li>Finishing up <a href="http://www.w3.org/TR/xmlschema-1/">XMLSchemas</a></li>
+</ul><p>The <a href="ChangeLog.html">change log</a>describes the recents commitsto
+the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a>code base.</p><p>There is the list of public releases:</p><h3>2.6.25: Jun 6 2006</h3><ul><li>portability fixes: Python detection (Joseph Sacco), compilation error
+ (William Brack and Graham Bennett), LynxOS patch (Olli Savia)</li>
+ <li>bug fixes: encoding buffer problem, mix of code and data in xmlIO.c
+ (Kjartan Maraas), entities in XSD validation (Kasimier Buchcik), various
+ XSD validation fixes (Kasimier), memory leak in pattern (Rob Richards and
+ Kasimier), attribute with colon in name (Rob Richards), XPath leak in
+ error reporting (Aleksey Sanin), XInclude text include of self
+ document.</li>
+ <li>improvements: Xpath optimizations (Kasimier), XPath object cache
+ (Kasimier), </li>
+</ul><h3>2.6.24: Apr 28 2006</h3><ul><li>Portability fixes: configure on Windows, testapi compile on
+ windows(Kasimier Buchcik, venkat naidu), Borland C++ 6 compile (Eric
+ Zurcher),HP-UX compiler workaround (Rick Jones), xml2-config bugfix,
+ gcc-4.1cleanups, Python detection scheme (Joseph Sacco), UTF-8 file paths
+ onWindows (Roland Schwingel).</li>
+ <li>Improvements: xmlDOMWrapReconcileNamespaces xmlDOMWrapCloneNode
+ (KasimierBuchcik), XML catalog debugging (Rick Jones), update to Unicode
+ 4.01.</li>
+ <li>Bug fixes: xmlParseChunk() problem in 2.6.23, xmlParseInNodeContext()on
+ HTML docs, URI behaviour on Windows (Rob Richards), comment streamingbug,
+ xmlParseComment (with William Brack), regexp bug fixes (DV &amp;Youri
+ Golovanov), xmlGetNodePath on text/CDATA (Kasimier),one Relax-NG
+ interleave bug, xmllint --path and --valid,XSD bugfixes (Kasimier),
+ remove debugleft in Python bindings (Nic Ferrier), xmlCatalogAdd bug
+ (Martin Cole),xmlSetProp fixes (Rob Richards), HTML IDness (Rob
+ Richards), a largenumber of cleanups and small fixes based on Coverity
+ reports, bugin character ranges, Unicode tables const (Aivars Kalvans),
+ schemasfix (Stefan Kost), xmlRelaxNGParse error
+ deallocation,xmlSchemaAddSchemaDoc error deallocation, error handling on
+ unallowedcode point, ixmllint --nonet to never reach the net (Gary
+ Coady),line break in writer after end PI (Jason Viers).</li>
<li>Documentation: man pages updates and cleanups (Daniel Leidert).</li>
<li>New features: Relax NG structure error handlers.</li>
-</ul><h3>2.6.23: Jan 5 2006</h3><ul><li>portability fixes: Windows (Rob Richards), getaddrinfo on Windows
- (Kolja Nowak, Rob Richards), icc warnings (Kjartan Maraas),
- --with-minimum compilation fixes (William Brack), error case handling fix
- on Solaris (Albert Chin), don't use 'list' as parameter name reported by
- Samuel Diaz Garcia, more old Unices portability fixes (Albert Chin),
- MinGW compilation (Mark Junker), HP-UX compiler warnings (Rick
- Jones),</li>
- <li>code cleanup: xmlReportError (Adrian Mouat), remove xmlBufferClose
- (Geert Jansen), unreachable code (Oleksandr Kononenko), refactoring
- parsing code (Bjorn Reese)</li>
- <li>bug fixes: xmlBuildRelativeURI and empty path (William Brack),
- combinatory explosion and performances in regexp code, leak in
- xmlTextReaderReadString(), xmlStringLenDecodeEntities problem (Massimo
- Morara), Identity Constraints bugs and a segfault (Kasimier Buchcik),
- XPath pattern based evaluation bugs (DV &amp; Kasimier),
- xmlSchemaContentModelDump() memory leak (Kasimier), potential leak in
- xmlSchemaCheckCSelectorXPath(), xmlTextWriterVSprintf() misuse of
- vsnprintf (William Brack), XHTML serialization fix (Rob Richards), CRLF
- split problem (William), issues with non-namespaced attributes in
- xmlAddChild() xmlAddNextSibling() and xmlAddPrevSibling() (Rob Richards),
- HTML parsing of script, Python must not output to stdout (Nic Ferrier),
- exclusive C14N namespace visibility (Aleksey Sanin), XSD dataype
- totalDigits bug (Kasimier Buchcik), error handling when writing to an
- xmlBuffer (Rob Richards), runtest schemas error not reported (Hisashi
- Fujinaka), signed/unsigned problem in date/time code (Albert Chin), fix
- XSI driven XSD validation (Kasimier), parsing of xs:decimal (Kasimier),
- fix DTD writer output (Rob Richards), leak in xmlTextReaderReadInnerXml
- (Gary Coady), regexp bug affecting schemas (Kasimier), configuration of
- runtime debugging (Kasimier), xmlNodeBufGetContent bug on entity refs
- (Oleksandr Kononenko), xmlRegExecPushString2 bug (Sreeni Nair),
- compilation and build fixes (Michael Day), removed dependancies on
- xmlSchemaValidError (Kasimier), bug with &lt;xml:foo/&gt;, more XPath
- pattern based evaluation fixes (Kasimier)</li>
- <li>improvements: XSD Schemas redefinitions/restrictions (Kasimier
- Buchcik), node copy checks and fix for attribute (Rob Richards), counted
- transition bug in regexps, ctxt-&gt;standalone = -2 to indicate no
- standalone attribute was found, add xmlSchemaSetParserStructuredErrors()
- (Kasimier Buchcik), add xmlTextReaderSchemaValidateCtxt() to API
- (Kasimier), handle gzipped HTTP resources (Gary Coady), add
- htmlDocDumpMemoryFormat. (Rob Richards),</li>
- <li>documentation: typo (Michael Day), libxml man page (Albert Chin), save
- function to XML buffer (Geert Jansen), small doc fix (Aron Stansvik),</li>
+</ul><h3>2.6.23: Jan 5 2006</h3><ul><li>portability fixes: Windows (Rob Richards), getaddrinfo on Windows(Kolja
+ Nowak, Rob Richards), icc warnings (Kjartan Maraas),--with-minimum
+ compilation fixes (William Brack), error case handling fixon Solaris
+ (Albert Chin), don't use 'list' as parameter name reported bySamuel Diaz
+ Garcia, more old Unices portability fixes (Albert Chin),MinGW compilation
+ (Mark Junker), HP-UX compiler warnings (RickJones),</li>
+ <li>code cleanup: xmlReportError (Adrian Mouat), remove
+ xmlBufferClose(Geert Jansen), unreachable code (Oleksandr Kononenko),
+ refactoringparsing code (Bjorn Reese)</li>
+ <li>bug fixes: xmlBuildRelativeURI and empty path (William
+ Brack),combinatory explosion and performances in regexp code, leak
+ inxmlTextReaderReadString(), xmlStringLenDecodeEntities problem
+ (MassimoMorara), Identity Constraints bugs and a segfault (Kasimier
+ Buchcik),XPath pattern based evaluation bugs (DV &amp;
+ Kasimier),xmlSchemaContentModelDump() memory leak (Kasimier), potential
+ leak inxmlSchemaCheckCSelectorXPath(), xmlTextWriterVSprintf() misuse
+ ofvsnprintf (William Brack), XHTML serialization fix (Rob Richards),
+ CRLFsplit problem (William), issues with non-namespaced attributes
+ inxmlAddChild() xmlAddNextSibling() and xmlAddPrevSibling() (Rob
+ Richards),HTML parsing of script, Python must not output to stdout (Nic
+ Ferrier),exclusive C14N namespace visibility (Aleksey Sanin), XSD
+ dataypetotalDigits bug (Kasimier Buchcik), error handling when writing to
+ anxmlBuffer (Rob Richards), runtest schemas error not reported
+ (HisashiFujinaka), signed/unsigned problem in date/time code (Albert
+ Chin), fixXSI driven XSD validation (Kasimier), parsing of xs:decimal
+ (Kasimier),fix DTD writer output (Rob Richards), leak in
+ xmlTextReaderReadInnerXml(Gary Coady), regexp bug affecting schemas
+ (Kasimier), configuration ofruntime debugging (Kasimier),
+ xmlNodeBufGetContent bug on entity refs(Oleksandr Kononenko),
+ xmlRegExecPushString2 bug (Sreeni Nair),compilation and build fixes
+ (Michael Day), removed dependancies onxmlSchemaValidError (Kasimier), bug
+ with &lt;xml:foo/&gt;, more XPathpattern based evaluation fixes
+ (Kasimier)</li>
+ <li>improvements: XSD Schemas redefinitions/restrictions (KasimierBuchcik),
+ node copy checks and fix for attribute (Rob Richards), countedtransition
+ bug in regexps, ctxt-&gt;standalone = -2 to indicate nostandalone
+ attribute was found, add xmlSchemaSetParserStructuredErrors()(Kasimier
+ Buchcik), add xmlTextReaderSchemaValidateCtxt() to API(Kasimier), handle
+ gzipped HTTP resources (Gary Coady), addhtmlDocDumpMemoryFormat. (Rob
+ Richards),</li>
+ <li>documentation: typo (Michael Day), libxml man page (Albert Chin),
+ savefunction to XML buffer (Geert Jansen), small doc fix (Aron
+ Stansvik),</li>
</ul><h3>2.6.22: Sep 12 2005</h3><ul><li>build fixes: compile without schematron (Stéphane Bidoul)</li>
- <li>bug fixes: xmlDebugDumpNode on namespace node (Oleg Paraschenko)i,
- CDATA push parser bug, xmlElemDump problem with XHTML1 doc,
- XML_FEATURE_xxx clash with expat headers renamed XML_WITH_xxx, fix some
- output formatting for meta element (Rob Richards), script and style
- XHTML1 serialization (David Madore), Attribute derivation fixups in XSD
- (Kasimier Buchcik), better IDC error reports (Kasimier Buchcik)</li>
- <li>improvements: add XML_SAVE_NO_EMPTY xmlSaveOption (Rob Richards), add
- XML_SAVE_NO_XHTML xmlSaveOption, XML Schemas improvements preparing for
- derive (Kasimier Buchcik).</li>
- <li>documentation: generation of gtk-doc like docs, integration with
- devhelp.</li>
-</ul><h3>2.6.21: Sep 4 2005</h3><ul><li>build fixes: Cygwin portability fixes (Gerrit P. Haase), calling
- convention problems on Windows (Marcus Boerger), cleanups based on Linus'
- sparse tool, update of win32/configure.js (Rob Richards), remove warnings
- on Windows(Marcus Boerger), compilation without SAX1, detection of the
- Python binary, use $GCC inestad of $CC = 'gcc' (Andrew W. Nosenko),
- compilation/link with threads and old gcc, compile problem by C370 on
- Z/OS,</li>
- <li>bug fixes: http_proxy environments (Peter Breitenlohner), HTML UTF-8
- bug (Jiri Netolicky), XPath NaN compare bug (William Brack),
- htmlParseScript potential bug, Schemas regexp handling of spaces, Base64
- Schemas comparisons NIST passes, automata build error xsd:all,
- xmlGetNodePath for namespaced attributes (Alexander Pohoyda), xmlSchemas
- foreign namespaces handling, XML Schemas facet comparison (Kupriyanov
- Anatolij), xmlSchemaPSimpleTypeErr error report (Kasimier Buchcik), xml:
- namespace ahndling in Schemas (Kasimier), empty model group in Schemas
- (Kasimier), wilcard in Schemas (Kasimier), URI composition (William),
- xs:anyType in Schemas (Kasimier), Python resolver emmitting error
- messages directly, Python xmlAttr.parent (Jakub Piotr Clapa), trying to
- fix the file path/URI conversion, xmlTextReaderGetAttribute fix (Rob
- Richards), xmlSchemaFreeAnnot memleak (Kasimier), HTML UTF-8
- serialization, streaming XPath, Schemas determinism detection problem,
- XInclude bug, Schemas context type (Dean Hill), validation fix (Derek
- Poon), xmlTextReaderGetAttribute[Ns] namespaces (Rob Richards), Schemas
- type fix (Kuba Nowakowski), UTF-8 parser bug, error in encoding handling,
- xmlGetLineNo fixes, bug on entities handling, entity name extraction in
- error handling with XInclude, text nodes in HTML body tags (Gary Coady),
- xml:id and IDness at the treee level fixes, XPath streaming patterns
- bugs.</li>
- <li>improvements: structured interfaces for schemas and RNG error reports
- (Marcus Boerger), optimization of the char data inner loop parsing
- (thanks to Behdad Esfahbod for the idea), schematron validation though
- not finished yet, xmlSaveOption to omit XML declaration, keyref match
- error reports (Kasimier), formal expression handling code not plugged
- yet, more lax mode for the HTML parser, parser XML_PARSE_COMPACT option
- for text nodes allocation.</li>
+ <li>bug fixes: xmlDebugDumpNode on namespace node (Oleg Paraschenko)i,CDATA
+ push parser bug, xmlElemDump problem with XHTML1 doc,XML_FEATURE_xxx
+ clash with expat headers renamed XML_WITH_xxx, fix someoutput formatting
+ for meta element (Rob Richards), script and styleXHTML1 serialization
+ (David Madore), Attribute derivation fixups in XSD(Kasimier Buchcik),
+ better IDC error reports (Kasimier Buchcik)</li>
+ <li>improvements: add XML_SAVE_NO_EMPTY xmlSaveOption (Rob Richards),
+ addXML_SAVE_NO_XHTML xmlSaveOption, XML Schemas improvements preparing
+ forderive (Kasimier Buchcik).</li>
+ <li>documentation: generation of gtk-doc like docs, integration
+ withdevhelp.</li>
+</ul><h3>2.6.21: Sep 4 2005</h3><ul><li>build fixes: Cygwin portability fixes (Gerrit P. Haase),
+ callingconvention problems on Windows (Marcus Boerger), cleanups based on
+ Linus'sparse tool, update of win32/configure.js (Rob Richards), remove
+ warningson Windows(Marcus Boerger), compilation without SAX1, detection
+ of thePython binary, use $GCC inestad of $CC = 'gcc' (Andrew W.
+ Nosenko),compilation/link with threads and old gcc, compile problem by
+ C370 onZ/OS,</li>
+ <li>bug fixes: http_proxy environments (Peter Breitenlohner), HTML UTF-8bug
+ (Jiri Netolicky), XPath NaN compare bug (William Brack),htmlParseScript
+ potential bug, Schemas regexp handling of spaces, Base64Schemas
+ comparisons NIST passes, automata build error xsd:all,xmlGetNodePath for
+ namespaced attributes (Alexander Pohoyda), xmlSchemasforeign namespaces
+ handling, XML Schemas facet comparison (KupriyanovAnatolij),
+ xmlSchemaPSimpleTypeErr error report (Kasimier Buchcik), xml:namespace
+ ahndling in Schemas (Kasimier), empty model group in Schemas(Kasimier),
+ wilcard in Schemas (Kasimier), URI composition (William),xs:anyType in
+ Schemas (Kasimier), Python resolver emmitting errormessages directly,
+ Python xmlAttr.parent (Jakub Piotr Clapa), trying tofix the file path/URI
+ conversion, xmlTextReaderGetAttribute fix (RobRichards),
+ xmlSchemaFreeAnnot memleak (Kasimier), HTML UTF-8serialization, streaming
+ XPath, Schemas determinism detection problem,XInclude bug, Schemas
+ context type (Dean Hill), validation fix (DerekPoon),
+ xmlTextReaderGetAttribute[Ns] namespaces (Rob Richards), Schemastype fix
+ (Kuba Nowakowski), UTF-8 parser bug, error in encoding
+ handling,xmlGetLineNo fixes, bug on entities handling, entity name
+ extraction inerror handling with XInclude, text nodes in HTML body tags
+ (Gary Coady),xml:id and IDness at the treee level fixes, XPath streaming
+ patternsbugs.</li>
+ <li>improvements: structured interfaces for schemas and RNG error
+ reports(Marcus Boerger), optimization of the char data inner loop
+ parsing(thanks to Behdad Esfahbod for the idea), schematron validation
+ thoughnot finished yet, xmlSaveOption to omit XML declaration, keyref
+ matcherror reports (Kasimier), formal expression handling code not
+ pluggedyet, more lax mode for the HTML parser, parser XML_PARSE_COMPACT
+ optionfor text nodes allocation.</li>
<li>documentation: xmllint man page had --nonet duplicated</li>
-</ul><h3>2.6.20: Jul 10 2005</h3><ul><li>build fixes: Windows build (Rob Richards), Mingw compilation (Igor
- Zlatkovic), Windows Makefile (Igor), gcc warnings (Kasimier and
- andriy@google.com), use gcc weak references to pthread to avoid the
- pthread dependancy on Linux, compilation problem (Steve Nairn), compiling
- of subset (Morten Welinder), IPv6/ss_family compilation (William Brack),
- compilation when disabling parts of the library, standalone test
- distribution.</li>
- <li>bug fixes: bug in lang(), memory cleanup on errors (William Brack),
- HTTP query strings (Aron Stansvik), memory leak in DTD (William), integer
- overflow in XPath (William), nanoftp buffer size, pattern "." apth fixup
- (Kasimier), leak in tree reported by Malcolm Rowe, replaceNode patch
- (Brent Hendricks), CDATA with NULL content (Mark Vakoc), xml:base fixup
- on XInclude (William), pattern fixes (William), attribute bug in
- exclusive c14n (Aleksey Sanin), xml:space and xml:lang with SAX2 (Rob
- Richards), namespace trouble in complex parsing (Malcolm Rowe), XSD type
- QNames fixes (Kasimier), XPath streaming fixups (William), RelaxNG bug
- (Rob Richards), Schemas for Schemas fixes (Kasimier), removal of ID (Rob
- Richards), a small RelaxNG leak, HTML parsing in push mode bug (James
- Bursa), failure to detect UTF-8 parsing bugs in CDATA sections,
- areBlanks() heuristic failure, duplicate attributes in DTD bug
- (William).</li>
- <li>improvements: lot of work on Schemas by Kasimier Buchcik both on
- conformance and streaming, Schemas validation messages (Kasimier Buchcik,
- Matthew Burgess), namespace removal at the python level (Brent
- Hendricks), Update to new Schemas regression tests from W3C/Nist
- (Kasimier), xmlSchemaValidateFile() (Kasimier), implementation of
- xmlTextReaderReadInnerXml and xmlTextReaderReadOuterXml (James Wert),
- standalone test framework and programs, new DOM import APIs
- xmlDOMWrapReconcileNamespaces() xmlDOMWrapAdoptNode() and
- xmlDOMWrapRemoveNode(), extension of xmllint capabilities for SAX and
- Schemas regression tests, xmlStopParser() available in pull mode too,
- ienhancement to xmllint --shell namespaces support, Windows port of the
- standalone testing tools (Kasimier and William),
- xmlSchemaValidateStream() xmlSchemaSAXPlug() and xmlSchemaSAXUnplug() SAX
- Schemas APIs, Schemas xmlReader support.</li>
-</ul><h3>2.6.19: Apr 02 2005</h3><ul><li>build fixes: drop .la from RPMs, --with-minimum build fix (William
- Brack), use XML_SOCKLEN_T instead of SOCKLEN_T because it breaks with AIX
- 5.3 compiler, fixed elfgcchack.h generation and PLT reduction code on
- Linux/ELF/gcc4</li>
- <li>bug fixes: schemas type decimal fixups (William Brack), xmmlint return
- code (Gerry Murphy), small schemas fixes (Matthew Burgess and GUY
- Fabrice), workaround "DAV:" namespace brokeness in c14n (Aleksey Sanin),
- segfault in Schemas (Kasimier Buchcik), Schemas attribute validation
- (Kasimier), Prop related functions and xmlNewNodeEatName (Rob Richards),
- HTML serialization of name attribute on a elements, Python error handlers
- leaks and improvement (Brent Hendricks), uninitialized variable in
- encoding code, Relax-NG validation bug, potential crash if
- gnorableWhitespace is NULL, xmlSAXParseDoc and xmlParseDoc signatures,
- switched back to assuming UTF-8 in case no encoding is given at
- serialization time</li>
- <li>improvements: lot of work on Schemas by Kasimier Buchcik on facets
- checking and also mixed handling.</li>
+</ul><h3>2.6.20: Jul 10 2005</h3><ul><li>build fixes: Windows build (Rob Richards), Mingw compilation
+ (IgorZlatkovic), Windows Makefile (Igor), gcc warnings (Kasimier
+ andandriy@google.com), use gcc weak references to pthread to avoid
+ thepthread dependancy on Linux, compilation problem (Steve Nairn),
+ compilingof subset (Morten Welinder), IPv6/ss_family compilation (William
+ Brack),compilation when disabling parts of the library, standalone
+ testdistribution.</li>
+ <li>bug fixes: bug in lang(), memory cleanup on errors (William Brack),HTTP
+ query strings (Aron Stansvik), memory leak in DTD (William),
+ integeroverflow in XPath (William), nanoftp buffer size, pattern "." apth
+ fixup(Kasimier), leak in tree reported by Malcolm Rowe, replaceNode
+ patch(Brent Hendricks), CDATA with NULL content (Mark Vakoc), xml:base
+ fixupon XInclude (William), pattern fixes (William), attribute bug
+ inexclusive c14n (Aleksey Sanin), xml:space and xml:lang with SAX2
+ (RobRichards), namespace trouble in complex parsing (Malcolm Rowe), XSD
+ typeQNames fixes (Kasimier), XPath streaming fixups (William), RelaxNG
+ bug(Rob Richards), Schemas for Schemas fixes (Kasimier), removal of ID
+ (RobRichards), a small RelaxNG leak, HTML parsing in push mode bug
+ (JamesBursa), failure to detect UTF-8 parsing bugs in CDATA
+ sections,areBlanks() heuristic failure, duplicate attributes in DTD
+ bug(William).</li>
+ <li>improvements: lot of work on Schemas by Kasimier Buchcik both
+ onconformance and streaming, Schemas validation messages (Kasimier
+ Buchcik,Matthew Burgess), namespace removal at the python level
+ (BrentHendricks), Update to new Schemas regression tests from
+ W3C/Nist(Kasimier), xmlSchemaValidateFile() (Kasimier), implementation
+ ofxmlTextReaderReadInnerXml and xmlTextReaderReadOuterXml (James
+ Wert),standalone test framework and programs, new DOM import
+ APIsxmlDOMWrapReconcileNamespaces() xmlDOMWrapAdoptNode()
+ andxmlDOMWrapRemoveNode(), extension of xmllint capabilities for SAX
+ andSchemas regression tests, xmlStopParser() available in pull mode
+ too,ienhancement to xmllint --shell namespaces support, Windows port of
+ thestandalone testing tools (Kasimier and
+ William),xmlSchemaValidateStream() xmlSchemaSAXPlug() and
+ xmlSchemaSAXUnplug() SAXSchemas APIs, Schemas xmlReader support.</li>
+</ul><h3>2.6.19: Apr 02 2005</h3><ul><li>build fixes: drop .la from RPMs, --with-minimum build fix
+ (WilliamBrack), use XML_SOCKLEN_T instead of SOCKLEN_T because it breaks
+ with AIX5.3 compiler, fixed elfgcchack.h generation and PLT reduction
+ code onLinux/ELF/gcc4</li>
+ <li>bug fixes: schemas type decimal fixups (William Brack), xmmlint
+ returncode (Gerry Murphy), small schemas fixes (Matthew Burgess and
+ GUYFabrice), workaround "DAV:" namespace brokeness in c14n (Aleksey
+ Sanin),segfault in Schemas (Kasimier Buchcik), Schemas attribute
+ validation(Kasimier), Prop related functions and xmlNewNodeEatName (Rob
+ Richards),HTML serialization of name attribute on a elements, Python
+ error handlersleaks and improvement (Brent Hendricks), uninitialized
+ variable inencoding code, Relax-NG validation bug, potential crash
+ ifgnorableWhitespace is NULL, xmlSAXParseDoc and xmlParseDoc
+ signatures,switched back to assuming UTF-8 in case no encoding is given
+ atserialization time</li>
+ <li>improvements: lot of work on Schemas by Kasimier Buchcik on
+ facetschecking and also mixed handling.</li>
<li></li>
-</ul><h3>2.6.18: Mar 13 2005</h3><ul><li>build fixes: warnings (Peter Breitenlohner), testapi.c generation,
- Bakefile support (Francesco Montorsi), Windows compilation (Joel Reed),
- some gcc4 fixes, HP-UX portability fixes (Rick Jones).</li>
- <li>bug fixes: xmlSchemaElementDump namespace (Kasimier Buchcik), push and
- xmlreader stopping on non-fatal errors, thread support for dictionnaries
- reference counting (Gary Coady), internal subset and push problem, URL
- saved in xmlCopyDoc, various schemas bug fixes (Kasimier), Python paths
- fixup (Stephane Bidoul), xmlGetNodePath and namespaces, xmlSetNsProp fix
- (Mike Hommey), warning should not count as error (William Brack),
- xmlCreatePushParser empty chunk, XInclude parser flags (William), cleanup
- FTP and HTTP code to reuse the uri parsing and IPv6 (William),
- xmlTextWriterStartAttributeNS fix (Rob Richards), XMLLINT_INDENT being
- empty (William), xmlWriter bugs (Rob Richards), multithreading on Windows
- (Rich Salz), xmlSearchNsByHref fix (Kasimier), Python binding leak (Brent
- Hendricks), aliasing bug exposed by gcc4 on s390, xmlTextReaderNext bug
- (Rob Richards), Schemas decimal type fixes (William Brack),
- xmlByteConsumed static buffer (Ben Maurer).</li>
- <li>improvement: speedup parsing comments and DTDs, dictionnary support for
- hash tables, Schemas Identity constraints (Kasimier), streaming XPath
- subset, xmlTextReaderReadString added (Bjorn Reese), Schemas canonical
- values handling (Kasimier), add xmlTextReaderByteConsumed (Aron
- Stansvik),</li>
+</ul><h3>2.6.18: Mar 13 2005</h3><ul><li>build fixes: warnings (Peter Breitenlohner), testapi.c
+ generation,Bakefile support (Francesco Montorsi), Windows compilation
+ (Joel Reed),some gcc4 fixes, HP-UX portability fixes (Rick Jones).</li>
+ <li>bug fixes: xmlSchemaElementDump namespace (Kasimier Buchcik), push
+ andxmlreader stopping on non-fatal errors, thread support for
+ dictionnariesreference counting (Gary Coady), internal subset and push
+ problem, URLsaved in xmlCopyDoc, various schemas bug fixes (Kasimier),
+ Python pathsfixup (Stephane Bidoul), xmlGetNodePath and namespaces,
+ xmlSetNsProp fix(Mike Hommey), warning should not count as error (William
+ Brack),xmlCreatePushParser empty chunk, XInclude parser flags (William),
+ cleanupFTP and HTTP code to reuse the uri parsing and IPv6
+ (William),xmlTextWriterStartAttributeNS fix (Rob Richards),
+ XMLLINT_INDENT beingempty (William), xmlWriter bugs (Rob Richards),
+ multithreading on Windows(Rich Salz), xmlSearchNsByHref fix (Kasimier),
+ Python binding leak (BrentHendricks), aliasing bug exposed by gcc4 on
+ s390, xmlTextReaderNext bug(Rob Richards), Schemas decimal type fixes
+ (William Brack),xmlByteConsumed static buffer (Ben Maurer).</li>
+ <li>improvement: speedup parsing comments and DTDs, dictionnary support
+ forhash tables, Schemas Identity constraints (Kasimier), streaming
+ XPathsubset, xmlTextReaderReadString added (Bjorn Reese), Schemas
+ canonicalvalues handling (Kasimier), add xmlTextReaderByteConsumed
+ (AronStansvik),</li>
<li>Documentation: Wiki support (Joel Reed)</li>
-</ul><h3>2.6.17: Jan 16 2005</h3><ul><li>build fixes: Windows, warnings removal (William Brack),
- maintainer-clean dependency(William), build in a different directory
- (William), fixing --with-minimum configure build (William), BeOS build
- (Marcin Konicki), Python-2.4 detection (William), compilation on AIX (Dan
- McNichol)</li>
- <li>bug fixes: xmlTextReaderHasAttributes (Rob Richards), xmlCtxtReadFile()
- to use the catalog(s), loop on output (William Brack), XPath memory leak,
- ID deallocation problem (Steve Shepard), debugDumpNode crash (William),
- warning not using error callback (William), xmlStopParser bug (William),
- UTF-16 with BOM on DTDs (William), namespace bug on empty elements in
- push mode (Rob Richards), line and col computations fixups (Aleksey
- Sanin), xmlURIEscape fix (William), xmlXPathErr on bad range (William),
- patterns with too many steps, bug in RNG choice optimization, line number
- sometimes missing.</li>
- <li>improvements: XSD Schemas (Kasimier Buchcik), python generator
- (William), xmlUTF8Strpos speedup (William), unicode Python strings
- (William), XSD error reports (Kasimier Buchcik), Python __str__ call
- serialize().</li>
- <li>new APIs: added xmlDictExists(), GetLineNumber and GetColumnNumber for
- the xmlReader (Aleksey Sanin), Dynamic Shared Libraries APIs (mostly Joel
- Reed), error extraction API from regexps, new XMLSave option for format
- (Phil Shafer)</li>
- <li>documentation: site improvement (John Fleck), FAQ entries
- (William).</li>
-</ul><h3>2.6.16: Nov 10 2004</h3><ul><li>general hardening and bug fixing crossing all the API based on new
- automated regression testing</li>
+</ul><h3>2.6.17: Jan 16 2005</h3><ul><li>build fixes: Windows, warnings removal (William Brack),maintainer-clean
+ dependency(William), build in a different directory(William), fixing
+ --with-minimum configure build (William), BeOS build(Marcin Konicki),
+ Python-2.4 detection (William), compilation on AIX (DanMcNichol)</li>
+ <li>bug fixes: xmlTextReaderHasAttributes (Rob Richards),
+ xmlCtxtReadFile()to use the catalog(s), loop on output (William Brack),
+ XPath memory leak,ID deallocation problem (Steve Shepard), debugDumpNode
+ crash (William),warning not using error callback (William), xmlStopParser
+ bug (William),UTF-16 with BOM on DTDs (William), namespace bug on empty
+ elements inpush mode (Rob Richards), line and col computations fixups
+ (AlekseySanin), xmlURIEscape fix (William), xmlXPathErr on bad range
+ (William),patterns with too many steps, bug in RNG choice optimization,
+ line numbersometimes missing.</li>
+ <li>improvements: XSD Schemas (Kasimier Buchcik), python
+ generator(William), xmlUTF8Strpos speedup (William), unicode Python
+ strings(William), XSD error reports (Kasimier Buchcik), Python __str__
+ callserialize().</li>
+ <li>new APIs: added xmlDictExists(), GetLineNumber and GetColumnNumber
+ forthe xmlReader (Aleksey Sanin), Dynamic Shared Libraries APIs (mostly
+ JoelReed), error extraction API from regexps, new XMLSave option for
+ format(Phil Shafer)</li>
+ <li>documentation: site improvement (John Fleck), FAQ entries(William).</li>
+</ul><h3>2.6.16: Nov 10 2004</h3><ul><li>general hardening and bug fixing crossing all the API based on
+ newautomated regression testing</li>
<li>build fix: IPv6 build and test on AIX (Dodji Seketeli)</li>
- <li>bug fixes: problem with XML::Libxml reported by Petr Pajas, encoding
- conversion functions return values, UTF-8 bug affecting XPath reported by
- Markus Bertheau, catalog problem with NULL entries (William Brack)</li>
- <li>documentation: fix to xmllint man page, some API function descritpion
- were updated.</li>
- <li>improvements: DTD validation APIs provided at the Python level (Brent
- Hendricks)</li>
+ <li>bug fixes: problem with XML::Libxml reported by Petr Pajas,
+ encodingconversion functions return values, UTF-8 bug affecting XPath
+ reported byMarkus Bertheau, catalog problem with NULL entries (William
+ Brack)</li>
+ <li>documentation: fix to xmllint man page, some API function
+ descritpionwere updated.</li>
+ <li>improvements: DTD validation APIs provided at the Python level
+ (BrentHendricks)</li>
</ul><h3>2.6.15: Oct 27 2004</h3><ul><li>security fixes on the nanoftp and nanohttp modules</li>
- <li>build fixes: xmllint detection bug in configure, building outside the
- source tree (Thomas Fitzsimmons)</li>
- <li>bug fixes: HTML parser on broken ASCII chars in names (William), Python
- paths (Malcolm Tredinnick), xmlHasNsProp and default namespace (William),
- saving to python file objects (Malcolm Tredinnick), DTD lookup fix
- (Malcolm), save back &lt;group&gt; in catalogs (William), tree build
- fixes (DV and Rob Richards), Schemas memory bug, structured error handler
- on Python 64bits, thread local memory deallocation, memory leak reported
- by Volker Roth, xmlValidateDtd in the presence of an internal subset,
- entities and _private problem (William), xmlBuildRelativeURI error
- (William).</li>
- <li>improvements: better XInclude error reports (William), tree debugging
- module and tests, convenience functions at the Reader API (Graham
- Bennett), add support for PI in the HTML parser.</li>
-</ul><h3>2.6.14: Sep 29 2004</h3><ul><li>build fixes: configure paths for xmllint and xsltproc, compilation
- without HTML parser, compilation warning cleanups (William Brack &amp;
- Malcolm Tredinnick), VMS makefile update (Craig Berry),</li>
- <li>bug fixes: xmlGetUTF8Char (William Brack), QName properties (Kasimier
- Buchcik), XInclude testing, Notation serialization, UTF8ToISO8859x
- transcoding (Mark Itzcovitz), lots of XML Schemas cleanup and fixes
- (Kasimier), ChangeLog cleanup (Stepan Kasal), memory fixes (Mark Vakoc),
- handling of failed realloc(), out of bound array adressing in Schemas
- date handling, Python space/tabs cleanups (Malcolm Tredinnick), NMTOKENS
- E20 validation fix (Malcolm),</li>
- <li>improvements: added W3C XML Schemas testsuite (Kasimier Buchcik), add
- xmlSchemaValidateOneElement (Kasimier), Python exception hierearchy
- (Malcolm Tredinnick), Python libxml2 driver improvement (Malcolm
- Tredinnick), Schemas support for xsi:schemaLocation,
- xsi:noNamespaceSchemaLocation, xsi:type (Kasimier Buchcik)</li>
-</ul><h3>2.6.13: Aug 31 2004</h3><ul><li>build fixes: Windows and zlib (Igor Zlatkovic), -O flag with gcc,
- Solaris compiler warning, fixing RPM BuildRequires,</li>
- <li>fixes: DTD loading on Windows (Igor), Schemas error reports APIs
- (Kasimier Buchcik), Schemas validation crash, xmlCheckUTF8 (William Brack
- and Julius Mittenzwei), Schemas facet check (Kasimier), default namespace
- problem (William), Schemas hexbinary empty values, encoding error could
- genrate a serialization loop.</li>
- <li>Improvements: Schemas validity improvements (Kasimier), added --path
- and --load-trace options to xmllint</li>
+ <li>build fixes: xmllint detection bug in configure, building outside
+ thesource tree (Thomas Fitzsimmons)</li>
+ <li>bug fixes: HTML parser on broken ASCII chars in names (William),
+ Pythonpaths (Malcolm Tredinnick), xmlHasNsProp and default namespace
+ (William),saving to python file objects (Malcolm Tredinnick), DTD lookup
+ fix(Malcolm), save back &lt;group&gt; in catalogs (William), tree
+ buildfixes (DV and Rob Richards), Schemas memory bug, structured error
+ handleron Python 64bits, thread local memory deallocation, memory leak
+ reportedby Volker Roth, xmlValidateDtd in the presence of an internal
+ subset,entities and _private problem (William), xmlBuildRelativeURI
+ error(William).</li>
+ <li>improvements: better XInclude error reports (William), tree
+ debuggingmodule and tests, convenience functions at the Reader API
+ (GrahamBennett), add support for PI in the HTML parser.</li>
+</ul><h3>2.6.14: Sep 29 2004</h3><ul><li>build fixes: configure paths for xmllint and xsltproc,
+ compilationwithout HTML parser, compilation warning cleanups (William
+ Brack &amp;Malcolm Tredinnick), VMS makefile update (Craig Berry),</li>
+ <li>bug fixes: xmlGetUTF8Char (William Brack), QName properties
+ (KasimierBuchcik), XInclude testing, Notation serialization,
+ UTF8ToISO8859xtranscoding (Mark Itzcovitz), lots of XML Schemas cleanup
+ and fixes(Kasimier), ChangeLog cleanup (Stepan Kasal), memory fixes (Mark
+ Vakoc),handling of failed realloc(), out of bound array adressing in
+ Schemasdate handling, Python space/tabs cleanups (Malcolm Tredinnick),
+ NMTOKENSE20 validation fix (Malcolm),</li>
+ <li>improvements: added W3C XML Schemas testsuite (Kasimier Buchcik),
+ addxmlSchemaValidateOneElement (Kasimier), Python exception
+ hierearchy(Malcolm Tredinnick), Python libxml2 driver improvement
+ (MalcolmTredinnick), Schemas support for
+ xsi:schemaLocation,xsi:noNamespaceSchemaLocation, xsi:type (Kasimier
+ Buchcik)</li>
+</ul><h3>2.6.13: Aug 31 2004</h3><ul><li>build fixes: Windows and zlib (Igor Zlatkovic), -O flag with
+ gcc,Solaris compiler warning, fixing RPM BuildRequires,</li>
+ <li>fixes: DTD loading on Windows (Igor), Schemas error reports
+ APIs(Kasimier Buchcik), Schemas validation crash, xmlCheckUTF8 (William
+ Brackand Julius Mittenzwei), Schemas facet check (Kasimier), default
+ namespaceproblem (William), Schemas hexbinary empty values, encoding
+ error couldgenrate a serialization loop.</li>
+ <li>Improvements: Schemas validity improvements (Kasimier), added --pathand
+ --load-trace options to xmllint</li>
<li>documentation: tutorial update (John Fleck)</li>
-</ul><h3>2.6.12: Aug 22 2004</h3><ul><li>build fixes: fix --with-minimum, elfgcchack.h fixes (Peter
- Breitenlohner), perl path lookup (William), diff on Solaris (Albert
- Chin), some 64bits cleanups.</li>
- <li>Python: avoid a warning with 2.3 (William Brack), tab and space mixes
- (William), wrapper generator fixes (William), Cygwin support (Gerrit P.
- Haase), node wrapper fix (Marc-Antoine Parent), XML Schemas support
- (Torkel Lyng)</li>
+</ul><h3>2.6.12: Aug 22 2004</h3><ul><li>build fixes: fix --with-minimum, elfgcchack.h fixes
+ (PeterBreitenlohner), perl path lookup (William), diff on Solaris
+ (AlbertChin), some 64bits cleanups.</li>
+ <li>Python: avoid a warning with 2.3 (William Brack), tab and space
+ mixes(William), wrapper generator fixes (William), Cygwin support (Gerrit
+ P.Haase), node wrapper fix (Marc-Antoine Parent), XML Schemas
+ support(Torkel Lyng)</li>
<li>Schemas: a lot of bug fixes and improvements from Kasimier Buchcik</li>
- <li>fixes: RVT fixes (William), XPath context resets bug (William), memory
- debug (Steve Hay), catalog white space handling (Peter Breitenlohner),
- xmlReader state after attribute reading (William), structured error
- handler (William), XInclude generated xml:base fixup (William), Windows
- memory reallocation problem (Steve Hay), Out of Memory conditions
- handling (William and Olivier Andrieu), htmlNewDoc() charset bug,
- htmlReadMemory init (William), a posteriori validation DTD base
- (William), notations serialization missing, xmlGetNodePath (Dodji),
- xmlCheckUTF8 (Diego Tartara), missing line numbers on entity
- (William)</li>
- <li>improvements: DocBook catalog build scrip (William), xmlcatalog tool
- (Albert Chin), xmllint --c14n option, no_proxy environment (Mike Hommey),
- xmlParseInNodeContext() addition, extend xmllint --shell, allow XInclude
- to not generate start/end nodes, extend xmllint --version to include CVS
- tag (William)</li>
- <li>documentation: web pages fixes, validity API docs fixes (William)
- schemas API fix (Eric Haszlakiewicz), xmllint man page (John Fleck)</li>
-</ul><h3>2.6.11: July 5 2004</h3><ul><li>Schemas: a lot of changes and improvements by Kasimier Buchcik for
- attributes, namespaces and simple types.</li>
- <li>build fixes: --with-minimum (William Brack), some gcc cleanup
- (William), --with-thread-alloc (William)</li>
- <li>portability: Windows binary package change (Igor Zlatkovic), Catalog
- path on Windows</li>
- <li>documentation: update to the tutorial (John Fleck), xmllint return code
- (John Fleck), man pages (Ville Skytta),</li>
- <li>bug fixes: C14N bug serializing namespaces (Aleksey Sanin), testSAX
- properly initialize the library (William), empty node set in XPath
- (William), xmlSchemas errors (William), invalid charref problem pointed
- by Morus Walter, XInclude xml:base generation (William), Relax-NG bug
- with div processing (William), XPointer and xml:base problem(William),
- Reader and entities, xmllint return code for schemas (William), reader
- streaming problem (Steve Ball), DTD serialization problem (William),
- libxml.m4 fixes (Mike Hommey), do not provide destructors as methods on
- Python classes, xmlReader buffer bug, Python bindings memory interfaces
- improvement (with Stéphane Bidoul), Fixed the push parser to be back to
- synchronous behaviour.</li>
- <li>improvement: custom per-thread I/O enhancement (Rob Richards), register
- namespace in debug shell (Stefano Debenedetti), Python based regression
- test for non-Unix users (William), dynamically increase the number of
- XPath extension functions in Python and fix a memory leak (Marc-Antoine
- Parent and William)</li>
- <li>performance: hack done with Arjan van de Ven to reduce ELF footprint
- and generated code on Linux, plus use gcc runtime profiling to optimize
- the code generated in the RPM packages.</li>
+ <li>fixes: RVT fixes (William), XPath context resets bug (William),
+ memorydebug (Steve Hay), catalog white space handling (Peter
+ Breitenlohner),xmlReader state after attribute reading (William),
+ structured errorhandler (William), XInclude generated xml:base fixup
+ (William), Windowsmemory reallocation problem (Steve Hay), Out of Memory
+ conditionshandling (William and Olivier Andrieu), htmlNewDoc() charset
+ bug,htmlReadMemory init (William), a posteriori validation DTD
+ base(William), notations serialization missing, xmlGetNodePath
+ (Dodji),xmlCheckUTF8 (Diego Tartara), missing line numbers on
+ entity(William)</li>
+ <li>improvements: DocBook catalog build scrip (William), xmlcatalog
+ tool(Albert Chin), xmllint --c14n option, no_proxy environment (Mike
+ Hommey),xmlParseInNodeContext() addition, extend xmllint --shell, allow
+ XIncludeto not generate start/end nodes, extend xmllint --version to
+ include CVStag (William)</li>
+ <li>documentation: web pages fixes, validity API docs fixes
+ (William)schemas API fix (Eric Haszlakiewicz), xmllint man page (John
+ Fleck)</li>
+</ul><h3>2.6.11: July 5 2004</h3><ul><li>Schemas: a lot of changes and improvements by Kasimier Buchcik
+ forattributes, namespaces and simple types.</li>
+ <li>build fixes: --with-minimum (William Brack), some gcc
+ cleanup(William), --with-thread-alloc (William)</li>
+ <li>portability: Windows binary package change (Igor Zlatkovic),
+ Catalogpath on Windows</li>
+ <li>documentation: update to the tutorial (John Fleck), xmllint return
+ code(John Fleck), man pages (Ville Skytta),</li>
+ <li>bug fixes: C14N bug serializing namespaces (Aleksey Sanin),
+ testSAXproperly initialize the library (William), empty node set in
+ XPath(William), xmlSchemas errors (William), invalid charref problem
+ pointedby Morus Walter, XInclude xml:base generation (William), Relax-NG
+ bugwith div processing (William), XPointer and xml:base
+ problem(William),Reader and entities, xmllint return code for schemas
+ (William), readerstreaming problem (Steve Ball), DTD serialization
+ problem (William),libxml.m4 fixes (Mike Hommey), do not provide
+ destructors as methods onPython classes, xmlReader buffer bug, Python
+ bindings memory interfacesimprovement (with Stéphane Bidoul), Fixed the
+ push parser to be back tosynchronous behaviour.</li>
+ <li>improvement: custom per-thread I/O enhancement (Rob Richards),
+ registernamespace in debug shell (Stefano Debenedetti), Python based
+ regressiontest for non-Unix users (William), dynamically increase the
+ number ofXPath extension functions in Python and fix a memory leak
+ (Marc-AntoineParent and William)</li>
+ <li>performance: hack done with Arjan van de Ven to reduce ELF footprintand
+ generated code on Linux, plus use gcc runtime profiling to optimizethe
+ code generated in the RPM packages.</li>
</ul><h3>2.6.10: May 17 2004</h3><ul><li>Web page generated for ChangeLog</li>
<li>build fixes: --without-html problems, make check without make all</li>
- <li>portability: problem with xpath.c on Windows (MSC and Borland), memcmp
- vs. strncmp on Solaris, XPath tests on Windows (Mark Vakoc), C++ do not
- use "list" as parameter name, make tests work with Python 1.5 (Ed
- Davis),</li>
- <li>improvements: made xmlTextReaderMode public, small buffers resizing
- (Morten Welinder), add --maxmem option to xmllint, add
- xmlPopInputCallback() for Matt Sergeant, refactoring of serialization
- escaping, added escaping customization</li>
- <li>bugfixes: xsd:extension (Taihei Goi), assorted regexp bugs (William
- Brack), xmlReader end of stream problem, node deregistration with reader,
- URI escaping and filemanes, XHTML1 formatting (Nick Wellnhofer), regexp
- transition reduction (William), various XSD Schemas fixes (Kasimier
- Buchcik), XInclude fallback problem (William), weird problems with DTD
- (William), structured error handler callback context (William), reverse
- xmlEncodeSpecialChars() behaviour back to escaping '"'</li>
+ <li>portability: problem with xpath.c on Windows (MSC and Borland),
+ memcmpvs. strncmp on Solaris, XPath tests on Windows (Mark Vakoc), C++ do
+ notuse "list" as parameter name, make tests work with Python 1.5
+ (EdDavis),</li>
+ <li>improvements: made xmlTextReaderMode public, small buffers
+ resizing(Morten Welinder), add --maxmem option to xmllint,
+ addxmlPopInputCallback() for Matt Sergeant, refactoring of
+ serializationescaping, added escaping customization</li>
+ <li>bugfixes: xsd:extension (Taihei Goi), assorted regexp bugs
+ (WilliamBrack), xmlReader end of stream problem, node deregistration with
+ reader,URI escaping and filemanes, XHTML1 formatting (Nick Wellnhofer),
+ regexptransition reduction (William), various XSD Schemas fixes
+ (KasimierBuchcik), XInclude fallback problem (William), weird problems
+ with DTD(William), structured error handler callback context (William),
+ reversexmlEncodeSpecialChars() behaviour back to escaping '"'</li>
</ul><h3>2.6.9: Apr 18 2004</h3><ul><li>implement xml:id Working Draft, relaxed XPath id() checking</li>
- <li>bugfixes: xmlCtxtReset (Brent Hendricks), line number and CDATA (Dave
- Beckett), Relax-NG compilation (William Brack), Regexp patches (with
- William), xmlUriEscape (Mark Vakoc), a Relax-NG notAllowed problem (with
- William), Relax-NG name classes compares (William), XInclude duplicate
- fallback (William), external DTD encoding detection (William), a DTD
- validation bug (William), xmlReader Close() fix, recusive extention
- schemas</li>
- <li>improvements: use xmlRead* APIs in test tools (Mark Vakoc), indenting
- save optimization, better handle IIS broken HTTP redirect behaviour (Ian
- Hummel), HTML parser frameset (James Bursa), libxml2-python RPM
- dependancy, XML Schemas union support (Kasimier Buchcik), warning removal
- clanup (William), keep ChangeLog compressed when installing from RPMs</li>
- <li>documentation: examples and xmlDocDumpMemory docs (John Fleck), new
- example (load, xpath, modify, save), xmlCatalogDump() comments,</li>
- <li>Windows: Borland C++ builder (Eric Zurcher), work around Microsoft
- compiler NaN handling bug (Mark Vakoc)</li>
+ <li>bugfixes: xmlCtxtReset (Brent Hendricks), line number and CDATA
+ (DaveBeckett), Relax-NG compilation (William Brack), Regexp patches
+ (withWilliam), xmlUriEscape (Mark Vakoc), a Relax-NG notAllowed problem
+ (withWilliam), Relax-NG name classes compares (William), XInclude
+ duplicatefallback (William), external DTD encoding detection (William), a
+ DTDvalidation bug (William), xmlReader Close() fix, recusive
+ extentionschemas</li>
+ <li>improvements: use xmlRead* APIs in test tools (Mark Vakoc),
+ indentingsave optimization, better handle IIS broken HTTP redirect
+ behaviour (IanHummel), HTML parser frameset (James Bursa), libxml2-python
+ RPMdependancy, XML Schemas union support (Kasimier Buchcik), warning
+ removalclanup (William), keep ChangeLog compressed when installing from
+ RPMs</li>
+ <li>documentation: examples and xmlDocDumpMemory docs (John Fleck),
+ newexample (load, xpath, modify, save), xmlCatalogDump() comments,</li>
+ <li>Windows: Borland C++ builder (Eric Zurcher), work around
+ Microsoftcompiler NaN handling bug (Mark Vakoc)</li>
</ul><h3>2.6.8: Mar 23 2004</h3><ul><li>First step of the cleanup of the serialization code and APIs</li>
- <li>XML Schemas: mixed content (Adam Dickmeiss), QName handling fixes (Adam
- Dickmeiss), anyURI for "" (John Belmonte)</li>
+ <li>XML Schemas: mixed content (Adam Dickmeiss), QName handling fixes
+ (AdamDickmeiss), anyURI for "" (John Belmonte)</li>
<li>Python: Canonicalization C14N support added (Anthony Carrico)</li>
<li>xmlDocCopyNode() extension (William)</li>
- <li>Relax-NG: fix when processing XInclude results (William), external
- reference in interleave (William), missing error on &lt;choice&gt;
- failure (William), memory leak in schemas datatype facets.</li>
+ <li>Relax-NG: fix when processing XInclude results (William),
+ externalreference in interleave (William), missing error on
+ &lt;choice&gt;failure (William), memory leak in schemas datatype
+ facets.</li>
<li>xmlWriter: patch for better DTD support (Alfred Mickautsch)</li>
- <li>bug fixes: xmlXPathLangFunction memory leak (Mike Hommey and William
- Brack), no ID errors if using HTML_PARSE_NOERROR, xmlcatalog fallbacks to
- URI on SYSTEM lookup failure, XInclude parse flags inheritance (William),
- XInclude and XPointer fixes for entities (William), XML parser bug
- reported by Holger Rauch, nanohttp fd leak (William), regexps char
- groups '-' handling (William), dictionnary reference counting problems,
- do not close stderr.</li>
+ <li>bug fixes: xmlXPathLangFunction memory leak (Mike Hommey and
+ WilliamBrack), no ID errors if using HTML_PARSE_NOERROR, xmlcatalog
+ fallbacks toURI on SYSTEM lookup failure, XInclude parse flags
+ inheritance (William),XInclude and XPointer fixes for entities (William),
+ XML parser bugreported by Holger Rauch, nanohttp fd leak (William),
+ regexps chargroups '-' handling (William), dictionnary reference counting
+ problems,do not close stderr.</li>
<li>performance patches from Petr Pajas</li>
<li>Documentation fixes: XML_CATALOG_FILES in man pages (Mike Hommey)</li>
- <li>compilation and portability fixes: --without-valid, catalog cleanups
- (Peter Breitenlohner), MingW patch (Roland Schwingel), cross-compilation
- to Windows (Christophe de Vienne), --with-html-dir fixup (Julio Merino
- Vidal), Windows build (Eric Zurcher)</li>
+ <li>compilation and portability fixes: --without-valid, catalog
+ cleanups(Peter Breitenlohner), MingW patch (Roland Schwingel),
+ cross-compilationto Windows (Christophe de Vienne), --with-html-dir
+ fixup (Julio MerinoVidal), Windows build (Eric Zurcher)</li>
</ul><h3>2.6.7: Feb 23 2004</h3><ul><li>documentation: tutorial updates (John Fleck), benchmark results</li>
<li>xmlWriter: updates and fixes (Alfred Mickautsch, Lucas Brasilino)</li>
<li>XPath optimization (Petr Pajas)</li>
<li>DTD ID handling optimization</li>
- <li>bugfixes: xpath number with &gt; 19 fractional (William Brack), push
- mode with unescaped '&gt;' characters, fix xmllint --stream --timing, fix
- xmllint --memory --stream memory usage, xmlAttrSerializeTxtContent
- handling NULL, trying to fix Relax-NG/Perl interface.</li>
+ <li>bugfixes: xpath number with &gt; 19 fractional (William Brack),
+ pushmode with unescaped '&gt;' characters, fix xmllint --stream --timing,
+ fixxmllint --memory --stream memory usage,
+ xmlAttrSerializeTxtContenthandling NULL, trying to fix Relax-NG/Perl
+ interface.</li>
<li>python: 2.3 compatibility, whitespace fixes (Malcolm Tredinnick)</li>
<li>Added relaxng option to xmllint --shell</li>
-</ul><h3>2.6.6: Feb 12 2004</h3><ul><li>nanohttp and nanoftp: buffer overflow error on URI parsing (Igor and
- William) reported by Yuuichi Teranishi</li>
- <li>bugfixes: make test and path issues, xmlWriter attribute serialization
- (William Brack), xmlWriter indentation (William), schemas validation
- (Eric Haszlakiewicz), XInclude dictionnaries issues (William and Oleg
- Paraschenko), XInclude empty fallback (William), HTML warnings (William),
- XPointer in XInclude (William), Python namespace serialization,
- isolat1ToUTF8 bound error (Alfred Mickautsch), output of parameter
- entities in internal subset (William), internal subset bug in push mode,
- &lt;xs:all&gt; fix (Alexey Sarytchev)</li>
- <li>Build: fix for automake-1.8 (Alexander Winston), warnings removal
- (Philip Ludlam), SOCKLEN_T detection fixes (Daniel Richard), fix
- --with-minimum configuration.</li>
+</ul><h3>2.6.6: Feb 12 2004</h3><ul><li>nanohttp and nanoftp: buffer overflow error on URI parsing (Igor
+ andWilliam) reported by Yuuichi Teranishi</li>
+ <li>bugfixes: make test and path issues, xmlWriter attribute
+ serialization(William Brack), xmlWriter indentation (William), schemas
+ validation(Eric Haszlakiewicz), XInclude dictionnaries issues (William
+ and OlegParaschenko), XInclude empty fallback (William), HTML warnings
+ (William),XPointer in XInclude (William), Python namespace
+ serialization,isolat1ToUTF8 bound error (Alfred Mickautsch), output of
+ parameterentities in internal subset (William), internal subset bug in
+ push mode,&lt;xs:all&gt; fix (Alexey Sarytchev)</li>
+ <li>Build: fix for automake-1.8 (Alexander Winston), warnings
+ removal(Philip Ludlam), SOCKLEN_T detection fixes (Daniel Richard),
+ fix--with-minimum configuration.</li>
<li>XInclude: allow the 2001 namespace without warning.</li>
- <li>Documentation: missing example/index.html (John Fleck), version
- dependancies (John Fleck)</li>
+ <li>Documentation: missing example/index.html (John Fleck),
+ versiondependancies (John Fleck)</li>
<li>reader API: structured error reporting (Steve Ball)</li>
- <li>Windows compilation: mingw, msys (Mikhail Grushinskiy), function
- prototype (Cameron Johnson), MSVC6 compiler warnings, _WINSOCKAPI_
- patch</li>
- <li>Parsers: added xmlByteConsumed(ctxt) API to get the byte offest in
- input.</li>
-</ul><h3>2.6.5: Jan 25 2004</h3><ul><li>Bugfixes: dictionnaries for schemas (William Brack), regexp segfault
- (William), xs:all problem (William), a number of XPointer bugfixes
- (William), xmllint error go to stderr, DTD validation problem with
- namespace, memory leak (William), SAX1 cleanup and minimal options fixes
- (Mark Vadoc), parser context reset on error (Shaun McCance), XPath union
- evaluation problem (William) , xmlReallocLoc with NULL (Aleksey Sanin),
- XML Schemas double free (Steve Ball), XInclude with no href, argument
- callbacks order for XPath callbacks (Frederic Peters)</li>
- <li>Documentation: python scripts (William Brack), xslt stylesheets (John
- Fleck), doc (Sven Zimmerman), I/O example.</li>
- <li>Python bindings: fixes (William), enum support (Stéphane Bidoul),
- structured error reporting (Stéphane Bidoul)</li>
- <li>XInclude: various fixes for conformance, problem related to dictionnary
- references (William &amp; me), recursion (William)</li>
- <li>xmlWriter: indentation (Lucas Brasilino), memory leaks (Alfred
- Mickautsch),</li>
+ <li>Windows compilation: mingw, msys (Mikhail Grushinskiy),
+ functionprototype (Cameron Johnson), MSVC6 compiler warnings,
+ _WINSOCKAPI_patch</li>
+ <li>Parsers: added xmlByteConsumed(ctxt) API to get the byte offest
+ ininput.</li>
+</ul><h3>2.6.5: Jan 25 2004</h3><ul><li>Bugfixes: dictionnaries for schemas (William Brack), regexp
+ segfault(William), xs:all problem (William), a number of XPointer
+ bugfixes(William), xmllint error go to stderr, DTD validation problem
+ withnamespace, memory leak (William), SAX1 cleanup and minimal options
+ fixes(Mark Vadoc), parser context reset on error (Shaun McCance), XPath
+ unionevaluation problem (William) , xmlReallocLoc with NULL (Aleksey
+ Sanin),XML Schemas double free (Steve Ball), XInclude with no href,
+ argumentcallbacks order for XPath callbacks (Frederic Peters)</li>
+ <li>Documentation: python scripts (William Brack), xslt stylesheets
+ (JohnFleck), doc (Sven Zimmerman), I/O example.</li>
+ <li>Python bindings: fixes (William), enum support (Stéphane
+ Bidoul),structured error reporting (Stéphane Bidoul)</li>
+ <li>XInclude: various fixes for conformance, problem related to
+ dictionnaryreferences (William &amp; me), recursion (William)</li>
+ <li>xmlWriter: indentation (Lucas Brasilino), memory leaks
+ (AlfredMickautsch),</li>
<li>xmlSchemas: normalizedString datatype (John Belmonte)</li>
<li>code cleanup for strings functions (William)</li>
<li>Windows: compiler patches (Mark Vakoc)</li>
- <li>Parser optimizations, a few new XPath and dictionnary APIs for future
- XSLT optimizations.</li>
+ <li>Parser optimizations, a few new XPath and dictionnary APIs for
+ futureXSLT optimizations.</li>
</ul><h3>2.6.4: Dec 24 2003</h3><ul><li>Windows build fixes (Igor Zlatkovic)</li>
<li>Some serious XInclude problems reported by Oleg Paraschenko and</li>
<li>Unix and Makefile packaging fixes (me, William Brack,</li>
- <li>Documentation improvements (John Fleck, William Brack), example fix
- (Lucas Brasilino)</li>
- <li>bugfixes: xmlTextReaderExpand() with xmlReaderWalker, XPath handling of
- NULL strings (William Brack) , API building reader or parser from
- filedescriptor should not close it, changed XPath sorting to be stable
- again (William Brack), xmlGetNodePath() generating '(null)' (William
- Brack), DTD validation and namespace bug (William Brack), XML Schemas
- double inclusion behaviour</li>
+ <li>Documentation improvements (John Fleck, William Brack), example
+ fix(Lucas Brasilino)</li>
+ <li>bugfixes: xmlTextReaderExpand() with xmlReaderWalker, XPath handling
+ ofNULL strings (William Brack) , API building reader or parser
+ fromfiledescriptor should not close it, changed XPath sorting to be
+ stableagain (William Brack), xmlGetNodePath() generating '(null)'
+ (WilliamBrack), DTD validation and namespace bug (William Brack), XML
+ Schemasdouble inclusion behaviour</li>
</ul><h3>2.6.3: Dec 10 2003</h3><ul><li>documentation updates and cleanup (DV, William Brack, John Fleck)</li>
- <li>added a repository of examples, examples from Aleksey Sanin, Dodji
- Seketeli, Alfred Mickautsch</li>
- <li>Windows updates: Mark Vakoc, Igor Zlatkovic, Eric Zurcher, Mingw
- (Kenneth Haley)</li>
+ <li>added a repository of examples, examples from Aleksey Sanin,
+ DodjiSeketeli, Alfred Mickautsch</li>
+ <li>Windows updates: Mark Vakoc, Igor Zlatkovic, Eric Zurcher,
+ Mingw(Kenneth Haley)</li>
<li>Unicode range checking (William Brack)</li>
<li>code cleanup (William Brack)</li>
<li>Python bindings: doc (John Fleck), bug fixes</li>
<li>UTF-16 cleanup and BOM issues (William Brack)</li>
- <li>bug fixes: ID and xmlReader validation, XPath (William Brack),
- xmlWriter (Alfred Mickautsch), hash.h inclusion problem, HTML parser
- (James Bursa), attribute defaulting and validation, some serialization
- cleanups, XML_GET_LINE macro, memory debug when using threads (William
- Brack), serialization of attributes and entities content, xmlWriter
- (Daniel Schulman)</li>
- <li>XInclude bugfix, new APIs and update to the last version including the
- namespace change.</li>
- <li>XML Schemas improvements: include (Robert Stepanek), import and
- namespace handling, fixed the regression tests troubles, added examples
- based on Eric van der Vlist book, regexp fixes</li>
- <li>preliminary pattern support for streaming (needed for schemas
- constraints), added xmlTextReaderPreservePattern() to collect subdocument
- when streaming.</li>
+ <li>bug fixes: ID and xmlReader validation, XPath (William Brack),xmlWriter
+ (Alfred Mickautsch), hash.h inclusion problem, HTML parser(James Bursa),
+ attribute defaulting and validation, some serializationcleanups,
+ XML_GET_LINE macro, memory debug when using threads (WilliamBrack),
+ serialization of attributes and entities content, xmlWriter(Daniel
+ Schulman)</li>
+ <li>XInclude bugfix, new APIs and update to the last version including
+ thenamespace change.</li>
+ <li>XML Schemas improvements: include (Robert Stepanek), import
+ andnamespace handling, fixed the regression tests troubles, added
+ examplesbased on Eric van der Vlist book, regexp fixes</li>
+ <li>preliminary pattern support for streaming (needed for
+ schemasconstraints), added xmlTextReaderPreservePattern() to collect
+ subdocumentwhen streaming.</li>
<li>various fixes in the structured error handling</li>
</ul><h3>2.6.2: Nov 4 2003</h3><ul><li>XPath context unregistration fixes</li>
<li>text node coalescing fixes (Mark Lilback)</li>
@@ -482,117 +495,116 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p><p>
<li>a posteriori DTD validation fixes</li>
<li>xmlReader bug fixes: Walker fixes, python bindings</li>
<li>fixed xmlStopParser() to really stop the parser and errors</li>
- <li>always generate line numbers when using the new xmlReadxxx
- functions</li>
+ <li>always generate line numbers when using the new xmlReadxxxfunctions</li>
<li>added XInclude support to the xmlReader interface</li>
<li>implemented XML_PARSE_NONET parser option</li>
<li>DocBook XSLT processing bug fixed</li>
<li>HTML serialization for &lt;p&gt; elements (William Brack and me)</li>
<li>XPointer failure in XInclude are now handled as resource errors</li>
- <li>fixed xmllint --html to use the HTML serializer on output (added
- --xmlout to implement the previous behaviour of saving it using the XML
- serializer)</li>
+ <li>fixed xmllint --html to use the HTML serializer on output
+ (added--xmlout to implement the previous behaviour of saving it using the
+ XMLserializer)</li>
</ul><h3>2.6.1: Oct 28 2003</h3><ul><li>Mostly bugfixes after the big 2.6.0 changes</li>
- <li>Unix compilation patches: libxml.m4 (Patrick Welche), warnings cleanup
- (William Brack)</li>
- <li>Windows compilation patches (Joachim Bauch, Stephane Bidoul, Igor
- Zlatkovic)</li>
+ <li>Unix compilation patches: libxml.m4 (Patrick Welche), warnings
+ cleanup(William Brack)</li>
+ <li>Windows compilation patches (Joachim Bauch, Stephane Bidoul,
+ IgorZlatkovic)</li>
<li>xmlWriter bugfix (Alfred Mickautsch)</li>
<li>chvalid.[ch]: couple of fixes from Stephane Bidoul</li>
- <li>context reset: error state reset, push parser reset (Graham
- Bennett)</li>
+ <li>context reset: error state reset, push parser reset (GrahamBennett)</li>
<li>context reuse: generate errors if file is not readable</li>
- <li>defaulted attributes for element coming from internal entities
- (Stephane Bidoul)</li>
+ <li>defaulted attributes for element coming from internal entities(Stephane
+ Bidoul)</li>
<li>Python: tab and spaces mix (William Brack)</li>
<li>Error handler could crash in DTD validation in 2.6.0</li>
<li>xmlReader: do not use the document or element _private field</li>
<li>testSAX.c: avoid a problem with some PIs (Massimo Morara)</li>
- <li>general bug fixes: mandatory encoding in text decl, serializing
- Document Fragment nodes, xmlSearchNs 2.6.0 problem (Kasimier Buchcik),
- XPath errors not reported, slow HTML parsing of large documents.</li>
-</ul><h3>2.6.0: Oct 20 2003</h3><ul><li>Major revision release: should be API and ABI compatible but got a lot
- of change</li>
- <li>Increased the library modularity, far more options can be stripped out,
- a --with-minimum configuration will weight around 160KBytes</li>
- <li>Use per parser and per document dictionnary, allocate names and small
- text nodes from the dictionnary</li>
- <li>Switch to a SAX2 like parser rewrote most of the XML parser core,
- provides namespace resolution and defaulted attributes, minimize memory
- allocations and copies, namespace checking and specific error handling,
- immutable buffers, make predefined entities static structures, etc...</li>
- <li>rewrote all the error handling in the library, all errors can be
- intercepted at a structured level, with precise information
- available.</li>
- <li>New simpler and more generic XML and HTML parser APIs, allowing to
- easilly modify the parsing options and reuse parser context for multiple
- consecutive documents.</li>
- <li>Similar new APIs for the xmlReader, for options and reuse, provided new
- functions to access content as const strings, use them for Python
- bindings</li>
- <li>a lot of other smaller API improvements: xmlStrPrintf (Aleksey Sanin),
- Walker i.e. reader on a document tree based on Alfred Mickautsch code,
- make room in nodes for line numbers, reference counting and future PSVI
- extensions, generation of character ranges to be checked with faster
- algorithm (William), xmlParserMaxDepth (Crutcher Dunnavant), buffer
- access</li>
+ <li>general bug fixes: mandatory encoding in text decl, serializingDocument
+ Fragment nodes, xmlSearchNs 2.6.0 problem (Kasimier Buchcik),XPath errors
+ not reported, slow HTML parsing of large documents.</li>
+</ul><h3>2.6.0: Oct 20 2003</h3><ul><li>Major revision release: should be API and ABI compatible but got a
+ lotof change</li>
+ <li>Increased the library modularity, far more options can be stripped
+ out,a --with-minimum configuration will weight around 160KBytes</li>
+ <li>Use per parser and per document dictionnary, allocate names and
+ smalltext nodes from the dictionnary</li>
+ <li>Switch to a SAX2 like parser rewrote most of the XML parser
+ core,provides namespace resolution and defaulted attributes, minimize
+ memoryallocations and copies, namespace checking and specific error
+ handling,immutable buffers, make predefined entities static structures,
+ etc...</li>
+ <li>rewrote all the error handling in the library, all errors can
+ beintercepted at a structured level, with precise
+ informationavailable.</li>
+ <li>New simpler and more generic XML and HTML parser APIs, allowing
+ toeasilly modify the parsing options and reuse parser context for
+ multipleconsecutive documents.</li>
+ <li>Similar new APIs for the xmlReader, for options and reuse, provided
+ newfunctions to access content as const strings, use them for
+ Pythonbindings</li>
+ <li>a lot of other smaller API improvements: xmlStrPrintf (Aleksey
+ Sanin),Walker i.e. reader on a document tree based on Alfred Mickautsch
+ code,make room in nodes for line numbers, reference counting and future
+ PSVIextensions, generation of character ranges to be checked with
+ fasteralgorithm (William), xmlParserMaxDepth (Crutcher Dunnavant),
+ bufferaccess</li>
<li>New xmlWriter API provided by Alfred Mickautsch</li>
<li>Schemas: base64 support by Anthony Carrico</li>
- <li>Parser&lt;-&gt;HTTP integration fix, proper processing of the Mime-Type
- and charset informations if available.</li>
- <li>Relax-NG: bug fixes including the one reported by Martijn Faassen and
- zeroOrMore, better error reporting.</li>
- <li>Python bindings (Stéphane Bidoul), never use stdout for errors
- output</li>
- <li>Portability: all the headers have macros for export and calling
- convention definitions (Igor Zlatkovic), VMS update (Craig A. Berry),
- Windows: threads (Jesse Pelton), Borland compiler (Eric Zurcher, Igor),
- Mingw (Igor), typos (Mark Vakoc), beta version (Stephane Bidoul),
- warning cleanups on AIX and MIPS compilers (William Brack), BeOS (Marcin
- 'Shard' Konicki)</li>
- <li>Documentation fixes and README (William Brack), search fix (William),
- tutorial updates (John Fleck), namespace docs (Stefan Kost)</li>
- <li>Bug fixes: xmlCleanupParser (Dave Beckett), threading uninitialized
- mutexes, HTML doctype lowercase, SAX/IO (William), compression detection
- and restore (William), attribute declaration in DTDs (William), namespace
- on attribute in HTML output (William), input filename (Rob Richards),
- namespace DTD validation, xmlReplaceNode (Chris Ryland), I/O callbacks
- (Markus Keim), CDATA serialization (Shaun McCance), xmlReader (Peter
- Derr), high codepoint charref like &amp;#x10FFFF;, buffer access in push
- mode (Justin Fletcher), TLS threads on Windows (Jesse Pelton), XPath bug
- (William), xmlCleanupParser (Marc Liyanage), CDATA output (William), HTTP
- error handling.</li>
- <li>xmllint options: --dtdvalidfpi for Tobias Reif, --sax1 for compat
- testing, --nodict for building without tree dictionnary, --nocdata to
- replace CDATA by text, --nsclean to remove surperfluous namespace
- declarations</li>
+ <li>Parser&lt;-&gt;HTTP integration fix, proper processing of the
+ Mime-Typeand charset informations if available.</li>
+ <li>Relax-NG: bug fixes including the one reported by Martijn Faassen
+ andzeroOrMore, better error reporting.</li>
+ <li>Python bindings (Stéphane Bidoul), never use stdout for
+ errorsoutput</li>
+ <li>Portability: all the headers have macros for export and
+ callingconvention definitions (Igor Zlatkovic), VMS update (Craig A.
+ Berry),Windows: threads (Jesse Pelton), Borland compiler (Eric Zurcher,
+ Igor),Mingw (Igor), typos (Mark Vakoc), beta version (Stephane
+ Bidoul),warning cleanups on AIX and MIPS compilers (William Brack), BeOS
+ (Marcin'Shard' Konicki)</li>
+ <li>Documentation fixes and README (William Brack), search fix
+ (William),tutorial updates (John Fleck), namespace docs (Stefan Kost)</li>
+ <li>Bug fixes: xmlCleanupParser (Dave Beckett), threading
+ uninitializedmutexes, HTML doctype lowercase, SAX/IO (William),
+ compression detectionand restore (William), attribute declaration in DTDs
+ (William), namespaceon attribute in HTML output (William), input filename
+ (Rob Richards),namespace DTD validation, xmlReplaceNode (Chris Ryland),
+ I/O callbacks(Markus Keim), CDATA serialization (Shaun McCance),
+ xmlReader (PeterDerr), high codepoint charref like &amp;#x10FFFF;, buffer
+ access in pushmode (Justin Fletcher), TLS threads on Windows (Jesse
+ Pelton), XPath bug(William), xmlCleanupParser (Marc Liyanage), CDATA
+ output (William), HTTPerror handling.</li>
+ <li>xmllint options: --dtdvalidfpi for Tobias Reif, --sax1 for
+ compattesting, --nodict for building without tree dictionnary, --nocdata
+ toreplace CDATA by text, --nsclean to remove surperfluous
+ namespacedeclarations</li>
<li>added xml2-config --libtool-libs option from Kevin P. Fleming</li>
- <li>a lot of profiling and tuning of the code, speedup patch for
- xmlSearchNs() by Luca Padovani. The xmlReader should do far less
- allocation and it speed should get closer to SAX. Chris Anderson worked
- on speeding and cleaning up repetitive checking code.</li>
+ <li>a lot of profiling and tuning of the code, speedup patch
+ forxmlSearchNs() by Luca Padovani. The xmlReader should do far
+ lessallocation and it speed should get closer to SAX. Chris Anderson
+ workedon speeding and cleaning up repetitive checking code.</li>
<li>cleanup of "make tests"</li>
<li>libxml-2.0-uninstalled.pc from Malcolm Tredinnick</li>
- <li>deactivated the broken docBook SGML parser code and plugged the XML
- parser instead.</li>
+ <li>deactivated the broken docBook SGML parser code and plugged the
+ XMLparser instead.</li>
</ul><h3>2.5.11: Sep 9 2003</h3><p>A bugfix only release:</p><ul><li>risk of crash in Relax-NG</li>
<li>risk of crash when using multithreaded programs</li>
</ul><h3>2.5.10: Aug 15 2003</h3><p>A bugfixes only release</p><ul><li>Windows Makefiles (William Brack)</li>
<li>UTF-16 support fixes (Mark Itzcovitz)</li>
- <li>Makefile and portability (William Brack) automake, Linux alpha, Mingw
- on Windows (Mikhail Grushinskiy)</li>
+ <li>Makefile and portability (William Brack) automake, Linux alpha, Mingwon
+ Windows (Mikhail Grushinskiy)</li>
<li>HTML parser (Oliver Stoeneberg)</li>
<li>XInclude performance problem reported by Kevin Ruscoe</li>
<li>XML parser performance problem reported by Grant Goodale</li>
<li>xmlSAXParseDTD() bug fix from Malcolm Tredinnick</li>
<li>and a couple other cleanup</li>
-</ul><h3>2.5.9: Aug 9 2003</h3><ul><li>bugfixes: IPv6 portability, xmlHasNsProp (Markus Keim), Windows build
- (Wiliam Brake, Jesse Pelton, Igor), Schemas (Peter Sobisch), threading
- (Rob Richards), hexBinary type (), UTF-16 BOM (Dodji Seketeli),
- xmlReader, Relax-NG schemas compilation, namespace handling, EXSLT (Sean
- Griffin), HTML parsing problem (William Brack), DTD validation for mixed
- content + namespaces, HTML serialization, library initialization,
- progressive HTML parser</li>
+</ul><h3>2.5.9: Aug 9 2003</h3><ul><li>bugfixes: IPv6 portability, xmlHasNsProp (Markus Keim), Windows
+ build(Wiliam Brake, Jesse Pelton, Igor), Schemas (Peter Sobisch),
+ threading(Rob Richards), hexBinary type (), UTF-16 BOM (Dodji
+ Seketeli),xmlReader, Relax-NG schemas compilation, namespace handling,
+ EXSLT (SeanGriffin), HTML parsing problem (William Brack), DTD validation
+ for mixedcontent + namespaces, HTML serialization, library
+ initialization,progressive HTML parser</li>
<li>better interfaces for Relax-NG error handling (Joachim Bauch, )</li>
<li>adding xmlXIncludeProcessTree() for XInclud'ing in a subtree</li>
<li>doc fixes and improvements (John Fleck)</li>
@@ -600,122 +612,123 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p><p>
<li>couple of new UTF-8 helper functions (William Brack)</li>
<li>general encoding cleanup + ISO-8859-x without iconv (Peter Jacobi)</li>
<li>xmlTextReader cleanup + enum for node types (Bjorn Reese)</li>
- <li>general compilation/warning cleanup Solaris/HP-UX/... (William
- Brack)</li>
-</ul><h3>2.5.8: Jul 6 2003</h3><ul><li>bugfixes: XPath, XInclude, file/URI mapping, UTF-16 save (Mark
- Itzcovitz), UTF-8 checking, URI saving, error printing (William Brack),
- PI related memleak, compilation without schemas or without xpath (Joerg
- Schmitz-Linneweber/Garry Pennington), xmlUnlinkNode problem with DTDs,
- rpm problem on , i86_64, removed a few compilation problems from 2.5.7,
- xmlIOParseDTD, and xmlSAXParseDTD (Malcolm Tredinnick)</li>
+ <li>general compilation/warning cleanup Solaris/HP-UX/...
+ (WilliamBrack)</li>
+</ul><h3>2.5.8: Jul 6 2003</h3><ul><li>bugfixes: XPath, XInclude, file/URI mapping, UTF-16 save
+ (MarkItzcovitz), UTF-8 checking, URI saving, error printing (William
+ Brack),PI related memleak, compilation without schemas or without xpath
+ (JoergSchmitz-Linneweber/Garry Pennington), xmlUnlinkNode problem with
+ DTDs,rpm problem on , i86_64, removed a few compilation problems from
+ 2.5.7,xmlIOParseDTD, and xmlSAXParseDTD (Malcolm Tredinnick)</li>
<li>portability: DJGPP (MsDos) , OpenVMS (Craig A. Berry)</li>
<li>William Brack fixed multithreading lock problems</li>
<li>IPv6 patch for FTP and HTTP accesses (Archana Shah/Wipro)</li>
- <li>Windows fixes (Igor Zlatkovic, Eric Zurcher), threading (Stéphane
- Bidoul)</li>
+ <li>Windows fixes (Igor Zlatkovic, Eric Zurcher), threading
+ (StéphaneBidoul)</li>
<li>A few W3C Schemas Structure improvements</li>
<li>W3C Schemas Datatype improvements (Charlie Bozeman)</li>
- <li>Python bindings for thread globals (Stéphane Bidoul), and method/class
- generator</li>
+ <li>Python bindings for thread globals (Stéphane Bidoul), and
+ method/classgenerator</li>
<li>added --nonet option to xmllint</li>
<li>documentation improvements (John Fleck)</li>
-</ul><h3>2.5.7: Apr 25 2003</h3><ul><li>Relax-NG: Compiling to regexp and streaming validation on top of the
- xmlReader interface, added to xmllint --stream</li>
+</ul><h3>2.5.7: Apr 25 2003</h3><ul><li>Relax-NG: Compiling to regexp and streaming validation on top of
+ thexmlReader interface, added to xmllint --stream</li>
<li>xmlReader: Expand(), Next() and DOM access glue, bug fixes</li>
<li>Support for large files: RGN validated a 4.5GB instance</li>
<li>Thread support is now configured in by default</li>
- <li>Fixes: update of the Trio code (Bjorn), WXS Date and Duration fixes
- (Charles Bozeman), DTD and namespaces (Brent Hendricks), HTML push parser
- and zero bytes handling, some missing Windows file path conversions,
- behaviour of the parser and validator in the presence of "out of memory"
- error conditions</li>
- <li>extended the API to be able to plug a garbage collecting memory
- allocator, added xmlMallocAtomic() and modified the allocations
- accordingly.</li>
- <li>Performances: removed excessive malloc() calls, speedup of the push and
- xmlReader interfaces, removed excessive thread locking</li>
+ <li>Fixes: update of the Trio code (Bjorn), WXS Date and Duration
+ fixes(Charles Bozeman), DTD and namespaces (Brent Hendricks), HTML push
+ parserand zero bytes handling, some missing Windows file path
+ conversions,behaviour of the parser and validator in the presence of "out
+ of memory"error conditions</li>
+ <li>extended the API to be able to plug a garbage collecting
+ memoryallocator, added xmlMallocAtomic() and modified the
+ allocationsaccordingly.</li>
+ <li>Performances: removed excessive malloc() calls, speedup of the push
+ andxmlReader interfaces, removed excessive thread locking</li>
<li>Documentation: man page (John Fleck), xmlReader documentation</li>
<li>Python: adding binding for xmlCatalogAddLocal (Brent M Hendricks)</li>
-</ul><h3>2.5.6: Apr 1 2003</h3><ul><li>Fixed W3C XML Schemas datatype, should be compliant now except for
- binHex and base64 which are not supported yet.</li>
- <li>bug fixes: non-ASCII IDs, HTML output, XInclude on large docs and
- XInclude entities handling, encoding detection on external subsets, XML
- Schemas bugs and memory leaks, HTML parser (James Bursa)</li>
+</ul><h3>2.5.6: Apr 1 2003</h3><ul><li>Fixed W3C XML Schemas datatype, should be compliant now except
+ forbinHex and base64 which are not supported yet.</li>
+ <li>bug fixes: non-ASCII IDs, HTML output, XInclude on large docs
+ andXInclude entities handling, encoding detection on external subsets,
+ XMLSchemas bugs and memory leaks, HTML parser (James Bursa)</li>
<li>portability: python/trio (Albert Chin), Sun compiler warnings</li>
<li>documentation: added --relaxng option to xmllint man page (John)</li>
- <li>improved error reporting: xml:space, start/end tag mismatches, Relax NG
- errors</li>
-</ul><h3>2.5.5: Mar 24 2003</h3><ul><li>Lot of fixes on the Relax NG implementation. More testing including
- DocBook and TEI examples.</li>
+ <li>improved error reporting: xml:space, start/end tag mismatches, Relax
+ NGerrors</li>
+</ul><h3>2.5.5: Mar 24 2003</h3><ul><li>Lot of fixes on the Relax NG implementation. More testing
+ includingDocBook and TEI examples.</li>
<li>Increased the support for W3C XML Schemas datatype</li>
<li>Several bug fixes in the URI handling layer</li>
- <li>Bug fixes: HTML parser, xmlReader, DTD validation, XPath, encoding
- conversion, line counting in the parser.</li>
+ <li>Bug fixes: HTML parser, xmlReader, DTD validation, XPath,
+ encodingconversion, line counting in the parser.</li>
<li>Added support for $XMLLINT_INDENT environment variable, FTP delete</li>
<li>Fixed the RPM spec file name</li>
-</ul><h3>2.5.4: Feb 20 2003</h3><ul><li>Conformance testing and lot of fixes on Relax NG and XInclude
- implementation</li>
+</ul><h3>2.5.4: Feb 20 2003</h3><ul><li>Conformance testing and lot of fixes on Relax NG and
+ XIncludeimplementation</li>
<li>Implementation of XPointer element() scheme</li>
- <li>Bug fixes: XML parser, XInclude entities merge, validity checking on
- namespaces,
- <p>2 serialization bugs, node info generation problems, a DTD regexp
- generation problem.</p>
+ <li>Bug fixes: XML parser, XInclude entities merge, validity checking
+ onnamespaces,
+ <p>2 serialization bugs, node info generation problems, a DTD
+ regexpgeneration problem.</p>
</li>
<li>Portability: windows updates and path canonicalization (Igor)</li>
<li>A few typo fixes (Kjartan Maraas)</li>
<li>Python bindings generator fixes (Stephane Bidoul)</li>
-</ul><h3>2.5.3: Feb 10 2003</h3><ul><li>RelaxNG and XML Schemas datatypes improvements, and added a first
- version of RelaxNG Python bindings</li>
- <li>Fixes: XLink (Sean Chittenden), XInclude (Sean Chittenden), API fix for
- serializing namespace nodes, encoding conversion bug, XHTML1
- serialization</li>
+</ul><h3>2.5.3: Feb 10 2003</h3><ul><li>RelaxNG and XML Schemas datatypes improvements, and added a
+ firstversion of RelaxNG Python bindings</li>
+ <li>Fixes: XLink (Sean Chittenden), XInclude (Sean Chittenden), API fix
+ forserializing namespace nodes, encoding conversion bug,
+ XHTML1serialization</li>
<li>Portability fixes: Windows (Igor), AMD 64bits RPM spec file</li>
</ul><h3>2.5.2: Feb 5 2003</h3><ul><li>First implementation of RelaxNG, added --relaxng flag to xmllint</li>
<li>Schemas support now compiled in by default.</li>
- <li>Bug fixes: DTD validation, namespace checking, XInclude and entities,
- delegateURI in XML Catalogs, HTML parser, XML reader (Stéphane Bidoul),
- XPath parser and evaluation, UTF8ToUTF8 serialization, XML reader memory
- consumption, HTML parser, HTML serialization in the presence of
- namespaces</li>
+ <li>Bug fixes: DTD validation, namespace checking, XInclude and
+ entities,delegateURI in XML Catalogs, HTML parser, XML reader (Stéphane
+ Bidoul),XPath parser and evaluation, UTF8ToUTF8 serialization, XML
+ reader memoryconsumption, HTML parser, HTML serialization in the presence
+ ofnamespaces</li>
<li>added an HTML API to check elements and attributes.</li>
- <li>Documentation improvement, PDF for the tutorial (John Fleck), doc
- patches (Stefan Kost)</li>
+ <li>Documentation improvement, PDF for the tutorial (John Fleck),
+ docpatches (Stefan Kost)</li>
<li>Portability fixes: NetBSD (Julio Merino), Windows (Igor Zlatkovic)</li>
- <li>Added python bindings for XPointer, contextual error reporting
- (Stéphane Bidoul)</li>
+ <li>Added python bindings for XPointer, contextual error reporting(Stéphane
+ Bidoul)</li>
<li>URI/file escaping problems (Stefano Zacchiroli)</li>
</ul><h3>2.5.1: Jan 8 2003</h3><ul><li>Fixes a memory leak and configuration/compilation problems in 2.5.0</li>
<li>documentation updates (John)</li>
<li>a couple of XmlTextReader fixes</li>
-</ul><h3>2.5.0: Jan 6 2003</h3><ul><li>New <a href="xmlreader.html">XmltextReader interface</a> based on C#
- API (with help of Stéphane Bidoul)</li>
+</ul><h3>2.5.0: Jan 6 2003</h3><ul><li>New <a href="xmlreader.html">XmltextReader interface</a>based on C#API
+ (with help of Stéphane Bidoul)</li>
<li>Windows: more exports, including the new API (Igor)</li>
<li>XInclude fallback fix</li>
- <li>Python: bindings for the new API, packaging (Stéphane Bidoul),
- drv_libxml2.py Python xml.sax driver (Stéphane Bidoul), fixes, speedup
- and iterators for Python-2.2 (Hannu Krosing)</li>
- <li>Tutorial fixes (john Fleck and Niraj Tolia) xmllint man update
- (John)</li>
+ <li>Python: bindings for the new API, packaging (Stéphane
+ Bidoul),drv_libxml2.py Python xml.sax driver (Stéphane Bidoul), fixes,
+ speedupand iterators for Python-2.2 (Hannu Krosing)</li>
+ <li>Tutorial fixes (john Fleck and Niraj Tolia) xmllint man
+ update(John)</li>
<li>Fix an XML parser bug raised by Vyacheslav Pindyura</li>
<li>Fix for VMS serialization (Nigel Hall) and config (Craig A. Berry)</li>
<li>Entities handling fixes</li>
- <li>new API to optionally track node creation and deletion (Lukas
- Schroeder)</li>
+ <li>new API to optionally track node creation and deletion
+ (LukasSchroeder)</li>
<li>Added documentation for the XmltextReader interface and some <a href="guidelines.html">XML guidelines</a></li>
</ul><h3>2.4.30: Dec 12 2002</h3><ul><li>2.4.29 broke the python bindings, rereleasing</li>
- <li>Improvement/fixes of the XML API generator, and couple of minor code
- fixes.</li>
-</ul><h3>2.4.29: Dec 11 2002</h3><ul><li>Windows fixes (Igor): Windows CE port, pthread linking, python bindings
- (Stéphane Bidoul), Mingw (Magnus Henoch), and export list updates</li>
+ <li>Improvement/fixes of the XML API generator, and couple of minor
+ codefixes.</li>
+</ul><h3>2.4.29: Dec 11 2002</h3><ul><li>Windows fixes (Igor): Windows CE port, pthread linking, python
+ bindings(Stéphane Bidoul), Mingw (Magnus Henoch), and export list
+ updates</li>
<li>Fix for prev in python bindings (ERDI Gergo)</li>
<li>Fix for entities handling (Marcus Clarke)</li>
- <li>Refactored the XML and HTML dumps to a single code path, fixed XHTML1
- dump</li>
+ <li>Refactored the XML and HTML dumps to a single code path, fixed
+ XHTML1dump</li>
<li>Fix for URI parsing when handling URNs with fragment identifiers</li>
<li>Fix for HTTP URL escaping problem</li>
<li>added an TextXmlReader (C#) like API (work in progress)</li>
- <li>Rewrote the API in XML generation script, includes a C parser and saves
- more informations needed for C# bindings</li>
+ <li>Rewrote the API in XML generation script, includes a C parser and
+ savesmore informations needed for C# bindings</li>
</ul><h3>2.4.28: Nov 22 2002</h3><ul><li>a couple of python binding fixes</li>
<li>2 bug fixes in the XML push parser</li>
<li>potential memory leak removed (Martin Stoilov)</li>
@@ -724,41 +737,40 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p><p>
<li>autodetection of XHTML1 and specific serialization rules added</li>
<li>nasty threading bug fixed (William Brack)</li>
</ul><h3>2.4.27: Nov 17 2002</h3><ul><li>fixes for the Python bindings</li>
- <li>a number of bug fixes: SGML catalogs, xmlParseBalancedChunkMemory(),
- HTML parser, Schemas (Charles Bozeman), document fragment support
- (Christian Glahn), xmlReconciliateNs (Brian Stafford), XPointer,
- xmlFreeNode(), xmlSAXParseMemory (Peter Jones), xmlGetNodePath (Petr
- Pajas), entities processing</li>
+ <li>a number of bug fixes: SGML catalogs,
+ xmlParseBalancedChunkMemory(),HTML parser, Schemas (Charles Bozeman),
+ document fragment support(Christian Glahn), xmlReconciliateNs (Brian
+ Stafford), XPointer,xmlFreeNode(), xmlSAXParseMemory (Peter Jones),
+ xmlGetNodePath (PetrPajas), entities processing</li>
<li>added grep to xmllint --shell</li>
<li>VMS update patch from Craig A. Berry</li>
- <li>cleanup of the Windows build with support for more compilers (Igor),
- better thread support on Windows</li>
+ <li>cleanup of the Windows build with support for more compilers
+ (Igor),better thread support on Windows</li>
<li>cleanup of Unix Makefiles and spec file</li>
<li>Improvements to the documentation (John Fleck)</li>
</ul><h3>2.4.26: Oct 18 2002</h3><ul><li>Patches for Windows CE port, improvements on Windows paths handling</li>
- <li>Fixes to the validation code (DTD and Schemas), xmlNodeGetPath() ,
- HTML serialization, Namespace compliance, and a number of small
- problems</li>
-</ul><h3>2.4.25: Sep 26 2002</h3><ul><li>A number of bug fixes: XPath, validation, Python bindings, DOM and
- tree, xmlI/O, Html</li>
+ <li>Fixes to the validation code (DTD and Schemas), xmlNodeGetPath() ,HTML
+ serialization, Namespace compliance, and a number of smallproblems</li>
+</ul><h3>2.4.25: Sep 26 2002</h3><ul><li>A number of bug fixes: XPath, validation, Python bindings, DOM andtree,
+ xmlI/O, Html</li>
<li>Serious rewrite of XInclude</li>
- <li>Made XML Schemas regexp part of the default build and APIs, small fix
- and improvement of the regexp core</li>
+ <li>Made XML Schemas regexp part of the default build and APIs, small
+ fixand improvement of the regexp core</li>
<li>Changed the validation code to reuse XML Schemas regexp APIs</li>
- <li>Better handling of Windows file paths, improvement of Makefiles (Igor,
- Daniel Gehriger, Mark Vakoc)</li>
- <li>Improved the python I/O bindings, the tests, added resolver and regexp
- APIs</li>
+ <li>Better handling of Windows file paths, improvement of Makefiles
+ (Igor,Daniel Gehriger, Mark Vakoc)</li>
+ <li>Improved the python I/O bindings, the tests, added resolver and
+ regexpAPIs</li>
<li>New logos from Marc Liyanage</li>
<li>Tutorial improvements: John Fleck, Christopher Harris</li>
- <li>Makefile: Fixes for AMD x86_64 (Mandrake), DESTDIR (Christophe
- Merlet)</li>
+ <li>Makefile: Fixes for AMD x86_64 (Mandrake), DESTDIR
+ (ChristopheMerlet)</li>
<li>removal of all stderr/perror use for error reporting</li>
<li>Better error reporting: XPath and DTD validation</li>
<li>update of the trio portability layer (Bjorn Reese)</li>
</ul><p><strong>2.4.24: Aug 22 2002</strong></p><ul><li>XPath fixes (William), xf:escape-uri() (Wesley Terpstra)</li>
- <li>Python binding fixes: makefiles (William), generator, rpm build, x86-64
- (fcrozat)</li>
+ <li>Python binding fixes: makefiles (William), generator, rpm build,
+ x86-64(fcrozat)</li>
<li>HTML &lt;style&gt; and boolean attributes serializer fixes</li>
<li>C14N improvements by Aleksey</li>
<li>doc cleanups: Rick Jones</li>
@@ -768,96 +780,97 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p><p>
<li>c14n fixes, testsuite and performances: Aleksey Sanin</li>
<li>added xmlDocFormatDump: Chema Celorio</li>
<li>new tutorial: John Fleck</li>
- <li>new hash functions and performances: Sander Vesik, portability fix from
- Peter Jacobi</li>
- <li>a number of bug fixes: XPath (William Brack, Richard Jinks), XML and
- HTML parsers, ID lookup function</li>
+ <li>new hash functions and performances: Sander Vesik, portability fix
+ fromPeter Jacobi</li>
+ <li>a number of bug fixes: XPath (William Brack, Richard Jinks), XML
+ andHTML parsers, ID lookup function</li>
<li>removal of all remaining sprintf: Aleksey Sanin</li>
-</ul><h3>2.4.22: May 27 2002</h3><ul><li>a number of bug fixes: configure scripts, base handling, parser, memory
- usage, HTML parser, XPath, documentation (Christian Cornelssen),
- indentation, URI parsing</li>
- <li>Optimizations for XMLSec, fixing and making public some of the network
- protocol handlers (Aleksey)</li>
+</ul><h3>2.4.22: May 27 2002</h3><ul><li>a number of bug fixes: configure scripts, base handling, parser,
+ memoryusage, HTML parser, XPath, documentation (Christian
+ Cornelssen),indentation, URI parsing</li>
+ <li>Optimizations for XMLSec, fixing and making public some of the
+ networkprotocol handlers (Aleksey)</li>
<li>performance patch from Gary Pennington</li>
- <li>Charles Bozeman provided date and time support for XML Schemas
- datatypes</li>
-</ul><h3>2.4.21: Apr 29 2002</h3><p>This release is both a bug fix release and also contains the early XML
-Schemas <a href="http://www.w3.org/TR/xmlschema-1/">structures</a> and <a href="http://www.w3.org/TR/xmlschema-2/">datatypes</a> code, beware, all
-interfaces are likely to change, there is huge holes, it is clearly a work in
-progress and don't even think of putting this code in a production system,
-it's actually not compiled in by default. The real fixes are:</p><ul><li>a couple of bugs or limitations introduced in 2.4.20</li>
+ <li>Charles Bozeman provided date and time support for XML
+ Schemasdatatypes</li>
+</ul><h3>2.4.21: Apr 29 2002</h3><p>This release is both a bug fix release and also contains the early
+XMLSchemas <a href="http://www.w3.org/TR/xmlschema-1/">structures</a>and <a href="http://www.w3.org/TR/xmlschema-2/">datatypes</a>code, beware,
+allinterfaces are likely to change, there is huge holes, it is clearly a work
+inprogress and don't even think of putting this code in a production
+system,it's actually not compiled in by default. The real fixes are:</p><ul><li>a couple of bugs or limitations introduced in 2.4.20</li>
<li>patches for Borland C++ and MSC by Igor</li>
- <li>some fixes on XPath strings and conformance patches by Richard
- Jinks</li>
+ <li>some fixes on XPath strings and conformance patches by RichardJinks</li>
<li>patch from Aleksey for the ExcC14N specification</li>
<li>OSF/1 bug fix by Bjorn</li>
</ul><h3>2.4.20: Apr 15 2002</h3><ul><li>bug fixes: file descriptor leak, XPath, HTML output, DTD validation</li>
<li>XPath conformance testing by Richard Jinks</li>
- <li>Portability fixes: Solaris, MPE/iX, Windows, OSF/1, python bindings,
- libxml.m4</li>
-</ul><h3>2.4.19: Mar 25 2002</h3><ul><li>bug fixes: half a dozen XPath bugs, Validation, ISO-Latin to UTF8
- encoder</li>
+ <li>Portability fixes: Solaris, MPE/iX, Windows, OSF/1, python
+ bindings,libxml.m4</li>
+</ul><h3>2.4.19: Mar 25 2002</h3><ul><li>bug fixes: half a dozen XPath bugs, Validation, ISO-Latin to
+ UTF8encoder</li>
<li>portability fixes in the HTTP code</li>
<li>memory allocation checks using valgrind, and profiling tests</li>
<li>revamp of the Windows build and Makefiles</li>
-</ul><h3>2.4.18: Mar 18 2002</h3><ul><li>bug fixes: tree, SAX, canonicalization, validation, portability,
- XPath</li>
+</ul><h3>2.4.18: Mar 18 2002</h3><ul><li>bug fixes: tree, SAX, canonicalization, validation,
+ portability,XPath</li>
<li>removed the --with-buffer option it was becoming unmaintainable</li>
<li>serious cleanup of the Python makefiles</li>
<li>speedup patch to XPath very effective for DocBook stylesheets</li>
<li>Fixes for Windows build, cleanup of the documentation</li>
-</ul><h3>2.4.17: Mar 8 2002</h3><ul><li>a lot of bug fixes, including "namespace nodes have no parents in
- XPath"</li>
- <li>fixed/improved the Python wrappers, added more examples and more
- regression tests, XPath extension functions can now return node-sets</li>
+</ul><h3>2.4.17: Mar 8 2002</h3><ul><li>a lot of bug fixes, including "namespace nodes have no parents
+ inXPath"</li>
+ <li>fixed/improved the Python wrappers, added more examples and
+ moreregression tests, XPath extension functions can now return
+ node-sets</li>
<li>added the XML Canonicalization support from Aleksey Sanin</li>
-</ul><h3>2.4.16: Feb 20 2002</h3><ul><li>a lot of bug fixes, most of them were triggered by the XML Testsuite
- from OASIS and W3C. Compliance has been significantly improved.</li>
+</ul><h3>2.4.16: Feb 20 2002</h3><ul><li>a lot of bug fixes, most of them were triggered by the XML
+ Testsuitefrom OASIS and W3C. Compliance has been significantly
+ improved.</li>
<li>a couple of portability fixes too.</li>
</ul><h3>2.4.15: Feb 11 2002</h3><ul><li>Fixed the Makefiles, especially the python module ones</li>
<li>A few bug fixes and cleanup</li>
<li>Includes cleanup</li>
-</ul><h3>2.4.14: Feb 8 2002</h3><ul><li>Change of License to the <a href="http://www.opensource.org/licenses/mit-license.html">MIT
- License</a> basically for integration in XFree86 codebase, and removing
- confusion around the previous dual-licensing</li>
- <li>added Python bindings, beta software but should already be quite
- complete</li>
- <li>a large number of fixes and cleanups, especially for all tree
- manipulations</li>
- <li>cleanup of the headers, generation of a reference API definition in
- XML</li>
+</ul><h3>2.4.14: Feb 8 2002</h3><ul><li>Change of License to the <a href="http://www.opensource.org/licenses/mit-license.html">MITLicense</a>basically
+ for integration in XFree86 codebase, and removingconfusion around the
+ previous dual-licensing</li>
+ <li>added Python bindings, beta software but should already be
+ quitecomplete</li>
+ <li>a large number of fixes and cleanups, especially for all
+ treemanipulations</li>
+ <li>cleanup of the headers, generation of a reference API definition
+ inXML</li>
</ul><h3>2.4.13: Jan 14 2002</h3><ul><li>update of the documentation: John Fleck and Charlie Bozeman</li>
<li>cleanup of timing code from Justin Fletcher</li>
- <li>fixes for Windows and initial thread support on Win32: Igor and Serguei
- Narojnyi</li>
+ <li>fixes for Windows and initial thread support on Win32: Igor and
+ SergueiNarojnyi</li>
<li>Cygwin patch from Robert Collins</li>
<li>added xmlSetEntityReferenceFunc() for Keith Isdale work on xsldbg</li>
-</ul><h3>2.4.12: Dec 7 2001</h3><ul><li>a few bug fixes: thread (Gary Pennington), xmllint (Geert Kloosterman),
- XML parser (Robin Berjon), XPointer (Danny Jamshy), I/O cleanups
- (robert)</li>
+</ul><h3>2.4.12: Dec 7 2001</h3><ul><li>a few bug fixes: thread (Gary Pennington), xmllint (Geert
+ Kloosterman),XML parser (Robin Berjon), XPointer (Danny Jamshy), I/O
+ cleanups(robert)</li>
<li>Eric Lavigne contributed project files for MacOS</li>
<li>some makefiles cleanups</li>
-</ul><h3>2.4.11: Nov 26 2001</h3><ul><li>fixed a couple of errors in the includes, fixed a few bugs, some code
- cleanups</li>
+</ul><h3>2.4.11: Nov 26 2001</h3><ul><li>fixed a couple of errors in the includes, fixed a few bugs, some
+ codecleanups</li>
<li>xmllint man pages improvement by Heiko Rupp</li>
<li>updated VMS build instructions from John A Fotheringham</li>
<li>Windows Makefiles updates from Igor</li>
</ul><h3>2.4.10: Nov 10 2001</h3><ul><li>URI escaping fix (Joel Young)</li>
<li>added xmlGetNodePath() (for paths or XPointers generation)</li>
<li>Fixes namespace handling problems when using DTD and validation</li>
- <li>improvements on xmllint: Morus Walter patches for --format and
- --encode, Stefan Kost and Heiko Rupp improvements on the --shell</li>
+ <li>improvements on xmllint: Morus Walter patches for --format and--encode,
+ Stefan Kost and Heiko Rupp improvements on the --shell</li>
<li>fixes for xmlcatalog linking pointed by Weiqi Gao</li>
<li>fixes to the HTML parser</li>
</ul><h3>2.4.9: Nov 6 2001</h3><ul><li>fixes more catalog bugs</li>
<li>avoid a compilation problem, improve xmlGetLineNo()</li>
-</ul><h3>2.4.8: Nov 4 2001</h3><ul><li>fixed SGML catalogs broken in previous release, updated xmlcatalog
- tool</li>
+</ul><h3>2.4.8: Nov 4 2001</h3><ul><li>fixed SGML catalogs broken in previous release, updated
+ xmlcatalogtool</li>
<li>fixed a compile errors and some includes troubles.</li>
</ul><h3>2.4.7: Oct 30 2001</h3><ul><li>exported some debugging interfaces</li>
<li>serious rewrite of the catalog code</li>
- <li>integrated Gary Pennington thread safety patch, added configure option
- and regression tests</li>
+ <li>integrated Gary Pennington thread safety patch, added configure
+ optionand regression tests</li>
<li>removed an HTML parser bug</li>
<li>fixed a couple of potentially serious validation bugs</li>
<li>integrated the SGML DocBook support in xmllint</li>
@@ -873,12 +886,11 @@ it's actually not compiled in by default. The real fixes are:</p><ul><li>a coupl
<li>fixed half a dozen bugs reported for libxml or libxslt</li>
<li>updated xmlcatalog to be able to modify SGML super catalogs</li>
</ul><h3>2.4.5: Sep 14 2001</h3><ul><li>Remove a few annoying bugs in 2.4.4</li>
- <li>forces the HTML serializer to output decimal charrefs since some
- version of Netscape can't handle hexadecimal ones</li>
-</ul><h3>1.8.16: Sep 14 2001</h3><ul><li>maintenance release of the old libxml1 branch, couple of bug and
- portability fixes</li>
-</ul><h3>2.4.4: Sep 12 2001</h3><ul><li>added --convert to xmlcatalog, bug fixes and cleanups of XML
- Catalog</li>
+ <li>forces the HTML serializer to output decimal charrefs since someversion
+ of Netscape can't handle hexadecimal ones</li>
+</ul><h3>1.8.16: Sep 14 2001</h3><ul><li>maintenance release of the old libxml1 branch, couple of bug
+ andportability fixes</li>
+</ul><h3>2.4.4: Sep 12 2001</h3><ul><li>added --convert to xmlcatalog, bug fixes and cleanups of XMLCatalog</li>
<li>a few bug fixes and some portability changes</li>
<li>some documentation cleanups</li>
</ul><h3>2.4.3: Aug 23 2001</h3><ul><li>XML Catalog support see the doc</li>
@@ -896,13 +908,13 @@ it's actually not compiled in by default. The real fixes are:</p><ul><li>a coupl
<li>cleanup for alpha and ia64 targets</li>
<li>patch to allow saving through HTTP PUT or POST</li>
</ul><h3>2.4.0: July 10 2001</h3><ul><li>Fixed a few bugs in XPath, validation, and tree handling.</li>
- <li>Fixed XML Base implementation, added a couple of examples to the
- regression tests</li>
+ <li>Fixed XML Base implementation, added a couple of examples to
+ theregression tests</li>
<li>A bit of cleanup</li>
-</ul><h3>2.3.14: July 5 2001</h3><ul><li>fixed some entities problems and reduce memory requirement when
- substituting them</li>
- <li>lots of improvements in the XPath queries interpreter can be
- substantially faster</li>
+</ul><h3>2.3.14: July 5 2001</h3><ul><li>fixed some entities problems and reduce memory requirement
+ whensubstituting them</li>
+ <li>lots of improvements in the XPath queries interpreter can
+ besubstantially faster</li>
<li>Makefiles and configure cleanups</li>
<li>Fixes to XPath variable eval, and compare on empty node set</li>
<li>HTML tag closing bug fixed</li>
@@ -916,37 +928,38 @@ it's actually not compiled in by default. The real fixes are:</p><ul><li>a coupl
<li>fixed line number counting</li>
<li>fixed serious problems in the XInclude processing</li>
<li>added support for UTF8 BOM at beginning of entities</li>
- <li>fixed a strange gcc optimizer bugs in xpath handling of float, gcc-3.0
- miscompile uri.c (William), Thomas Leitner provided a fix for the
- optimizer on Tru64</li>
- <li>incorporated Yon Derek and Igor Zlatkovic fixes and improvements for
- compilation on Windows MSC</li>
+ <li>fixed a strange gcc optimizer bugs in xpath handling of float,
+ gcc-3.0miscompile uri.c (William), Thomas Leitner provided a fix for
+ theoptimizer on Tru64</li>
+ <li>incorporated Yon Derek and Igor Zlatkovic fixes and improvements
+ forcompilation on Windows MSC</li>
<li>update of libxml-doc.el (Felix Natter)</li>
<li>fixed 2 bugs in URI normalization code</li>
-</ul><h3>2.3.11: June 17 2001</h3><ul><li>updates to trio, Makefiles and configure should fix some portability
- problems (alpha)</li>
- <li>fixed some HTML serialization problems (pre, script, and block/inline
- handling), added encoding aware APIs, cleanup of this code</li>
+</ul><h3>2.3.11: June 17 2001</h3><ul><li>updates to trio, Makefiles and configure should fix some
+ portabilityproblems (alpha)</li>
+ <li>fixed some HTML serialization problems (pre, script, and
+ block/inlinehandling), added encoding aware APIs, cleanup of this
+ code</li>
<li>added xmlHasNsProp()</li>
- <li>implemented a specific PI for encoding support in the DocBook SGML
- parser</li>
- <li>some XPath fixes (-Infinity, / as a function parameter and namespaces
- node selection)</li>
+ <li>implemented a specific PI for encoding support in the DocBook
+ SGMLparser</li>
+ <li>some XPath fixes (-Infinity, / as a function parameter and
+ namespacesnode selection)</li>
<li>fixed a performance problem and an error in the validation code</li>
<li>fixed XInclude routine to implement the recursive behaviour</li>
<li>fixed xmlFreeNode problem when libxml is included statically twice</li>
<li>added --version to xmllint for bug reports</li>
</ul><h3>2.3.10: June 1 2001</h3><ul><li>fixed the SGML catalog support</li>
- <li>a number of reported bugs got fixed, in XPath, iconv detection,
- XInclude processing</li>
+ <li>a number of reported bugs got fixed, in XPath, iconv detection,XInclude
+ processing</li>
<li>XPath string function should now handle unicode correctly</li>
</ul><h3>2.3.9: May 19 2001</h3><p>Lots of bugfixes, and added a basic SGML catalog support:</p><ul><li>HTML push bugfix #54891 and another patch from Jonas Borgström</li>
<li>some serious speed optimization again</li>
<li>some documentation cleanups</li>
<li>trying to get better linking on Solaris (-R)</li>
<li>XPath API cleanup from Thomas Broyer</li>
- <li>Validation bug fixed #54631, added a patch from Gary Pennington, fixed
- xmlValidGetValidElements()</li>
+ <li>Validation bug fixed #54631, added a patch from Gary Pennington,
+ fixedxmlValidGetValidElements()</li>
<li>Added an INSTALL file</li>
<li>Attribute removal added to API: #54433</li>
<li>added a basic support for SGML catalogs</li>
@@ -957,10 +970,10 @@ it's actually not compiled in by default. The real fixes are:</p><ul><li>a coupl
</ul><h3>1.8.13: May 14 2001</h3><ul><li>bugfixes release of the old libxml1 branch used by Gnome</li>
</ul><h3>2.3.8: May 3 2001</h3><ul><li>Integrated an SGML DocBook parser for the Gnome project</li>
<li>Fixed a few things in the HTML parser</li>
- <li>Fixed some XPath bugs raised by XSLT use, tried to fix the floating
- point portability issue</li>
- <li>Speed improvement (8M/s for SAX, 3M/s for DOM, 1.5M/s for
- DOM+validation using the XML REC as input and a 700MHz celeron).</li>
+ <li>Fixed some XPath bugs raised by XSLT use, tried to fix the
+ floatingpoint portability issue</li>
+ <li>Speed improvement (8M/s for SAX, 3M/s for DOM, 1.5M/s forDOM+validation
+ using the XML REC as input and a 700MHz celeron).</li>
<li>incorporated more Windows cleanup</li>
<li>added xmlSaveFormatFile()</li>
<li>fixed problems in copying nodes with entities references (gdome)</li>
@@ -975,32 +988,33 @@ it's actually not compiled in by default. The real fixes are:</p><ul><li>a coupl
<li>Improved validation speed sensible for DocBook</li>
<li>fixed a big bug with ID declared in external parsed entities</li>
<li>portability fixes, update of Trio from Bjorn Reese</li>
-</ul><h3>2.3.6: April 8 2001</h3><ul><li>Code cleanup using extreme gcc compiler warning options, found and
- cleared half a dozen potential problem</li>
+</ul><h3>2.3.6: April 8 2001</h3><ul><li>Code cleanup using extreme gcc compiler warning options, found
+ andcleared half a dozen potential problem</li>
<li>the Eazel team found an XML parser bug</li>
- <li>cleaned up the user of some of the string formatting function. used the
- trio library code to provide the one needed when the platform is missing
- them</li>
- <li>xpath: removed a memory leak and fixed the predicate evaluation
- problem, extended the testsuite and cleaned up the result. XPointer seems
- broken ...</li>
-</ul><h3>2.3.5: Mar 23 2001</h3><ul><li>Biggest change is separate parsing and evaluation of XPath expressions,
- there is some new APIs for this too</li>
- <li>included a number of bug fixes(XML push parser, 51876, notations,
- 52299)</li>
+ <li>cleaned up the user of some of the string formatting function. used
+ thetrio library code to provide the one needed when the platform is
+ missingthem</li>
+ <li>xpath: removed a memory leak and fixed the predicate evaluationproblem,
+ extended the testsuite and cleaned up the result. XPointer seemsbroken
+ ...</li>
+</ul><h3>2.3.5: Mar 23 2001</h3><ul><li>Biggest change is separate parsing and evaluation of XPath
+ expressions,there is some new APIs for this too</li>
+ <li>included a number of bug fixes(XML push parser, 51876,
+ notations,52299)</li>
<li>Fixed some portability issues</li>
</ul><h3>2.3.4: Mar 10 2001</h3><ul><li>Fixed bugs #51860 and #51861</li>
- <li>Added a global variable xmlDefaultBufferSize to allow default buffer
- size to be application tunable.</li>
- <li>Some cleanup in the validation code, still a bug left and this part
- should probably be rewritten to support ambiguous content model :-\</li>
- <li>Fix a couple of serious bugs introduced or raised by changes in 2.3.3
- parser</li>
+ <li>Added a global variable xmlDefaultBufferSize to allow default
+ buffersize to be application tunable.</li>
+ <li>Some cleanup in the validation code, still a bug left and this
+ partshould probably be rewritten to support ambiguous content model
+ :-\</li>
+ <li>Fix a couple of serious bugs introduced or raised by changes in
+ 2.3.3parser</li>
<li>Fixed another bug in xmlNodeGetContent()</li>
<li>Bjorn fixed XPath node collection and Number formatting</li>
<li>Fixed a loop reported in the HTML parsing</li>
- <li>blank space are reported even if the Dtd content model proves that they
- are formatting spaces, this is for XML conformance</li>
+ <li>blank space are reported even if the Dtd content model proves that
+ theyare formatting spaces, this is for XML conformance</li>
</ul><h3>2.3.3: Mar 1 2001</h3><ul><li>small change in XPath for XSLT</li>
<li>documentation cleanups</li>
<li>fix in validation by Gary Pennington</li>
@@ -1010,18 +1024,18 @@ it's actually not compiled in by default. The real fixes are:</p><ul><li>a coupl
<li>fixed a bug in xmlNodeGetContent</li>
<li>ID/IDREF support partly rewritten by Gary Pennington</li>
</ul><h3>2.3.1: Feb 15 2001</h3><ul><li>some XPath and HTML bug fixes for XSLT</li>
- <li>small extension of the hash table interfaces for DOM gdome2
- implementation</li>
+ <li>small extension of the hash table interfaces for DOM
+ gdome2implementation</li>
<li>A few bug fixes</li>
</ul><h3>2.3.0: Feb 8 2001 (2.2.12 was on 25 Jan but I didn't kept track)</h3><ul><li>Lots of XPath bug fixes</li>
- <li>Add a mode with Dtd lookup but without validation error reporting for
- XSLT</li>
+ <li>Add a mode with Dtd lookup but without validation error reporting
+ forXSLT</li>
<li>Add support for text node without escaping (XSLT)</li>
<li>bug fixes for xmlCheckFilename</li>
<li>validation code bug fixes from Gary Pennington</li>
<li>Patch from Paul D. Smith correcting URI path normalization</li>
- <li>Patch to allow simultaneous install of libxml-devel and
- libxml2-devel</li>
+ <li>Patch to allow simultaneous install of libxml-devel
+ andlibxml2-devel</li>
<li>the example Makefile is now fixed</li>
<li>added HTML to the RPM packages</li>
<li>tree copying bugfixes</li>
@@ -1038,8 +1052,7 @@ it's actually not compiled in by default. The real fixes are:</p><ul><li>a coupl
<li>Improved the XPointer implementation</li>
<li>integrate a number of provided patches</li>
</ul><h3>2.2.9: Nov 25 2000</h3><ul><li>erroneous release :-(</li>
-</ul><h3>2.2.8: Nov 13 2000</h3><ul><li>First version of <a href="http://www.w3.org/TR/xinclude">XInclude</a>
- support</li>
+</ul><h3>2.2.8: Nov 13 2000</h3><ul><li>First version of <a href="http://www.w3.org/TR/xinclude">XInclude</a>support</li>
<li>Patch in conditional section handling</li>
<li>updated MS compiler project</li>
<li>fixed some XPath problems</li>
@@ -1050,19 +1063,19 @@ it's actually not compiled in by default. The real fixes are:</p><ul><li>a coupl
<li>xmlIOParseDTD() added</li>
<li>various small fixes in the HTML, URI, HTTP and XPointer support</li>
<li>some cleanup of the Makefile, autoconf and the distribution content</li>
-</ul><h3>2.2.6: Oct 25 2000:</h3><ul><li>Added an hash table module, migrated a number of internal structure to
- those</li>
+</ul><h3>2.2.6: Oct 25 2000:</h3><ul><li>Added an hash table module, migrated a number of internal structure
+ tothose</li>
<li>Fixed a posteriori validation problems</li>
<li>HTTP module cleanups</li>
- <li>HTML parser improvements (tag errors, script/style handling, attribute
- normalization)</li>
+ <li>HTML parser improvements (tag errors, script/style handling,
+ attributenormalization)</li>
<li>coalescing of adjacent text nodes</li>
<li>couple of XPath bug fixes, exported the internal API</li>
</ul><h3>2.2.5: Oct 15 2000:</h3><ul><li>XPointer implementation and testsuite</li>
- <li>Lot of XPath fixes, added variable and functions registration, more
- tests</li>
- <li>Portability fixes, lots of enhancements toward an easy Windows build
- and release</li>
+ <li>Lot of XPath fixes, added variable and functions registration,
+ moretests</li>
+ <li>Portability fixes, lots of enhancements toward an easy Windows buildand
+ release</li>
<li>Late validation fixes</li>
<li>Integrated a lot of contributed patches</li>
<li>added memory management docs</li>
@@ -1072,115 +1085,113 @@ it's actually not compiled in by default. The real fixes are:</p><ul><li>a coupl
<li>Serious bug fixes on the URI and HTML code</li>
</ul><h3>2.2.3: Sep 17 2000</h3><ul><li>bug fixes</li>
<li>cleanup of entity handling code</li>
- <li>overall review of all loops in the parsers, all sprintf usage has been
- checked too</li>
- <li>Far better handling of larges Dtd. Validating against DocBook XML Dtd
- works smoothly now.</li>
+ <li>overall review of all loops in the parsers, all sprintf usage has
+ beenchecked too</li>
+ <li>Far better handling of larges Dtd. Validating against DocBook XML
+ Dtdworks smoothly now.</li>
</ul><h3>1.8.10: Sep 6 2000</h3><ul><li>bug fix release for some Gnome projects</li>
</ul><h3>2.2.2: August 12 2000</h3><ul><li>mostly bug fixes</li>
<li>started adding routines to access xml parser context options</li>
</ul><h3>2.2.1: July 21 2000</h3><ul><li>a purely bug fixes release</li>
<li>fixed an encoding support problem when parsing from a memory block</li>
<li>fixed a DOCTYPE parsing problem</li>
- <li>removed a bug in the function allowing to override the memory
- allocation routines</li>
+ <li>removed a bug in the function allowing to override the memoryallocation
+ routines</li>
</ul><h3>2.2.0: July 14 2000</h3><ul><li>applied a lot of portability fixes</li>
- <li>better encoding support/cleanup and saving (content is now always
- encoded in UTF-8)</li>
+ <li>better encoding support/cleanup and saving (content is now
+ alwaysencoded in UTF-8)</li>
<li>the HTML parser now correctly handles encodings</li>
<li>added xmlHasProp()</li>
<li>fixed a serious problem with &amp;#38;</li>
<li>propagated the fix to FTP client</li>
<li>cleanup, bugfixes, etc ...</li>
- <li>Added a page about <a href="encoding.html">libxml Internationalization
- support</a></li>
+ <li>Added a page about <a href="encoding.html">libxml
+ Internationalizationsupport</a></li>
</ul><h3>1.8.9: July 9 2000</h3><ul><li>fixed the spec the RPMs should be better</li>
- <li>fixed a serious bug in the FTP implementation, released 1.8.9 to solve
- rpmfind users problem</li>
+ <li>fixed a serious bug in the FTP implementation, released 1.8.9 to
+ solverpmfind users problem</li>
</ul><h3>2.1.1: July 1 2000</h3><ul><li>fixes a couple of bugs in the 2.1.0 packaging</li>
<li>improvements on the HTML parser</li>
-</ul><h3>2.1.0 and 1.8.8: June 29 2000</h3><ul><li>1.8.8 is mostly a commodity package for upgrading to libxml2 according
- to <a href="upgrade.html">new instructions</a>. It fixes a nasty problem
- about &amp;#38; charref parsing</li>
- <li>2.1.0 also ease the upgrade from libxml v1 to the recent version. it
- also contains numerous fixes and enhancements:
+</ul><h3>2.1.0 and 1.8.8: June 29 2000</h3><ul><li>1.8.8 is mostly a commodity package for upgrading to libxml2
+ accordingto <a href="upgrade.html">new instructions</a>. It fixes a nasty
+ problemabout &amp;#38; charref parsing</li>
+ <li>2.1.0 also ease the upgrade from libxml v1 to the recent version.
+ italso contains numerous fixes and enhancements:
<ul><li>added xmlStopParser() to stop parsing</li>
<li>improved a lot parsing speed when there is large CDATA blocs</li>
<li>includes XPath patches provided by Picdar Technology</li>
- <li>tried to fix as much as possible DTD validation and namespace
- related problems</li>
+ <li>tried to fix as much as possible DTD validation and
+ namespacerelated problems</li>
<li>output to a given encoding has been added/tested</li>
<li>lot of various fixes</li>
</ul></li>
-</ul><h3>2.0.0: Apr 12 2000</h3><ul><li>First public release of libxml2. If you are using libxml, it's a good
- idea to check the 1.x to 2.x upgrade instructions. NOTE: while initially
- scheduled for Apr 3 the release occurred only on Apr 12 due to massive
- workload.</li>
- <li>The include are now located under $prefix/include/libxml (instead of
- $prefix/include/gnome-xml), they also are referenced by
+</ul><h3>2.0.0: Apr 12 2000</h3><ul><li>First public release of libxml2. If you are using libxml, it's a
+ goodidea to check the 1.x to 2.x upgrade instructions. NOTE: while
+ initiallyscheduled for Apr 3 the release occurred only on Apr 12 due to
+ massiveworkload.</li>
+ <li>The include are now located under $prefix/include/libxml (instead
+ of$prefix/include/gnome-xml), they also are referenced by
<pre>#include &lt;libxml/xxx.h&gt;</pre>
<p>instead of</p>
<pre>#include "xxx.h"</pre>
</li>
<li>a new URI module for parsing URIs and following strictly RFC 2396</li>
- <li>the memory allocation routines used by libxml can now be overloaded
- dynamically by using xmlMemSetup()</li>
- <li>The previously CVS only tool tester has been renamed
- <strong>xmllint</strong> and is now installed as part of the libxml2
- package</li>
- <li>The I/O interface has been revamped. There is now ways to plug in
- specific I/O modules, either at the URI scheme detection level using
- xmlRegisterInputCallbacks() or by passing I/O functions when creating a
- parser context using xmlCreateIOParserCtxt()</li>
- <li>there is a C preprocessor macro LIBXML_VERSION providing the version
- number of the libxml module in use</li>
- <li>a number of optional features of libxml can now be excluded at
- configure time (FTP/HTTP/HTML/XPath/Debug)</li>
+ <li>the memory allocation routines used by libxml can now be
+ overloadeddynamically by using xmlMemSetup()</li>
+ <li>The previously CVS only tool tester has been
+ renamed<strong>xmllint</strong>and is now installed as part of the
+ libxml2package</li>
+ <li>The I/O interface has been revamped. There is now ways to plug
+ inspecific I/O modules, either at the URI scheme detection level
+ usingxmlRegisterInputCallbacks() or by passing I/O functions when
+ creating aparser context using xmlCreateIOParserCtxt()</li>
+ <li>there is a C preprocessor macro LIBXML_VERSION providing the
+ versionnumber of the libxml module in use</li>
+ <li>a number of optional features of libxml can now be excluded atconfigure
+ time (FTP/HTTP/HTML/XPath/Debug)</li>
</ul><h3>2.0.0beta: Mar 14 2000</h3><ul><li>This is a first Beta release of libxml version 2</li>
- <li>It's available only from<a href="ftp://xmlsoft.org/libxml2/">xmlsoft.org
- FTP</a>, it's packaged as libxml2-2.0.0beta and available as tar and
- RPMs</li>
- <li>This version is now the head in the Gnome CVS base, the old one is
- available under the tag LIB_XML_1_X</li>
- <li>This includes a very large set of changes. From a programmatic point
- of view applications should not have to be modified too much, check the
- <a href="upgrade.html">upgrade page</a></li>
+ <li>It's available only from<a href="ftp://xmlsoft.org/libxml2/">xmlsoft.orgFTP</a>, it's packaged as
+ libxml2-2.0.0beta and available as tar andRPMs</li>
+ <li>This version is now the head in the Gnome CVS base, the old one
+ isavailable under the tag LIB_XML_1_X</li>
+ <li>This includes a very large set of changes. From a programmatic pointof
+ view applications should not have to be modified too much, check the<a href="upgrade.html">upgrade page</a></li>
<li>Some interfaces may changes (especially a bit about encoding).</li>
<li>the updates includes:
- <ul><li>fix I18N support. ISO-Latin-x/UTF-8/UTF-16 (nearly) seems correctly
- handled now</li>
- <li>Better handling of entities, especially well-formedness checking
- and proper PEref extensions in external subsets</li>
+ <ul><li>fix I18N support. ISO-Latin-x/UTF-8/UTF-16 (nearly) seems
+ correctlyhandled now</li>
+ <li>Better handling of entities, especially well-formedness checkingand
+ proper PEref extensions in external subsets</li>
<li>DTD conditional sections</li>
<li>Validation now correctly handle entities content</li>
- <li><a href="http://rpmfind.net/tools/gdome/messages/0039.html">change
- structures to accommodate DOM</a></li>
+ <li><a href="http://rpmfind.net/tools/gdome/messages/0039.html">changestructures
+ to accommodate DOM</a></li>
</ul></li>
- <li>Serious progress were made toward compliance, <a href="conf/result.html">here are the result of the test</a> against the
- OASIS testsuite (except the Japanese tests since I don't support that
- encoding yet). This URL is rebuilt every couple of hours using the CVS
- head version.</li>
+ <li>Serious progress were made toward compliance, <a href="conf/result.html">here are the result of the test</a>against
+ theOASIS testsuite (except the Japanese tests since I don't support
+ thatencoding yet). This URL is rebuilt every couple of hours using the
+ CVShead version.</li>
</ul><h3>1.8.7: Mar 6 2000</h3><ul><li>This is a bug fix release:</li>
- <li>It is possible to disable the ignorable blanks heuristic used by
- libxml-1.x, a new function xmlKeepBlanksDefault(0) will allow this. Note
- that for adherence to XML spec, this behaviour will be disabled by
- default in 2.x . The same function will allow to keep compatibility for
- old code.</li>
- <li>Blanks in &lt;a&gt; &lt;/a&gt; constructs are not ignored anymore,
- avoiding heuristic is really the Right Way :-\</li>
- <li>The unchecked use of snprintf which was breaking libxml-1.8.6
- compilation on some platforms has been fixed</li>
- <li>nanoftp.c nanohttp.c: Fixed '#' and '?' stripping when processing
- URIs</li>
-</ul><h3>1.8.6: Jan 31 2000</h3><ul><li>added a nanoFTP transport module, debugged until the new version of <a href="http://rpmfind.net/linux/rpm2html/rpmfind.html">rpmfind</a> can use
- it without troubles</li>
-</ul><h3>1.8.5: Jan 21 2000</h3><ul><li>adding APIs to parse a well balanced chunk of XML (production <a href="http://www.w3.org/TR/REC-xml#NT-content">[43] content</a> of the
- XML spec)</li>
+ <li>It is possible to disable the ignorable blanks heuristic used
+ bylibxml-1.x, a new function xmlKeepBlanksDefault(0) will allow this.
+ Notethat for adherence to XML spec, this behaviour will be disabled
+ bydefault in 2.x . The same function will allow to keep compatibility
+ forold code.</li>
+ <li>Blanks in &lt;a&gt; &lt;/a&gt; constructs are not ignored
+ anymore,avoiding heuristic is really the Right Way :-\</li>
+ <li>The unchecked use of snprintf which was breaking
+ libxml-1.8.6compilation on some platforms has been fixed</li>
+ <li>nanoftp.c nanohttp.c: Fixed '#' and '?' stripping when
+ processingURIs</li>
+</ul><h3>1.8.6: Jan 31 2000</h3><ul><li>added a nanoFTP transport module, debugged until the new version of <a href="http://rpmfind.net/linux/rpm2html/rpmfind.html">rpmfind</a>can
+ useit without troubles</li>
+</ul><h3>1.8.5: Jan 21 2000</h3><ul><li>adding APIs to parse a well balanced chunk of XML (production <a href="http://www.w3.org/TR/REC-xml#NT-content">[43] content</a>of theXML
+ spec)</li>
<li>fixed a hideous bug in xmlGetProp pointed by Rune.Djurhuus@fast.no</li>
- <li>Jody Goldberg &lt;jgoldberg@home.com&gt; provided another patch trying
- to solve the zlib checks problems</li>
- <li>The current state in gnome CVS base is expected to ship as 1.8.5 with
- gnumeric soon</li>
+ <li>Jody Goldberg &lt;jgoldberg@home.com&gt; provided another patch
+ tryingto solve the zlib checks problems</li>
+ <li>The current state in gnome CVS base is expected to ship as 1.8.5
+ withgnumeric soon</li>
</ul><h3>1.8.4: Jan 13 2000</h3><ul><li>bug fixes, reintroduced xmlNewGlobalNs(), fixed xmlNewNs()</li>
<li>all exit() call should have been removed from libxml</li>
<li>fixed a problem with INCLUDE_WINSOCK on WIN32 platform</li>
@@ -1191,52 +1202,52 @@ it's actually not compiled in by default. The real fixes are:</p><ul><li>a coupl
<li>fixed the DTD parsing code to work with the xhtml DTD</li>
<li>added xmlRemoveProp(), xmlRemoveID() and xmlRemoveRef()</li>
<li>Fixed bugs in xmlNewNs()</li>
- <li>External entity loading code has been revamped, now it uses
- xmlLoadExternalEntity(), some fix on entities processing were added</li>
+ <li>External entity loading code has been revamped, now it
+ usesxmlLoadExternalEntity(), some fix on entities processing were
+ added</li>
<li>cleaned up WIN32 includes of socket stuff</li>
-</ul><h3>1.8.2: Dec 21 1999</h3><ul><li>I got another problem with includes and C++, I hope this issue is fixed
- for good this time</li>
- <li>Added a few tree modification functions: xmlReplaceNode,
- xmlAddPrevSibling, xmlAddNextSibling, xmlNodeSetName and
- xmlDocSetRootElement</li>
+</ul><h3>1.8.2: Dec 21 1999</h3><ul><li>I got another problem with includes and C++, I hope this issue is
+ fixedfor good this time</li>
+ <li>Added a few tree modification functions:
+ xmlReplaceNode,xmlAddPrevSibling, xmlAddNextSibling, xmlNodeSetName
+ andxmlDocSetRootElement</li>
<li>Tried to improve the HTML output with help from <a href="mailto:clahey@umich.edu">Chris Lahey</a></li>
-</ul><h3>1.8.1: Dec 18 1999</h3><ul><li>various patches to avoid troubles when using libxml with C++ compilers
- the "namespace" keyword and C escaping in include files</li>
+</ul><h3>1.8.1: Dec 18 1999</h3><ul><li>various patches to avoid troubles when using libxml with C++
+ compilersthe "namespace" keyword and C escaping in include files</li>
<li>a problem in one of the core macros IS_CHAR was corrected</li>
- <li>fixed a bug introduced in 1.8.0 breaking default namespace processing,
- and more specifically the Dia application</li>
- <li>fixed a posteriori validation (validation after parsing, or by using a
- Dtd not specified in the original document)</li>
+ <li>fixed a bug introduced in 1.8.0 breaking default namespace
+ processing,and more specifically the Dia application</li>
+ <li>fixed a posteriori validation (validation after parsing, or by using
+ aDtd not specified in the original document)</li>
<li>fixed a bug in</li>
</ul><h3>1.8.0: Dec 12 1999</h3><ul><li>cleanup, especially memory wise</li>
- <li>the parser should be more reliable, especially the HTML one, it should
- not crash, whatever the input !</li>
- <li>Integrated various patches, especially a speedup improvement for large
- dataset from <a href="mailto:cnygard@bellatlantic.net">Carl Nygard</a>,
- configure with --with-buffers to enable them.</li>
+ <li>the parser should be more reliable, especially the HTML one, it
+ shouldnot crash, whatever the input !</li>
+ <li>Integrated various patches, especially a speedup improvement for
+ largedataset from <a href="mailto:cnygard@bellatlantic.net">Carl
+ Nygard</a>,configure with --with-buffers to enable them.</li>
<li>attribute normalization, oops should have been added long ago !</li>
- <li>attributes defaulted from DTDs should be available, xmlSetProp() now
- does entities escaping by default.</li>
+ <li>attributes defaulted from DTDs should be available, xmlSetProp()
+ nowdoes entities escaping by default.</li>
</ul><h3>1.7.4: Oct 25 1999</h3><ul><li>Lots of HTML improvement</li>
<li>Fixed some errors when saving both XML and HTML</li>
<li>More examples, the regression tests should now look clean</li>
<li>Fixed a bug with contiguous charref</li>
</ul><h3>1.7.3: Sep 29 1999</h3><ul><li>portability problems fixed</li>
- <li>snprintf was used unconditionally, leading to link problems on system
- were it's not available, fixed</li>
-</ul><h3>1.7.1: Sep 24 1999</h3><ul><li>The basic type for strings manipulated by libxml has been renamed in
- 1.7.1 from <strong>CHAR</strong> to <strong>xmlChar</strong>. The reason
- is that CHAR was conflicting with a predefined type on Windows. However
- on non WIN32 environment, compatibility is provided by the way of a
- <strong>#define </strong>.</li>
- <li>Changed another error : the use of a structure field called errno, and
- leading to troubles on platforms where it's a macro</li>
-</ul><h3>1.7.0: Sep 23 1999</h3><ul><li>Added the ability to fetch remote DTD or parsed entities, see the <a href="html/libxml-nanohttp.html">nanohttp</a> module.</li>
- <li>Added an errno to report errors by another mean than a simple printf
- like callback</li>
+ <li>snprintf was used unconditionally, leading to link problems on
+ systemwere it's not available, fixed</li>
+</ul><h3>1.7.1: Sep 24 1999</h3><ul><li>The basic type for strings manipulated by libxml has been renamed
+ in1.7.1 from <strong>CHAR</strong>to <strong>xmlChar</strong>. The
+ reasonis that CHAR was conflicting with a predefined type on Windows.
+ Howeveron non WIN32 environment, compatibility is provided by the way of
+ a<strong>#define </strong>.</li>
+ <li>Changed another error : the use of a structure field called errno,
+ andleading to troubles on platforms where it's a macro</li>
+</ul><h3>1.7.0: Sep 23 1999</h3><ul><li>Added the ability to fetch remote DTD or parsed entities, see the <a href="html/libxml-nanohttp.html">nanohttp</a>module.</li>
+ <li>Added an errno to report errors by another mean than a simple
+ printflike callback</li>
<li>Finished ID/IDREF support and checking when validation</li>
- <li>Serious memory leaks fixed (there is now a <a href="html/libxml-xmlmemory.html">memory wrapper</a> module)</li>
- <li>Improvement of <a href="http://www.w3.org/TR/xpath">XPath</a>
- implementation</li>
+ <li>Serious memory leaks fixed (there is now a <a href="html/libxml-xmlmemory.html">memory wrapper</a>module)</li>
+ <li>Improvement of <a href="http://www.w3.org/TR/xpath">XPath</a>implementation</li>
<li>Added an HTML parser front-end</li>
</ul><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/python.html b/doc/python.html
index 5910766f..7d451c57 100644
--- a/doc/python.html
+++ b/doc/python.html
@@ -7,73 +7,69 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Python and bindings</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Python and bindings</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>There are a number of language bindings and wrappers available for
-libxml2, the list below is not exhaustive. Please contact the <a href="http://mail.gnome.org/mailman/listinfo/xml-bindings">xml-bindings@gnome.org</a>
-(<a href="http://mail.gnome.org/archives/xml-bindings/">archives</a>) in
-order to get updates to this list or to discuss the specific topic of libxml2
-or libxslt wrappers or bindings:</p><ul><li><a href="http://libxmlplusplus.sourceforge.net/">Libxml++</a> seems the
- most up-to-date C++ bindings for libxml2, check the <a href="http://libxmlplusplus.sourceforge.net/reference/html/hierarchy.html">documentation</a>
- and the <a href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/libxmlplusplus/libxml%2b%2b/examples/">examples</a>.</li>
- <li>There is another <a href="http://libgdome-cpp.berlios.de/">C++ wrapper
- based on the gdome2 bindings</a> maintained by Tobias Peters.</li>
+</style><title>Python and bindings</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Python and bindings</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>There are a number of language bindings and wrappers available forlibxml2,
+the list below is not exhaustive. Please contact the <a href="http://mail.gnome.org/mailman/listinfo/xml-bindings">xml-bindings@gnome.org</a>(<a href="http://mail.gnome.org/archives/xml-bindings/">archives</a>) inorder to
+get updates to this list or to discuss the specific topic of libxml2or
+libxslt wrappers or bindings:</p><ul><li><a href="http://libxmlplusplus.sourceforge.net/">Libxml++</a>seems
+ themost up-to-date C++ bindings for libxml2, check the <a href="http://libxmlplusplus.sourceforge.net/reference/html/hierarchy.html">documentation</a>and
+ the <a href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/libxmlplusplus/libxml%2b%2b/examples/">examples</a>.</li>
+ <li>There is another <a href="http://libgdome-cpp.berlios.de/">C++
+ wrapperbased on the gdome2 bindings</a>maintained by Tobias Peters.</li>
<li>and a third C++ wrapper by Peter Jones &lt;pjones@pmade.org&gt;
<p>Website: <a href="http://pmade.org/pjones/software/xmlwrapp/">http://pmade.org/pjones/software/xmlwrapp/</a></p>
</li>
- <li><a href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">Matt
- Sergeant</a> developed <a href="http://axkit.org/download/">XML::LibXSLT</a>, a Perl wrapper for
- libxml2/libxslt as part of the <a href="http://axkit.com/">AxKit XML
- application server</a>.</li>
- <li>If you're interested into scripting XML processing, have a look at <a href="http://xsh.sourceforge.net/">XSH</a> an XML editing shell based on
- Libxml2 Perl bindings.</li>
- <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a> provides an
- earlier version of the libxml/libxslt <a href="http://www.rexx.com/~dkuhlman">wrappers for Python</a>.</li>
- <li>Gopal.V and Peter Minten develop <a href="http://savannah.gnu.org/projects/libxmlsharp">libxml#</a>, a set of
- C# libxml2 bindings.</li>
- <li>Petr Kozelka provides <a href="http://sourceforge.net/projects/libxml2-pas">Pascal units to glue
- libxml2</a> with Kylix, Delphi and other Pascal compilers.</li>
- <li>Uwe Fechner also provides <a href="http://sourceforge.net/projects/idom2-pas/">idom2</a>, a DOM2
- implementation for Kylix2/D5/D6 from Borland.</li>
- <li>There is <a href="http://libxml.rubyforge.org/">bindings for Ruby</a>
- and libxml2 bindings are also available in Ruby through the <a href="http://libgdome-ruby.berlios.de/">libgdome-ruby</a> module
- maintained by Tobias Peters.</li>
- <li>Steve Ball and contributors maintains <a href="http://tclxml.sourceforge.net/">libxml2 and libxslt bindings for
- Tcl</a>.</li>
+ <li><a href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">MattSergeant</a>developed
+ <a href="http://axkit.org/download/">XML::LibXSLT</a>, a Perl wrapper
+ forlibxml2/libxslt as part of the <a href="http://axkit.com/">AxKit
+ XMLapplication server</a>.</li>
+ <li>If you're interested into scripting XML processing, have a look at <a href="http://xsh.sourceforge.net/">XSH</a>an XML editing shell based
+ onLibxml2 Perl bindings.</li>
+ <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a>provides
+ anearlier version of the libxml/libxslt <a href="http://www.rexx.com/~dkuhlman">wrappers for Python</a>.</li>
+ <li>Gopal.V and Peter Minten develop <a href="http://savannah.gnu.org/projects/libxmlsharp">libxml#</a>, a set
+ ofC# libxml2 bindings.</li>
+ <li>Petr Kozelka provides <a href="http://sourceforge.net/projects/libxml2-pas">Pascal units to
+ gluelibxml2</a>with Kylix, Delphi and other Pascal compilers.</li>
+ <li>Uwe Fechner also provides <a href="http://sourceforge.net/projects/idom2-pas/">idom2</a>, a
+ DOM2implementation for Kylix2/D5/D6 from Borland.</li>
+ <li>There is <a href="http://libxml.rubyforge.org/">bindings for
+ Ruby</a>and libxml2 bindings are also available in Ruby through the <a href="http://libgdome-ruby.berlios.de/">libgdome-ruby</a>modulemaintained
+ by Tobias Peters.</li>
+ <li>Steve Ball and contributors maintains <a href="http://tclxml.sourceforge.net/">libxml2 and libxslt bindings
+ forTcl</a>.</li>
<li>libxml2 and libxslt is the default XML library for PHP5.</li>
- <li><a href="http://savannah.gnu.org/projects/classpathx/">LibxmlJ</a> is
- an effort to create a 100% JAXP-compatible Java wrapper for libxml2 and
- libxslt as part of GNU ClasspathX project.</li>
- <li>Patrick McPhee provides Rexx bindings fof libxml2 and libxslt, look for
- <a href="http://www.interlog.com/~ptjm/software.html">RexxXML</a>.</li>
- <li><a href="http://www.satimage.fr/software/en/xml_suite.html">Satimage</a>
- provides <a href="http://www.satimage.fr/software/en/downloads_osaxen.html">XMLLib
- osax</a>. This is an osax for Mac OS X with a set of commands to
- implement in AppleScript the XML DOM, XPATH and XSLT. Also includes
- commands for Property-lists (Apple's fast lookup table XML format.)</li>
- <li>Francesco Montorsi developped <a href="https://sourceforge.net/project/showfiles.php?group_id=51305&amp;package_id=45182">wxXml2</a>
- wrappers that interface libxml2, allowing wxWidgets applications to
- load/save/edit XML instances.</li>
-</ul><p>The distribution includes a set of Python bindings, which are guaranteed
-to be maintained as part of the library in the future, though the Python
-interface have not yet reached the completeness of the C API.</p><p>Note that some of the Python purist dislike the default set of Python
-bindings, rather than complaining I suggest they have a look at <a href="http://codespeak.net/lxml/">lxml the more pythonic bindings for libxml2
-and libxslt</a> and <a href="http://codespeak.net/mailman/listinfo/lxml-dev">help Martijn
-Faassen</a> complete those.</p><p><a href="mailto:stephane.bidoul@softwareag.com">Stéphane Bidoul</a>
-maintains <a href="http://users.skynet.be/sbi/libxml-python/">a Windows port
-of the Python bindings</a>.</p><p>Note to people interested in building bindings, the API is formalized as
-<a href="libxml2-api.xml">an XML API description file</a> which allows to
-automate a large part of the Python bindings, this includes function
-descriptions, enums, structures, typedefs, etc... The Python script used to
-build the bindings is python/generator.py in the source distribution.</p><p>To install the Python bindings there are 2 options:</p><ul><li>If you use an RPM based distribution, simply install the <a href="http://rpmfind.net/linux/rpm2html/search.php?query=libxml2-python">libxml2-python
- RPM</a> (and if needed the <a href="http://rpmfind.net/linux/rpm2html/search.php?query=libxslt-python">libxslt-python
- RPM</a>).</li>
- <li>Otherwise use the <a href="ftp://xmlsoft.org/libxml2/python/">libxml2-python
- module distribution</a> corresponding to your installed version of
- libxml2 and libxslt. Note that to install it you will need both libxml2
- and libxslt installed and run "python setup.py build install" in the
- module tree.</li>
-</ul><p>The distribution includes a set of examples and regression tests for the
-python bindings in the <code>python/tests</code> directory. Here are some
-excerpts from those tests:</p><h3>tst.py:</h3><p>This is a basic test of the file interface and DOM navigation:</p><pre>import libxml2, sys
+ <li><a href="http://savannah.gnu.org/projects/classpathx/">LibxmlJ</a>isan
+ effort to create a 100% JAXP-compatible Java wrapper for libxml2
+ andlibxslt as part of GNU ClasspathX project.</li>
+ <li>Patrick McPhee provides Rexx bindings fof libxml2 and libxslt, look
+ for<a href="http://www.interlog.com/~ptjm/software.html">RexxXML</a>.</li>
+ <li><a href="http://www.satimage.fr/software/en/xml_suite.html">Satimage</a>provides
+ <a href="http://www.satimage.fr/software/en/downloads_osaxen.html">XMLLibosax</a>.
+ This is an osax for Mac OS X with a set of commands toimplement in
+ AppleScript the XML DOM, XPATH and XSLT. Also includescommands for
+ Property-lists (Apple's fast lookup table XML format.)</li>
+ <li>Francesco Montorsi developped <a href="https://sourceforge.net/project/showfiles.php?group_id=51305&amp;package_id=45182">wxXml2</a>wrappers
+ that interface libxml2, allowing wxWidgets applications toload/save/edit
+ XML instances.</li>
+</ul><p>The distribution includes a set of Python bindings, which are guaranteedto
+be maintained as part of the library in the future, though the
+Pythoninterface have not yet reached the completeness of the C API.</p><p>Note that some of the Python purist dislike the default set of
+Pythonbindings, rather than complaining I suggest they have a look at <a href="http://codespeak.net/lxml/">lxml the more pythonic bindings for
+libxml2and libxslt</a>and <a href="http://codespeak.net/mailman/listinfo/lxml-dev">help
+MartijnFaassen</a>complete those.</p><p><a href="mailto:stephane.bidoul@softwareag.com">Stéphane
+Bidoul</a>maintains <a href="http://users.skynet.be/sbi/libxml-python/">a
+Windows portof the Python bindings</a>.</p><p>Note to people interested in building bindings, the API is formalized as<a href="libxml2-api.xml">an XML API description file</a>which allows toautomate
+a large part of the Python bindings, this includes functiondescriptions,
+enums, structures, typedefs, etc... The Python script used tobuild the
+bindings is python/generator.py in the source distribution.</p><p>To install the Python bindings there are 2 options:</p><ul><li>If you use an RPM based distribution, simply install the <a href="http://rpmfind.net/linux/rpm2html/search.php?query=libxml2-python">libxml2-pythonRPM</a>(and
+ if needed the <a href="http://rpmfind.net/linux/rpm2html/search.php?query=libxslt-python">libxslt-pythonRPM</a>).</li>
+ <li>Otherwise use the <a href="ftp://xmlsoft.org/libxml2/python/">libxml2-pythonmodule
+ distribution</a>corresponding to your installed version oflibxml2 and
+ libxslt. Note that to install it you will need both libxml2and libxslt
+ installed and run "python setup.py build install" in themodule tree.</li>
+</ul><p>The distribution includes a set of examples and regression tests for
+thepython bindings in the <code>python/tests</code>directory. Here are
+someexcerpts from those tests:</p><h3>tst.py:</h3><p>This is a basic test of the file interface and DOM navigation:</p><pre>import libxml2, sys
doc = libxml2.parseFile("tst.xml")
if doc.name != "tst.xml":
@@ -87,24 +83,25 @@ child = root.children
if child.name != "foo":
print "child.name failed"
sys.exit(1)
-doc.freeDoc()</pre><p>The Python module is called libxml2; parseFile is the equivalent of
-xmlParseFile (most of the bindings are automatically generated, and the xml
-prefix is removed and the casing convention are kept). All node seen at the
-binding level share the same subset of accessors:</p><ul><li><code>name</code> : returns the node name</li>
- <li><code>type</code> : returns a string indicating the node type</li>
- <li><code>content</code> : returns the content of the node, it is based on
- xmlNodeGetContent() and hence is recursive.</li>
- <li><code>parent</code> , <code>children</code>, <code>last</code>,
- <code>next</code>, <code>prev</code>, <code>doc</code>,
- <code>properties</code>: pointing to the associated element in the tree,
- those may return None in case no such link exists.</li>
-</ul><p>Also note the need to explicitly deallocate documents with freeDoc() .
-Reference counting for libxml2 trees would need quite a lot of work to
-function properly, and rather than risk memory leaks if not implemented
-correctly it sounds safer to have an explicit function to free a tree. The
-wrapper python objects like doc, root or child are them automatically garbage
-collected.</p><h3>validate.py:</h3><p>This test check the validation interfaces and redirection of error
-messages:</p><pre>import libxml2
+doc.freeDoc()</pre><p>The Python module is called libxml2; parseFile is the equivalent
+ofxmlParseFile (most of the bindings are automatically generated, and the
+xmlprefix is removed and the casing convention are kept). All node seen at
+thebinding level share the same subset of accessors:</p><ul><li><code>name</code>: returns the node name</li>
+ <li><code>type</code>: returns a string indicating the node type</li>
+ <li><code>content</code>: returns the content of the node, it is based
+ onxmlNodeGetContent() and hence is recursive.</li>
+ <li><code>parent</code>, <code>children</code>,
+ <code>last</code>,<code>next</code>, <code>prev</code>,
+ <code>doc</code>,<code>properties</code>: pointing to the associated
+ element in the tree,those may return None in case no such link
+ exists.</li>
+</ul><p>Also note the need to explicitly deallocate documents with freeDoc()
+.Reference counting for libxml2 trees would need quite a lot of work
+tofunction properly, and rather than risk memory leaks if not
+implementedcorrectly it sounds safer to have an explicit function to free a
+tree. Thewrapper python objects like doc, root or child are them
+automatically garbagecollected.</p><h3>validate.py:</h3><p>This test check the validation interfaces and redirection of
+errormessages:</p><pre>import libxml2
#deactivate error messages from the validation
def noerr(ctx, str):
@@ -119,27 +116,28 @@ doc = ctxt.doc()
valid = ctxt.isValid()
doc.freeDoc()
if valid != 0:
- print "validity check failed"</pre><p>The first thing to notice is the call to registerErrorHandler(), it
-defines a new error handler global to the library. It is used to avoid seeing
-the error messages when trying to validate the invalid document.</p><p>The main interest of that test is the creation of a parser context with
-createFileParserCtxt() and how the behaviour can be changed before calling
-parseDocument() . Similarly the informations resulting from the parsing phase
-are also available using context methods.</p><p>Contexts like nodes are defined as class and the libxml2 wrappers maps the
-C function interfaces in terms of objects method as much as possible. The
-best to get a complete view of what methods are supported is to look at the
-libxml2.py module containing all the wrappers.</p><h3>push.py:</h3><p>This test show how to activate the push parser interface:</p><pre>import libxml2
+ print "validity check failed"</pre><p>The first thing to notice is the call to registerErrorHandler(), itdefines
+a new error handler global to the library. It is used to avoid seeingthe
+error messages when trying to validate the invalid document.</p><p>The main interest of that test is the creation of a parser context
+withcreateFileParserCtxt() and how the behaviour can be changed before
+callingparseDocument() . Similarly the informations resulting from the
+parsing phaseare also available using context methods.</p><p>Contexts like nodes are defined as class and the libxml2 wrappers maps
+theC function interfaces in terms of objects method as much as possible.
+Thebest to get a complete view of what methods are supported is to look at
+thelibxml2.py module containing all the wrappers.</p><h3>push.py:</h3><p>This test show how to activate the push parser interface:</p><pre>import libxml2
ctxt = libxml2.createPushParser(None, "&lt;foo", 4, "test.xml")
ctxt.parseChunk("/&gt;", 2, 1)
doc = ctxt.doc()
-doc.freeDoc()</pre><p>The context is created with a special call based on the
-xmlCreatePushParser() from the C library. The first argument is an optional
-SAX callback object, then the initial set of data, the length and the name of
-the resource in case URI-References need to be computed by the parser.</p><p>Then the data are pushed using the parseChunk() method, the last call
-setting the third argument terminate to 1.</p><h3>pushSAX.py:</h3><p>this test show the use of the event based parsing interfaces. In this case
-the parser does not build a document, but provides callback information as
-the parser makes progresses analyzing the data being provided:</p><pre>import libxml2
+doc.freeDoc()</pre><p>The context is created with a special call based on
+thexmlCreatePushParser() from the C library. The first argument is an
+optionalSAX callback object, then the initial set of data, the length and the
+name ofthe resource in case URI-References need to be computed by the
+parser.</p><p>Then the data are pushed using the parseChunk() method, the last
+callsetting the third argument terminate to 1.</p><h3>pushSAX.py:</h3><p>this test show the use of the event based parsing interfaces. In this
+casethe parser does not build a document, but provides callback information
+asthe parser makes progresses analyzing the data being provided:</p><pre>import libxml2
log = ""
class callback:
@@ -187,15 +185,15 @@ reference = "startDocument:startElement foo {'url': 'tst'}:" + \
"characters: bar:endElement foo:endDocument:"
if log != reference:
print "Error got: %s" % log
- print "Expected: %s" % reference</pre><p>The key object in that test is the handler, it provides a number of entry
-points which can be called by the parser as it makes progresses to indicate
-the information set obtained. The full set of callback is larger than what
-the callback class in that specific example implements (see the SAX
-definition for a complete list). The wrapper will only call those supplied by
-the object when activated. The startElement receives the names of the element
-and a dictionary containing the attributes carried by this element.</p><p>Also note that the reference string generated from the callback shows a
-single character call even though the string "bar" is passed to the parser
-from 2 different call to parseChunk()</p><h3>xpath.py:</h3><p>This is a basic test of XPath wrappers support</p><pre>import libxml2
+ print "Expected: %s" % reference</pre><p>The key object in that test is the handler, it provides a number of
+entrypoints which can be called by the parser as it makes progresses to
+indicatethe information set obtained. The full set of callback is larger than
+whatthe callback class in that specific example implements (see the
+SAXdefinition for a complete list). The wrapper will only call those supplied
+bythe object when activated. The startElement receives the names of the
+elementand a dictionary containing the attributes carried by this element.</p><p>Also note that the reference string generated from the callback shows
+asingle character call even though the string "bar" is passed to the
+parserfrom 2 different call to parseChunk()</p><h3>xpath.py:</h3><p>This is a basic test of XPath wrappers support</p><pre>import libxml2
doc = libxml2.parseFile("tst.xml")
ctxt = doc.xpathNewContext()
@@ -207,14 +205,15 @@ if res[0].name != "doc" or res[1].name != "foo":
print "xpath query: wrong node set value"
sys.exit(1)
doc.freeDoc()
-ctxt.xpathFreeContext()</pre><p>This test parses a file, then create an XPath context to evaluate XPath
-expression on it. The xpathEval() method execute an XPath query and returns
-the result mapped in a Python way. String and numbers are natively converted,
-and node sets are returned as a tuple of libxml2 Python nodes wrappers. Like
-the document, the XPath context need to be freed explicitly, also not that
-the result of the XPath query may point back to the document tree and hence
-the document must be freed after the result of the query is used.</p><h3>xpathext.py:</h3><p>This test shows how to extend the XPath engine with functions written in
-python:</p><pre>import libxml2
+ctxt.xpathFreeContext()</pre><p>This test parses a file, then create an XPath context to evaluate
+XPathexpression on it. The xpathEval() method execute an XPath query and
+returnsthe result mapped in a Python way. String and numbers are natively
+converted,and node sets are returned as a tuple of libxml2 Python nodes
+wrappers. Likethe document, the XPath context need to be freed explicitly,
+also not thatthe result of the XPath query may point back to the document
+tree and hencethe document must be freed after the result of the query is
+used.</p><h3>xpathext.py:</h3><p>This test shows how to extend the XPath engine with functions written
+inpython:</p><pre>import libxml2
def foo(ctx, x):
return x + 1
@@ -226,9 +225,9 @@ res = ctxt.xpathEval("foo(1)")
if res != 2:
print "xpath extension failure"
doc.freeDoc()
-ctxt.xpathFreeContext()</pre><p>Note how the extension function is registered with the context (but that
-part is not yet finalized, this may change slightly in the future).</p><h3>tstxpath.py:</h3><p>This test is similar to the previous one but shows how the extension
-function can access the XPath evaluation context:</p><pre>def foo(ctx, x):
+ctxt.xpathFreeContext()</pre><p>Note how the extension function is registered with the context (but
+thatpart is not yet finalized, this may change slightly in the future).</p><h3>tstxpath.py:</h3><p>This test is similar to the previous one but shows how the
+extensionfunction can access the XPath evaluation context:</p><pre>def foo(ctx, x):
global called
#
@@ -237,16 +236,16 @@ function can access the XPath evaluation context:</p><pre>def foo(ctx, x):
pctxt = libxml2.xpathParserContext(_obj=ctx)
ctxt = pctxt.context()
called = ctxt.function()
- return x + 1</pre><p>All the interfaces around the XPath parser(or rather evaluation) context
-are not finalized, but it should be sufficient to do contextual work at the
-evaluation point.</p><h3>Memory debugging:</h3><p>last but not least, all tests starts with the following prologue:</p><pre>#memory debug specific
+ return x + 1</pre><p>All the interfaces around the XPath parser(or rather evaluation)
+contextare not finalized, but it should be sufficient to do contextual work
+at theevaluation point.</p><h3>Memory debugging:</h3><p>last but not least, all tests starts with the following prologue:</p><pre>#memory debug specific
libxml2.debugMemory(1)</pre><p>and ends with the following epilogue:</p><pre>#memory debug specific
libxml2.cleanupParser()
if libxml2.debugMemory(1) == 0:
print "OK"
else:
print "Memory leak %d bytes" % (libxml2.debugMemory(1))
- libxml2.dumpMemory()</pre><p>Those activate the memory debugging interface of libxml2 where all
-allocated block in the library are tracked. The prologue then cleans up the
-library state and checks that all allocated memory has been freed. If not it
-calls dumpMemory() which saves that list in a <code>.memdump</code> file.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+ libxml2.dumpMemory()</pre><p>Those activate the memory debugging interface of libxml2 where
+allallocated block in the library are tracked. The prologue then cleans up
+thelibrary state and checks that all allocated memory has been freed. If not
+itcalls dumpMemory() which saves that list in a <code>.memdump</code>file.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/threads.html b/doc/threads.html
index 8082dbd8..09a2b229 100644
--- a/doc/threads.html
+++ b/doc/threads.html
@@ -7,15 +7,17 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Thread safety</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Thread safety</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Starting with 2.4.7, libxml2 makes provisions to ensure that concurrent
-threads can safely work in parallel parsing different documents. There is
-however a couple of things to do to ensure it:</p><ul><li>configure the library accordingly using the --with-threads options</li>
- <li>call xmlInitParser() in the "main" thread before using any of the
- libxml2 API (except possibly selecting a different memory allocator)</li>
-</ul><p>Note that the thread safety cannot be ensured for multiple threads sharing
-the same document, the locking must be done at the application level, libxml
-exports a basic mutex and reentrant mutexes API in &lt;libxml/threads.h&gt;.
-The parts of the library checked for thread safety are:</p><ul><li>concurrent loading</li>
+</style><title>Thread safety</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Thread safety</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Starting with 2.4.7, libxml2 makes provisions to ensure that
+concurrentthreads can safely work in parallel parsing different documents.
+There ishowever a couple of things to do to ensure it:</p><ul><li>configure the library accordingly using the --with-threads options</li>
+ <li>call xmlInitParser() in the "main" thread before using any of
+ thelibxml2 API (except possibly selecting a different memory
+ allocator)</li>
+</ul><p>Note that the thread safety cannot be ensured for multiple threads
+sharingthe same document, the locking must be done at the application level,
+libxmlexports a basic mutex and reentrant mutexes API in
+&lt;libxml/threads.h&gt;.The parts of the library checked for thread safety
+are:</p><ul><li>concurrent loading</li>
<li>file access resolution</li>
<li>catalog access</li>
<li>catalog building</li>
@@ -23,5 +25,5 @@ The parts of the library checked for thread safety are:</p><ul><li>concurrent lo
<li>validation</li>
<li>global variables per-thread override</li>
<li>memory handling</li>
-</ul><p>XPath is supposed to be thread safe now, but this wasn't tested
-seriously.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+</ul><p>XPath is supposed to be thread safe now, but this wasn't
+testedseriously.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/tree.html b/doc/tree.html
index 65566379..8cf4c0f3 100644
--- a/doc/tree.html
+++ b/doc/tree.html
@@ -7,22 +7,23 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>The tree output</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>The tree output</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>The parser returns a tree built during the document analysis. The value
-returned is an <strong>xmlDocPtr</strong> (i.e., a pointer to an
-<strong>xmlDoc</strong> structure). This structure contains information such
-as the file name, the document type, and a <strong>children</strong> pointer
-which is the root of the document (or more exactly the first child under the
-root which is the document). The tree is made of <strong>xmlNode</strong>s,
-chained in double-linked lists of siblings and with a children&lt;-&gt;parent
-relationship. An xmlNode can also carry properties (a chain of xmlAttr
-structures). An attribute may have a value which is a list of TEXT or
-ENTITY_REF nodes.</p><p>Here is an example (erroneous with respect to the XML spec since there
-should be only one ELEMENT under the root):</p><p><img src="structure.gif" alt=" structure.gif " /></p><p>In the source package there is a small program (not installed by default)
-called <strong>xmllint</strong> which parses XML files given as argument and
-prints them back as parsed. This is useful for detecting errors both in XML
-code and in the XML parser itself. It has an option <strong>--debug</strong>
-which prints the actual in-memory structure of the document; here is the
-result with the <a href="#example">example</a> given before:</p><pre>DOCUMENT
+</style><title>The tree output</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>The tree output</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>The parser returns a tree built during the document analysis. The
+valuereturned is an <strong>xmlDocPtr</strong>(i.e., a pointer to
+an<strong>xmlDoc</strong>structure). This structure contains information
+suchas the file name, the document type, and a
+<strong>children</strong>pointerwhich is the root of the document (or more
+exactly the first child under theroot which is the document). The tree is
+made of <strong>xmlNode</strong>s,chained in double-linked lists of siblings
+and with a children&lt;-&gt;parentrelationship. An xmlNode can also carry
+properties (a chain of xmlAttrstructures). An attribute may have a value
+which is a list of TEXT orENTITY_REF nodes.</p><p>Here is an example (erroneous with respect to the XML spec since
+thereshould be only one ELEMENT under the root):</p><p><img src="structure.gif" alt=" structure.gif " /></p><p>In the source package there is a small program (not installed by
+default)called <strong>xmllint</strong>which parses XML files given as
+argument andprints them back as parsed. This is useful for detecting errors
+both in XMLcode and in the XML parser itself. It has an option
+<strong>--debug</strong>which prints the actual in-memory structure of the
+document; here is theresult with the <a href="#example">example</a>given
+before:</p><pre>DOCUMENT
version=1.0
standalone=true
ELEMENT EXAMPLE
diff --git a/doc/upgrade.html b/doc/upgrade.html
index 59815ba0..b44ca96c 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -7,100 +7,102 @@ H1 {font-family: Verdana,Arial,Helvetica}
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>Upgrading 1.x code</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Upgrading 1.x code</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Incompatible changes:</p><p>Version 2 of libxml2 is the first version introducing serious backward
-incompatible changes. The main goals were:</p><ul><li>a general cleanup. A number of mistakes inherited from the very early
- versions couldn't be changed due to compatibility constraints. Example
- the "childs" element in the nodes.</li>
- <li>Uniformization of the various nodes, at least for their header and link
- parts (doc, parent, children, prev, next), the goal is a simpler
- programming model and simplifying the task of the DOM implementors.</li>
- <li>better conformances to the XML specification, for example version 1.x
- had an heuristic to try to detect ignorable white spaces. As a result the
- SAX event generated were ignorableWhitespace() while the spec requires
- character() in that case. This also mean that a number of DOM node
- containing blank text may populate the DOM tree which were not present
- before.</li>
-</ul><h3>How to fix libxml-1.x code:</h3><p>So client code of libxml designed to run with version 1.x may have to be
-changed to compile against version 2.x of libxml. Here is a list of changes
-that I have collected, they may not be sufficient, so in case you find other
-change which are required, <a href="mailto:Daniel.Veillard@w3.org">drop me a
-mail</a>:</p><ol><li>The package name have changed from libxml to libxml2, the library name
- is now -lxml2 . There is a new xml2-config script which should be used to
- select the right parameters libxml2</li>
- <li>Node <strong>childs</strong> field has been renamed
- <strong>children</strong> so s/childs/children/g should be applied
- (probability of having "childs" anywhere else is close to 0+</li>
- <li>The document don't have anymore a <strong>root</strong> element it has
- been replaced by <strong>children</strong> and usually you will get a
- list of element here. For example a Dtd element for the internal subset
- and it's declaration may be found in that list, as well as processing
- instructions or comments found before or after the document root element.
- Use <strong>xmlDocGetRootElement(doc)</strong> to get the root element of
- a document. Alternatively if you are sure to not reference DTDs nor have
- PIs or comments before or after the root element
- s/-&gt;root/-&gt;children/g will probably do it.</li>
- <li>The white space issue, this one is more complex, unless special case of
- validating parsing, the line breaks and spaces usually used for indenting
- and formatting the document content becomes significant. So they are
- reported by SAX and if your using the DOM tree, corresponding nodes are
- generated. Too approach can be taken:
- <ol><li>lazy one, use the compatibility call
- <strong>xmlKeepBlanksDefault(0)</strong> but be aware that you are
- relying on a special (and possibly broken) set of heuristics of
- libxml to detect ignorable blanks. Don't complain if it breaks or
- make your application not 100% clean w.r.t. to it's input.</li>
- <li>the Right Way: change you code to accept possibly insignificant
- blanks characters, or have your tree populated with weird blank text
- nodes. You can spot them using the commodity function
- <strong>xmlIsBlankNode(node)</strong> returning 1 for such blank
- nodes.</li>
- </ol><p>Note also that with the new default the output functions don't add any
- extra indentation when saving a tree in order to be able to round trip
- (read and save) without inflating the document with extra formatting
- chars.</p>
+</style><title>Upgrading 1.x code</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://swpat.ffii.org/"><img src="epatents.png" alt="Action against software patents" /></a></td><td width="180"><a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo" /></a><a href="http://www.w3.org/Status"><img src="w3c.png" alt="W3C Logo" /></a><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a><div align="left"><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" /></a></div></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>The XML C parser and toolkit of Gnome</h1><h2>Upgrading 1.x code</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Developer Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html" style="font-weight:bold">Main Menu</a></li><li><a href="html/index.html" style="font-weight:bold">Reference Manual</a></li><li><a href="examples/index.html" style="font-weight:bold">Code Examples</a></li><li><a href="guidelines.html">XML Guidelines</a></li><li><a href="tutorial/index.html">Tutorial</a></li><li><a href="xmlreader.html">The Reader Interface</a></li><li><a href="ChangeLog.html">ChangeLog</a></li><li><a href="XSLT.html">XSLT</a></li><li><a href="python.html">Python and bindings</a></li><li><a href="architecture.html">libxml2 architecture</a></li><li><a href="tree.html">The tree output</a></li><li><a href="interface.html">The SAX interface</a></li><li><a href="xmlmem.html">Memory Management</a></li><li><a href="xmlio.html">I/O Interfaces</a></li><li><a href="library.html">The parser interfaces</a></li><li><a href="entities.html">Entities or no entities</a></li><li><a href="namespaces.html">Namespaces</a></li><li><a href="upgrade.html">Upgrading 1.x code</a></li><li><a href="threads.html">Thread safety</a></li><li><a href="DOM.html">DOM Principles</a></li><li><a href="example.html">A real example</a></li><li><a href="xml.html">flat page</a>, <a href="site.xsl">stylesheet</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="APIchunk0.html">Alphabetic</a></li><li><a href="APIconstructors.html">Constructors</a></li><li><a href="APIfunctions.html">Functions/Types</a></li><li><a href="APIfiles.html">Modules</a></li><li><a href="APIsymbols.html">Symbols</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="http://mail.gnome.org/archives/xml/">Mail archive</a></li><li><a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a></li><li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li><li><a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a></li><li><a href="ftp://xmlsoft.org/">FTP</a></li><li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li><li><a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a></li><li><a href="http://www.explain.com.au/oss/libxml2xslt.html">MacOsX binaries</a></li><li><a href="http://libxmlplusplus.sourceforge.net/">C++ bindings</a></li><li><a href="http://www.zend.com/php5/articles/php5-xmlphp.php#Heading4">PHP bindings</a></li><li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li><li><a href="http://libxml.rubyforge.org/">Ruby bindings</a></li><li><a href="http://tclxml.sourceforge.net/">Tcl bindings</a></li><li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a></li></ul></td></tr></table></td></tr></table></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>Incompatible changes:</p><p>Version 2 of libxml2 is the first version introducing serious
+backwardincompatible changes. The main goals were:</p><ul><li>a general cleanup. A number of mistakes inherited from the very
+ earlyversions couldn't be changed due to compatibility constraints.
+ Examplethe "childs" element in the nodes.</li>
+ <li>Uniformization of the various nodes, at least for their header and
+ linkparts (doc, parent, children, prev, next), the goal is a
+ simplerprogramming model and simplifying the task of the DOM
+ implementors.</li>
+ <li>better conformances to the XML specification, for example version
+ 1.xhad an heuristic to try to detect ignorable white spaces. As a result
+ theSAX event generated were ignorableWhitespace() while the spec
+ requirescharacter() in that case. This also mean that a number of DOM
+ nodecontaining blank text may populate the DOM tree which were not
+ presentbefore.</li>
+</ul><h3>How to fix libxml-1.x code:</h3><p>So client code of libxml designed to run with version 1.x may have to
+bechanged to compile against version 2.x of libxml. Here is a list of
+changesthat I have collected, they may not be sufficient, so in case you find
+otherchange which are required, <a href="mailto:Daniel.Veillard@w3.org">drop
+me amail</a>:</p><ol><li>The package name have changed from libxml to libxml2, the library
+ nameis now -lxml2 . There is a new xml2-config script which should be
+ used toselect the right parameters libxml2</li>
+ <li>Node <strong>childs</strong>field has been
+ renamed<strong>children</strong>so s/childs/children/g should be
+ applied(probability of having "childs" anywhere else is close to 0+</li>
+ <li>The document don't have anymore a <strong>root</strong>element it
+ hasbeen replaced by <strong>children</strong>and usually you will get
+ alist of element here. For example a Dtd element for the internal
+ subsetand it's declaration may be found in that list, as well as
+ processinginstructions or comments found before or after the document
+ root element.Use <strong>xmlDocGetRootElement(doc)</strong>to get the
+ root element ofa document. Alternatively if you are sure to not reference
+ DTDs nor havePIs or comments before or after the root
+ elements/-&gt;root/-&gt;children/g will probably do it.</li>
+ <li>The white space issue, this one is more complex, unless special case
+ ofvalidating parsing, the line breaks and spaces usually used for
+ indentingand formatting the document content becomes significant. So they
+ arereported by SAX and if your using the DOM tree, corresponding nodes
+ aregenerated. Too approach can be taken:
+ <ol><li>lazy one, use the compatibility
+ call<strong>xmlKeepBlanksDefault(0)</strong>but be aware that you
+ arerelying on a special (and possibly broken) set of heuristics
+ oflibxml to detect ignorable blanks. Don't complain if it breaks
+ ormake your application not 100% clean w.r.t. to it's input.</li>
+ <li>the Right Way: change you code to accept possibly
+ insignificantblanks characters, or have your tree populated with
+ weird blank textnodes. You can spot them using the commodity
+ function<strong>xmlIsBlankNode(node)</strong>returning 1 for such
+ blanknodes.</li>
+ </ol><p>Note also that with the new default the output functions don't add
+ anyextra indentation when saving a tree in order to be able to round
+ trip(read and save) without inflating the document with extra
+ formattingchars.</p>
</li>
- <li>The include path has changed to $prefix/libxml/ and the includes
- themselves uses this new prefix in includes instructions... If you are
- using (as expected) the
+ <li>The include path has changed to $prefix/libxml/ and the
+ includesthemselves uses this new prefix in includes instructions... If
+ you areusing (as expected) the
<pre>xml2-config --cflags</pre>
- <p>output to generate you compile commands this will probably work out of
- the box</p>
+ <p>output to generate you compile commands this will probably work out
+ ofthe box</p>
</li>
- <li>xmlDetectCharEncoding takes an extra argument indicating the length in
- byte of the head of the document available for character detection.</li>
-</ol><h3>Ensuring both libxml-1.x and libxml-2.x compatibility</h3><p>Two new version of libxml (1.8.11) and libxml2 (2.3.4) have been released
-to allow smooth upgrade of existing libxml v1code while retaining
-compatibility. They offers the following:</p><ol><li>similar include naming, one should use
- <strong>#include&lt;libxml/...&gt;</strong> in both cases.</li>
- <li>similar identifiers defined via macros for the child and root fields:
- respectively <strong>xmlChildrenNode</strong> and
- <strong>xmlRootNode</strong></li>
- <li>a new macro <strong>LIBXML_TEST_VERSION</strong> which should be
- inserted once in the client code</li>
-</ol><p>So the roadmap to upgrade your existing libxml applications is the
-following:</p><ol><li>install the libxml-1.8.8 (and libxml-devel-1.8.8) packages</li>
- <li>find all occurrences where the xmlDoc <strong>root</strong> field is
- used and change it to <strong>xmlRootNode</strong></li>
- <li>similarly find all occurrences where the xmlNode
- <strong>childs</strong> field is used and change it to
- <strong>xmlChildrenNode</strong></li>
- <li>add a <strong>LIBXML_TEST_VERSION</strong> macro somewhere in your
- <strong>main()</strong> or in the library init entry point</li>
+ <li>xmlDetectCharEncoding takes an extra argument indicating the length
+ inbyte of the head of the document available for character detection.</li>
+</ol><h3>Ensuring both libxml-1.x and libxml-2.x compatibility</h3><p>Two new version of libxml (1.8.11) and libxml2 (2.3.4) have been
+releasedto allow smooth upgrade of existing libxml v1code while
+retainingcompatibility. They offers the following:</p><ol><li>similar include naming, one should
+ use<strong>#include&lt;libxml/...&gt;</strong>in both cases.</li>
+ <li>similar identifiers defined via macros for the child and root
+ fields:respectively
+ <strong>xmlChildrenNode</strong>and<strong>xmlRootNode</strong></li>
+ <li>a new macro <strong>LIBXML_TEST_VERSION</strong>which should beinserted
+ once in the client code</li>
+</ol><p>So the roadmap to upgrade your existing libxml applications is
+thefollowing:</p><ol><li>install the libxml-1.8.8 (and libxml-devel-1.8.8) packages</li>
+ <li>find all occurrences where the xmlDoc <strong>root</strong>field isused
+ and change it to <strong>xmlRootNode</strong></li>
+ <li>similarly find all occurrences where the
+ xmlNode<strong>childs</strong>field is used and change it
+ to<strong>xmlChildrenNode</strong></li>
+ <li>add a <strong>LIBXML_TEST_VERSION</strong>macro somewhere in
+ your<strong>main()</strong>or in the library init entry point</li>
<li>Recompile, check compatibility, it should still work</li>
- <li>Change your configure script to look first for xml2-config and fall
- back using xml-config . Use the --cflags and --libs output of the command
- as the Include and Linking parameters needed to use libxml.</li>
- <li>install libxml2-2.3.x and libxml2-devel-2.3.x (libxml-1.8.y and
- libxml-devel-1.8.y can be kept simultaneously)</li>
- <li>remove your config.cache, relaunch your configuration mechanism, and
- recompile, if steps 2 and 3 were done right it should compile as-is</li>
- <li>Test that your application is still running correctly, if not this may
- be due to extra empty nodes due to formating spaces being kept in libxml2
- contrary to libxml1, in that case insert xmlKeepBlanksDefault(1) in your
- code before calling the parser (next to
- <strong>LIBXML_TEST_VERSION</strong> is a fine place).</li>
-</ol><p>Following those steps should work. It worked for some of my own code.</p><p>Let me put some emphasis on the fact that there is far more changes from
-libxml 1.x to 2.x than the ones you may have to patch for. The overall code
-has been considerably cleaned up and the conformance to the XML specification
-has been drastically improved too. Don't take those changes as an excuse to
-not upgrade, it may cost a lot on the long term ...</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+ <li>Change your configure script to look first for xml2-config and fallback
+ using xml-config . Use the --cflags and --libs output of the commandas
+ the Include and Linking parameters needed to use libxml.</li>
+ <li>install libxml2-2.3.x and libxml2-devel-2.3.x (libxml-1.8.y
+ andlibxml-devel-1.8.y can be kept simultaneously)</li>
+ <li>remove your config.cache, relaunch your configuration mechanism,
+ andrecompile, if steps 2 and 3 were done right it should compile
+ as-is</li>
+ <li>Test that your application is still running correctly, if not this
+ maybe due to extra empty nodes due to formating spaces being kept in
+ libxml2contrary to libxml1, in that case insert xmlKeepBlanksDefault(1)
+ in yourcode before calling the parser (next
+ to<strong>LIBXML_TEST_VERSION</strong>is a fine place).</li>
+</ol><p>Following those steps should work. It worked for some of my own code.</p><p>Let me put some emphasis on the fact that there is far more changes
+fromlibxml 1.x to 2.x than the ones you may have to patch for. The overall
+codehas been considerably cleaned up and the conformance to the XML
+specificationhas been drastically improved too. Don't take those changes as
+an excuse tonot upgrade, it may cost a lot on the long term ...</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/xml.html b/doc/xml.html
index e013dcc2..ab68aa37 100644
--- a/doc/xml.html
+++ b/doc/xml.html
@@ -3,42 +3,41 @@
<html>
<head>
<title>The XML C parser and toolkit of Gnome</title>
- <meta name="GENERATOR" content="amaya 8.5, see http://www.w3.org/Amaya/">
- <meta http-equiv="Content-Type" content="text/html">
+ <meta name="GENERATOR" content="amaya 8.8.5, see http://www.w3.org/Amaya/">
+ <meta http-equiv="content-type" content="text/html">
</head>
<body bgcolor="#ffffff">
<h1 align="center">The XML C parser and toolkit of Gnome</h1>
-<h1>Note: this is the flat content of the <a href="index.html">web
-site</a></h1>
+<h1>Note: this is the flat content of the <a
+href="index.html">website</a></h1>
<h1 style="text-align: center">libxml, a.k.a. gnome-xml</h1>
<p></p>
<p
-style="text-align: right; font-style: italic; font-size: 10pt">"Programming
-with libxml2 is like the thrilling embrace of an exotic stranger." <a
-href="http://diveintomark.org/archives/2004/02/18/libxml2">Mark
-Pilgrim</a></p>
-
-<p>Libxml2 is the XML C parser and toolkit developed for the Gnome project
-(but usable outside of the Gnome platform), it is free software available
-under the <a href="http://www.opensource.org/licenses/mit-license.html">MIT
-License</a>. XML itself is a metalanguage to design markup languages, i.e.
-text language where semantic and structure are added to the content using
-extra "markup" information enclosed between angle brackets. HTML is the most
-well-known markup language. Though the library is written in C <a
-href="python.html">a variety of language bindings</a> make it available in
-other environments.</p>
-
-<p>Libxml2 is known to be very portable, the library should build and work
-without serious troubles on a variety of systems (Linux, Unix, Windows,
-CygWin, MacOS, MacOS X, RISC Os, OS/2, VMS, QNX, MVS, ...)</p>
-
-<p>Libxml2 implements a number of existing standards related to markup
-languages:</p>
+style="text-align: right; font-style: italic; font-size: 10pt">"Programmingwith
+libxml2 is like the thrilling embrace of an exotic stranger." <a
+href="http://diveintomark.org/archives/2004/02/18/libxml2">MarkPilgrim</a></p>
+
+<p>Libxml2 is the XML C parser and toolkit developed for the Gnome
+project(but usable outside of the Gnome platform), it is free software
+availableunder the <a
+href="http://www.opensource.org/licenses/mit-license.html">MITLicense</a>.
+XML itself is a metalanguage to design markup languages, i.e.text language
+where semantic and structure are added to the content usingextra "markup"
+information enclosed between angle brackets. HTML is the mostwell-known
+markup language. Though the library is written in C <a href="python.html">a
+variety of language bindings</a>make it available inother environments.</p>
+
+<p>Libxml2 is known to be very portable, the library should build and
+workwithout serious troubles on a variety of systems (Linux, Unix,
+Windows,CygWin, MacOS, MacOS X, RISC Os, OS/2, VMS, QNX, MVS, ...)</p>
+
+<p>Libxml2 implements a number of existing standards related to
+markuplanguages:</p>
<ul>
<li>the XML standard: <a
href="http://www.w3.org/TR/REC-xml">http://www.w3.org/TR/REC-xml</a></li>
@@ -46,8 +45,8 @@ languages:</p>
href="http://www.w3.org/TR/REC-xml-names/">http://www.w3.org/TR/REC-xml-names/</a></li>
<li>XML Base: <a
href="http://www.w3.org/TR/xmlbase/">http://www.w3.org/TR/xmlbase/</a></li>
- <li><a href="http://www.cis.ohio-state.edu/rfc/rfc2396.txt">RFC 2396</a> :
- Uniform Resource Identifiers <a
+ <li><a href="http://www.cis.ohio-state.edu/rfc/rfc2396.txt">RFC
+ 2396</a>:Uniform Resource Identifiers <a
href="http://www.ietf.org/rfc/rfc2396.txt">http://www.ietf.org/rfc/rfc2396.txt</a></li>
<li>XML Path Language (XPath) 1.0: <a
href="http://www.w3.org/TR/xpath">http://www.w3.org/TR/xpath</a></li>
@@ -58,63 +57,64 @@ languages:</p>
<li>XML Inclusions (XInclude) Version 1.0: <a
href="http://www.w3.org/TR/xinclude/">http://www.w3.org/TR/xinclude/</a></li>
<li>ISO-8859-x encodings, as well as <a
- href="http://www.cis.ohio-state.edu/rfc/rfc2044.txt">rfc2044</a> [UTF-8]
- and <a href="http://www.cis.ohio-state.edu/rfc/rfc2781.txt">rfc2781</a>
- [UTF-16] Unicode encodings, and more if using iconv support</li>
+ href="http://www.cis.ohio-state.edu/rfc/rfc2044.txt">rfc2044</a>[UTF-8]and
+ <a
+ href="http://www.cis.ohio-state.edu/rfc/rfc2781.txt">rfc2781</a>[UTF-16]
+ Unicode encodings, and more if using iconv support</li>
<li>part of SGML Open Technical Resolution TR9401:1997</li>
<li>XML Catalogs Working Draft 06 August 2001: <a
href="http://www.oasis-open.org/committees/entity/spec-2001-08-06.html">http://www.oasis-open.org/committees/entity/spec-2001-08-06.html</a></li>
<li>Canonical XML Version 1.0: <a
- href="http://www.w3.org/TR/xml-c14n">http://www.w3.org/TR/xml-c14n</a>
- and the Exclusive XML Canonicalization CR draft <a
+ href="http://www.w3.org/TR/xml-c14n">http://www.w3.org/TR/xml-c14n</a>and
+ the Exclusive XML Canonicalization CR draft <a
href="http://www.w3.org/TR/xml-exc-c14n">http://www.w3.org/TR/xml-exc-c14n</a></li>
<li>Relax NG, ISO/IEC 19757-2:2003, <a
href="http://www.oasis-open.org/committees/relax-ng/spec-20011203.html">http://www.oasis-open.org/committees/relax-ng/spec-20011203.html</a></li>
<li>W3C XML Schemas Part 2: Datatypes <a
- href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">REC 02 May
- 2001</a></li>
- <li>W3C <a href="http://www.w3.org/TR/xml-id/">xml:id</a> Working Draft 7
- April 2004</li>
+ href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">REC 02
+ May2001</a></li>
+ <li>W3C <a href="http://www.w3.org/TR/xml-id/">xml:id</a>Working Draft
+ 7April 2004</li>
</ul>
-<p>In most cases libxml2 tries to implement the specifications in a
-relatively strictly compliant way. As of release 2.4.16, libxml2 passed all
-1800+ tests from the <a
-href="http://www.oasis-open.org/committees/xml-conformance/">OASIS XML Tests
-Suite</a>.</p>
+<p>In most cases libxml2 tries to implement the specifications in arelatively
+strictly compliant way. As of release 2.4.16, libxml2 passed all1800+ tests
+from the <a
+href="http://www.oasis-open.org/committees/xml-conformance/">OASIS XML
+TestsSuite</a>.</p>
-<p>To some extent libxml2 provides support for the following additional
-specifications but doesn't claim to implement them completely:</p>
+<p>To some extent libxml2 provides support for the following
+additionalspecifications but doesn't claim to implement them completely:</p>
<ul>
<li>Document Object Model (DOM) <a
- href="http://www.w3.org/TR/DOM-Level-2-Core/">http://www.w3.org/TR/DOM-Level-2-Core/</a>
- the document model, but it doesn't implement the API itself, gdome2 does
- this on top of libxml2</li>
- <li><a href="http://www.cis.ohio-state.edu/rfc/rfc959.txt">RFC 959</a> :
- libxml2 implements a basic FTP client code</li>
- <li><a href="http://www.cis.ohio-state.edu/rfc/rfc1945.txt">RFC 1945</a> :
- HTTP/1.0, again a basic HTTP client code</li>
- <li>SAX: a SAX2 like interface and a minimal SAX1 implementation compatible
- with early expat versions</li>
+ href="http://www.w3.org/TR/DOM-Level-2-Core/">http://www.w3.org/TR/DOM-Level-2-Core/</a>the
+ document model, but it doesn't implement the API itself, gdome2 doesthis
+ on top of libxml2</li>
+ <li><a href="http://www.cis.ohio-state.edu/rfc/rfc959.txt">RFC
+ 959</a>:libxml2 implements a basic FTP client code</li>
+ <li><a href="http://www.cis.ohio-state.edu/rfc/rfc1945.txt">RFC
+ 1945</a>:HTTP/1.0, again a basic HTTP client code</li>
+ <li>SAX: a SAX2 like interface and a minimal SAX1 implementation
+ compatiblewith early expat versions</li>
</ul>
<p>A partial implementation of <a
-href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/">XML Schemas Part
-1: Structure</a> is being worked on but it would be far too early to make any
-conformance statement about it at the moment.</p>
+href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/">XML Schemas Part1:
+Structure</a>is being worked on but it would be far too early to make
+anyconformance statement about it at the moment.</p>
<p>Separate documents:</p>
<ul>
- <li><a href="http://xmlsoft.org/XSLT/">the libxslt page</a> providing an
- implementation of XSLT 1.0 and common extensions like EXSLT for
- libxml2</li>
- <li><a href="http://www.cs.unibo.it/~casarini/gdome2/">the gdome2 page</a>
- : a standard DOM2 implementation for libxml2</li>
- <li><a href="http://www.aleksey.com/xmlsec/">the XMLSec page</a>: an
- implementation of <a href="http://www.w3.org/TR/xmldsig-core/">W3C XML
- Digital Signature</a> for libxml2</li>
- <li>also check the related links section below for more related and active
- projects.</li>
+ <li><a href="http://xmlsoft.org/XSLT/">the libxslt page</a>providing
+ animplementation of XSLT 1.0 and common extensions like EXSLT
+ forlibxml2</li>
+ <li><a href="http://www.cs.unibo.it/~casarini/gdome2/">the gdome2 page</a>:
+ a standard DOM2 implementation for libxml2</li>
+ <li><a href="http://www.aleksey.com/xmlsec/">the XMLSec page</a>:
+ animplementation of <a href="http://www.w3.org/TR/xmldsig-core/">W3C
+ XMLDigital Signature</a>for libxml2</li>
+ <li>also check the related links section below for more related and
+ activeprojects.</li>
</ul>
<!----------------<p>Results of the <a
href="http://xmlbench.sourceforge.net/results/benchmark/index.html">xmlbench
@@ -129,43 +129,42 @@ alt="benchmark results for Expat Xerces libxml2 Oracle and Sun toolkits"></p>
<h2><a name="Introducti">Introduction</a></h2>
<p>This document describes libxml, the <a
-href="http://www.w3.org/XML/">XML</a> C parser and toolkit developed for the
-<a href="http://www.gnome.org/">Gnome</a> project. <a
-href="http://www.w3.org/XML/">XML is a standard</a> for building tag-based
-structured documents/data.</p>
+href="http://www.w3.org/XML/">XML</a>C parser and toolkit developed for the<a
+href="http://www.gnome.org/">Gnome</a>project. <a
+href="http://www.w3.org/XML/">XML is a standard</a>for building
+tag-basedstructured documents/data.</p>
<p>Here are some key points about libxml:</p>
<ul>
- <li>Libxml2 exports Push (progressive) and Pull (blocking) type parser
- interfaces for both XML and HTML.</li>
- <li>Libxml2 can do DTD validation at parse time, using a parsed document
- instance, or with an arbitrary DTD.</li>
+ <li>Libxml2 exports Push (progressive) and Pull (blocking) type
+ parserinterfaces for both XML and HTML.</li>
+ <li>Libxml2 can do DTD validation at parse time, using a parsed
+ documentinstance, or with an arbitrary DTD.</li>
<li>Libxml2 includes complete <a
href="http://www.w3.org/TR/xpath">XPath</a>, <a
- href="http://www.w3.org/TR/xptr">XPointer</a> and <a
- href="http://www.w3.org/TR/xinclude">XInclude</a> implementations.</li>
- <li>It is written in plain C, making as few assumptions as possible, and
- sticking closely to ANSI C/POSIX for easy embedding. Works on
- Linux/Unix/Windows, ported to a number of other platforms.</li>
- <li>Basic support for HTTP and FTP client allowing applications to fetch
- remote resources.</li>
+ href="http://www.w3.org/TR/xptr">XPointer</a>and <a
+ href="http://www.w3.org/TR/xinclude">XInclude</a>implementations.</li>
+ <li>It is written in plain C, making as few assumptions as possible,
+ andsticking closely to ANSI C/POSIX for easy embedding. Works
+ onLinux/Unix/Windows, ported to a number of other platforms.</li>
+ <li>Basic support for HTTP and FTP client allowing applications to
+ fetchremote resources.</li>
<li>The design is modular, most of the extensions can be compiled out.</li>
<li>The internal document representation is as close as possible to the <a
- href="http://www.w3.org/DOM/">DOM</a> interfaces.</li>
+ href="http://www.w3.org/DOM/">DOM</a>interfaces.</li>
<li>Libxml2 also has a <a
- href="http://www.megginson.com/SAX/index.html">SAX like interface</a>;
- the interface is designed to be compatible with <a
+ href="http://www.megginson.com/SAX/index.html">SAX like interface</a>;the
+ interface is designed to be compatible with <a
href="http://www.jclark.com/xml/expat.html">Expat</a>.</li>
<li>This library is released under the <a
- href="http://www.opensource.org/licenses/mit-license.html">MIT
- License</a>. See the Copyright file in the distribution for the precise
- wording.</li>
+ href="http://www.opensource.org/licenses/mit-license.html">MITLicense</a>.
+ See the Copyright file in the distribution for the precisewording.</li>
</ul>
-<p>Warning: unless you are forced to because your application links with a
-Gnome-1.X library requiring it, <strong><span
-style="background-color: #FF0000">Do Not Use libxml1</span></strong>, use
-libxml2</p>
+<p>Warning: unless you are forced to because your application links with
+aGnome-1.X library requiring it, <strong><span
+style="background-color: #FF0000">Do Not Use libxml1</span></strong>,
+uselibxml2</p>
<h2><a name="FAQ">FAQ</a></h2>
@@ -181,67 +180,65 @@ libxml2</p>
<ol>
<li><em>Licensing Terms for libxml</em>
<p>libxml2 is released under the <a
- href="http://www.opensource.org/licenses/mit-license.html">MIT
- License</a>; see the file Copyright in the distribution for the precise
- wording</p>
+ href="http://www.opensource.org/licenses/mit-license.html">MITLicense</a>;
+ see the file Copyright in the distribution for the precisewording</p>
</li>
<li><em>Can I embed libxml2 in a proprietary application ?</em>
- <p>Yes. The MIT License allows you to keep proprietary the changes you
- made to libxml, but it would be graceful to send-back bug fixes and
- improvements as patches for possible incorporation in the main
- development tree.</p>
+ <p>Yes. The MIT License allows you to keep proprietary the changes
+ youmade to libxml, but it would be graceful to send-back bug fixes
+ andimprovements as patches for possible incorporation in the
+ maindevelopment tree.</p>
</li>
</ol>
<h3><a name="Installati">Installation</a></h3>
<ol>
- <li><strong><span style="background-color: #FF0000">Do Not Use
- libxml1</span></strong>, use libxml2</li>
- <li><em>Where can I get libxml</em> ?
+ <li><strong><span style="background-color: #FF0000">Do Not
+ Uselibxml1</span></strong>, use libxml2</li>
+ <li><em>Where can I get libxml</em>?
<p>The original distribution comes from <a
- href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a> or <a
+ href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a>or <a
href="ftp://ftp.gnome.org/pub/GNOME/sources/libxml2/2.6/">gnome.org</a></p>
- <p>Most Linux and BSD distributions include libxml, this is probably the
- safer way for end-users to use libxml.</p>
+ <p>Most Linux and BSD distributions include libxml, this is probably
+ thesafer way for end-users to use libxml.</p>
<p>David Doolin provides precompiled Windows versions at <a
href="http://www.ce.berkeley.edu/~doolin/code/libxmlwin32/ ">http://www.ce.berkeley.edu/~doolin/code/libxmlwin32/</a></p>
</li>
<li><em>I see libxml and libxml2 releases, which one should I install ?</em>
<ul>
- <li>If you are not constrained by backward compatibility issues with
- existing applications, install libxml2 only</li>
- <li>If you are not doing development, you can safely install both.
- Usually the packages <a
- href="http://rpmfind.net/linux/RPM/libxml.html">libxml</a> and <a
- href="http://rpmfind.net/linux/RPM/libxml2.html">libxml2</a> are
- compatible (this is not the case for development packages).</li>
- <li>If you are a developer and your system provides separate packaging
- for shared libraries and the development components, it is possible
- to install libxml and libxml2, and also <a
- href="http://rpmfind.net/linux/RPM/libxml-devel.html">libxml-devel</a>
- and <a
- href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml2-devel</a>
- too for libxml2 &gt;= 2.3.0</li>
- <li>If you are developing a new application, please develop against
- libxml2(-devel)</li>
+ <li>If you are not constrained by backward compatibility issues
+ withexisting applications, install libxml2 only</li>
+ <li>If you are not doing development, you can safely install
+ both.Usually the packages <a
+ href="http://rpmfind.net/linux/RPM/libxml.html">libxml</a>and <a
+ href="http://rpmfind.net/linux/RPM/libxml2.html">libxml2</a>arecompatible
+ (this is not the case for development packages).</li>
+ <li>If you are a developer and your system provides separate
+ packagingfor shared libraries and the development components, it is
+ possibleto install libxml and libxml2, and also <a
+ href="http://rpmfind.net/linux/RPM/libxml-devel.html">libxml-devel</a>and
+ <a
+ href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml2-devel</a>too
+ for libxml2 &gt;= 2.3.0</li>
+ <li>If you are developing a new application, please develop
+ againstlibxml2(-devel)</li>
</ul>
</li>
<li><em>I can't install the libxml package, it conflicts with libxml0</em>
- <p>You probably have an old libxml0 package used to provide the shared
- library for libxml.so.0, you can probably safely remove it. The libxml
- packages provided on <a
- href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a> provide
- libxml.so.0</p>
+ <p>You probably have an old libxml0 package used to provide the
+ sharedlibrary for libxml.so.0, you can probably safely remove it. The
+ libxmlpackages provided on <a
+ href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a>providelibxml.so.0</p>
</li>
- <li><em>I can't install the libxml(2) RPM package due to failed
- dependencies</em>
- <p>The most generic solution is to re-fetch the latest src.rpm , and
- rebuild it locally with</p>
+ <li><em>I can't install the libxml(2) RPM package due to
+ faileddependencies</em>
+ <p>The most generic solution is to re-fetch the latest src.rpm ,
+ andrebuild it locally with</p>
<p><code>rpm --rebuild libxml(2)-xxx.src.rpm</code>.</p>
- <p>If everything goes well it will generate two binary rpm packages (one
- providing the shared libs and xmllint, and the other one, the -devel
- package, providing includes, static libraries and scripts needed to build
- applications with libxml(2)) that you can install locally.</p>
+ <p>If everything goes well it will generate two binary rpm packages
+ (oneproviding the shared libs and xmllint, and the other one, the
+ -develpackage, providing includes, static libraries and scripts needed to
+ buildapplications with libxml(2)) that you can install locally.</p>
</li>
</ol>
@@ -256,123 +253,121 @@ libxml2</p>
<p><code>./configure [possible options]</code></p>
<p><code>make</code></p>
<p><code>make install</code></p>
- <p>At that point you may have to rerun ldconfig or a similar utility to
- update your list of installed shared libs.</p>
+ <p>At that point you may have to rerun ldconfig or a similar utility
+ toupdate your list of installed shared libs.</p>
</li>
<li><em>What other libraries are needed to compile/install libxml2 ?</em>
- <p>Libxml2 does not require any other library, the normal C ANSI API
- should be sufficient (please report any violation to this rule you may
- find).</p>
- <p>However if found at configuration time libxml2 will detect and use the
- following libs:</p>
+ <p>Libxml2 does not require any other library, the normal C ANSI
+ APIshould be sufficient (please report any violation to this rule you
+ mayfind).</p>
+ <p>However if found at configuration time libxml2 will detect and use
+ thefollowing libs:</p>
<ul>
- <li><a href="http://www.info-zip.org/pub/infozip/zlib/">libz</a> : a
- highly portable and available widely compression library.</li>
- <li>iconv: a powerful character encoding conversion library. It is
- included by default in recent glibc libraries, so it doesn't need to
- be installed specifically on Linux. It now seems a <a
- href="http://www.opennc.org/onlinepubs/7908799/xsh/iconv.html">part
- of the official UNIX</a> specification. Here is one <a
- href="http://www.gnu.org/software/libiconv/">implementation of the
- library</a> which source can be found <a
+ <li><a href="http://www.info-zip.org/pub/infozip/zlib/">libz</a>:
+ ahighly portable and available widely compression library.</li>
+ <li>iconv: a powerful character encoding conversion library. It
+ isincluded by default in recent glibc libraries, so it doesn't need
+ tobe installed specifically on Linux. It now seems a <a
+ href="http://www.opennc.org/onlinepubs/7908799/xsh/iconv.html">partof
+ the official UNIX</a>specification. Here is one <a
+ href="http://www.gnu.org/software/libiconv/">implementation of
+ thelibrary</a>which source can be found <a
href="ftp://ftp.ilog.fr/pub/Users/haible/gnu/">here</a>.</li>
</ul>
</li>
<li><em>Make check fails on some platforms</em>
- <p>Sometimes the regression tests' results don't completely match the
- value produced by the parser, and the makefile uses diff to print the
- delta. On some platforms the diff return breaks the compilation process;
- if the diff is small this is probably not a serious problem.</p>
- <p>Sometimes (especially on Solaris) make checks fail due to limitations
- in make. Try using GNU-make instead.</p>
+ <p>Sometimes the regression tests' results don't completely match
+ thevalue produced by the parser, and the makefile uses diff to print
+ thedelta. On some platforms the diff return breaks the compilation
+ process;if the diff is small this is probably not a serious problem.</p>
+ <p>Sometimes (especially on Solaris) make checks fail due to
+ limitationsin make. Try using GNU-make instead.</p>
</li>
<li><em>I use the CVS version and there is no configure script</em>
- <p>The configure script (and other Makefiles) are generated. Use the
- autogen.sh script to regenerate the configure script and Makefiles,
- like:</p>
+ <p>The configure script (and other Makefiles) are generated. Use
+ theautogen.sh script to regenerate the configure script and
+ Makefiles,like:</p>
<p><code>./autogen.sh --prefix=/usr --disable-shared</code></p>
</li>
<li><em>I have troubles when running make tests with gcc-3.0</em>
- <p>It seems the initial release of gcc-3.0 has a problem with the
- optimizer which miscompiles the URI module. Please use another
- compiler.</p>
+ <p>It seems the initial release of gcc-3.0 has a problem with
+ theoptimizer which miscompiles the URI module. Please use
+ anothercompiler.</p>
</li>
</ol>
-<h3><a name="Developer">Developer</a> corner</h3>
+<h3><a name="Developer">Developer</a>corner</h3>
<ol>
<li><em>Troubles compiling or linking programs using libxml2</em>
- <p>Usually the problem comes from the fact that the compiler doesn't get
- the right compilation or linking flags. There is a small shell script
- <code>xml2-config</code> which is installed as part of libxml2 usual
- install process which provides those flags. Use</p>
+ <p>Usually the problem comes from the fact that the compiler doesn't
+ getthe right compilation or linking flags. There is a small shell
+ script<code>xml2-config</code>which is installed as part of libxml2
+ usualinstall process which provides those flags. Use</p>
<p><code>xml2-config --cflags</code></p>
<p>to get the compilation flags and</p>
<p><code>xml2-config --libs</code></p>
- <p>to get the linker flags. Usually this is done directly from the
- Makefile as:</p>
+ <p>to get the linker flags. Usually this is done directly from
+ theMakefile as:</p>
<p><code>CFLAGS=`xml2-config --cflags`</code></p>
<p><code>LIBS=`xml2-config --libs`</code></p>
</li>
- <li><em>I want to install my own copy of libxml2 in my home directory and
- link my programs against it, but it doesn't work</em>
- <p>There are many different ways to accomplish this. Here is one way to
- do this under Linux. Suppose your home directory is <code>/home/user.
- </code>Then:</p>
+ <li><em>I want to install my own copy of libxml2 in my home directory
+ andlink my programs against it, but it doesn't work</em>
+ <p>There are many different ways to accomplish this. Here is one way
+ todo this under Linux. Suppose your home directory is
+ <code>/home/user.</code>Then:</p>
<ul>
<li>Create a subdirectory, let's call it <code>myxml</code></li>
<li>unpack the libxml2 distribution into that subdirectory</li>
- <li>chdir into the unpacked distribution
- (<code>/home/user/myxml/libxml2 </code>)</li>
- <li>configure the library using the "<code>--prefix</code>" switch,
- specifying an installation subdirectory in
- <code>/home/user/myxml</code>, e.g.
- <p><code>./configure --prefix /home/user/myxml/xmlinst</code> {other
- configuration options}</p>
+ <li>chdir into the unpacked distribution(<code>/home/user/myxml/libxml2
+ </code>)</li>
+ <li>configure the library using the "<code>--prefix</code>"
+ switch,specifying an installation subdirectory
+ in<code>/home/user/myxml</code>, e.g.
+ <p><code>./configure --prefix
+ /home/user/myxml/xmlinst</code>{otherconfiguration options}</p>
</li>
- <li>now run <code>make</code> followed by <code>make install</code></li>
- <li>At this point, the installation subdirectory contains the complete
- "private" include files, library files and binary program files (e.g.
- xmllint), located in
- <p><code>/home/user/myxml/xmlinst/lib,
- /home/user/myxml/xmlinst/include </code> and <code>
- /home/user/myxml/xmlinst/bin</code></p>
+ <li>now run <code>make</code>followed by <code>make install</code></li>
+ <li>At this point, the installation subdirectory contains the
+ complete"private" include files, library files and binary program
+ files (e.g.xmllint), located in
+ <p><code>/home/user/myxml/xmlinst/lib,/home/user/myxml/xmlinst/include
+ </code>and <code>/home/user/myxml/xmlinst/bin</code></p>
respectively.</li>
- <li>In order to use this "private" library, you should first add it to
- the beginning of your default PATH (so that your own private program
- files such as xmllint will be used instead of the normal system
- ones). To do this, the Bash command would be
+ <li>In order to use this "private" library, you should first add it
+ tothe beginning of your default PATH (so that your own private
+ programfiles such as xmllint will be used instead of the normal
+ systemones). To do this, the Bash command would be
<p><code>export PATH=/home/user/myxml/xmlinst/bin:$PATH</code></p>
</li>
- <li>Now suppose you have a program <code>test1.c</code> that you would
- like to compile with your "private" library. Simply compile it using
- the command
+ <li>Now suppose you have a program <code>test1.c</code>that you
+ wouldlike to compile with your "private" library. Simply compile it
+ usingthe command
<p><code>gcc `xml2-config --cflags --libs` -o test test.c</code></p>
- Note that, because your PATH has been set with <code>
- /home/user/myxml/xmlinst/bin</code> at the beginning, the xml2-config
- program which you just installed will be used instead of the system
- default one, and this will <em>automatically</em> get the correct
- libraries linked with your program.</li>
+ Note that, because your PATH has been set with
+ <code>/home/user/myxml/xmlinst/bin</code>at the beginning, the
+ xml2-configprogram which you just installed will be used instead of
+ the systemdefault one, and this will <em>automatically</em>get the
+ correctlibraries linked with your program.</li>
</ul>
</li>
<p></p>
<li><em>xmlDocDump() generates output on one line.</em>
- <p>Libxml2 will not <strong>invent</strong> spaces in the content of a
- document since <strong>all spaces in the content of a document are
- significant</strong>. If you build a tree from the API and want
- indentation:</p>
+ <p>Libxml2 will not <strong>invent</strong>spaces in the content of
+ adocument since <strong>all spaces in the content of a document
+ aresignificant</strong>. If you build a tree from the API and
+ wantindentation:</p>
<ol>
<li>the correct way is to generate those yourself too.</li>
- <li>the dangerous way is to ask libxml2 to add those blanks to your
- content <strong>modifying the content of your document in the
- process</strong>. The result may not be what you expect. There is
- <strong>NO</strong> way to guarantee that such a modification won't
- affect other parts of the content of your document. See <a
- href="http://xmlsoft.org/html/libxml-parser.html#xmlKeepBlanksDefault">xmlKeepBlanksDefault
- ()</a> and <a
- href="http://xmlsoft.org/html/libxml-tree.html#xmlSaveFormatFile">xmlSaveFormatFile
- ()</a></li>
+ <li>the dangerous way is to ask libxml2 to add those blanks to
+ yourcontent <strong>modifying the content of your document in
+ theprocess</strong>. The result may not be what you expect. There
+ is<strong>NO</strong>way to guarantee that such a modification
+ won'taffect other parts of the content of your document. See <a
+ href="http://xmlsoft.org/html/libxml-parser.html#xmlKeepBlanksDefault">xmlKeepBlanksDefault()</a>and
+ <a
+ href="http://xmlsoft.org/html/libxml-tree.html#xmlSaveFormatFile">xmlSaveFormatFile()</a></li>
</ol>
</li>
<li>Extra nodes in the document:
@@ -382,10 +377,10 @@ libxml2</p>
&lt;NODE CommFlag="0"/&gt;
&lt;NODE CommFlag="1"/&gt;
&lt;/PLAN&gt;</pre>
- <p><em>after parsing it with the function
- pxmlDoc=xmlParseFile(...);</em></p>
- <p><em>I want to the get the content of the first node (node with the
- CommFlag="0")</em></p>
+ <p><em>after parsing it with the
+ functionpxmlDoc=xmlParseFile(...);</em></p>
+ <p><em>I want to the get the content of the first node (node with
+ theCommFlag="0")</em></p>
<p><em>so I did it as following;</em></p>
<pre>xmlNodePtr pnode;
pnode=pxmlDoc-&gt;children-&gt;children;</pre>
@@ -393,70 +388,72 @@ pnode=pxmlDoc-&gt;children-&gt;children;</pre>
<pre>pnode=pxmlDoc-&gt;children-&gt;children-&gt;next;</pre>
<p><em>then it works. Can someone explain it to me.</em></p>
<p></p>
- <p>In XML all characters in the content of the document are significant
- <strong>including blanks and formatting line breaks</strong>.</p>
- <p>The extra nodes you are wondering about are just that, text nodes with
- the formatting spaces which are part of the document but that people tend
- to forget. There is a function <a
- href="http://xmlsoft.org/html/libxml-parser.html">xmlKeepBlanksDefault
- ()</a> to remove those at parse time, but that's an heuristic, and its
- use should be limited to cases where you are certain there is no
- mixed-content in the document.</p>
+ <p>In XML all characters in the content of the document are
+ significant<strong>including blanks and formatting line
+ breaks</strong>.</p>
+ <p>The extra nodes you are wondering about are just that, text nodes
+ withthe formatting spaces which are part of the document but that people
+ tendto forget. There is a function <a
+ href="http://xmlsoft.org/html/libxml-parser.html">xmlKeepBlanksDefault()</a>to
+ remove those at parse time, but that's an heuristic, and itsuse should be
+ limited to cases where you are certain there is nomixed-content in the
+ document.</p>
</li>
- <li><em>I get compilation errors of existing code like when accessing
- <strong>root</strong> or <strong>child fields</strong> of nodes.</em>
- <p>You are compiling code developed for libxml version 1 and using a
- libxml2 development environment. Either switch back to libxml v1 devel or
- even better fix the code to compile with libxml2 (or both) by <a
+ <li><em>I get compilation errors of existing code like when
+ accessing<strong>root</strong>or <strong>child fields</strong>of
+ nodes.</em>
+ <p>You are compiling code developed for libxml version 1 and using
+ alibxml2 development environment. Either switch back to libxml v1 devel
+ oreven better fix the code to compile with libxml2 (or both) by <a
href="upgrade.html">following the instructions</a>.</p>
</li>
- <li><em>I get compilation errors about non existing
- <strong>xmlRootNode</strong> or <strong>xmlChildrenNode</strong>
- fields.</em>
+ <li><em>I get compilation errors about non
+ existing<strong>xmlRootNode</strong>or
+ <strong>xmlChildrenNode</strong>fields.</em>
<p>The source code you are using has been <a
- href="upgrade.html">upgraded</a> to be able to compile with both libxml
- and libxml2, but you need to install a more recent version:
- libxml(-devel) &gt;= 1.8.8 or libxml2(-devel) &gt;= 2.1.0</p>
+ href="upgrade.html">upgraded</a>to be able to compile with both libxmland
+ libxml2, but you need to install a more recent version:libxml(-devel)
+ &gt;= 1.8.8 or libxml2(-devel) &gt;= 2.1.0</p>
</li>
<li><em>XPath implementation looks seriously broken</em>
- <p>XPath implementation prior to 2.3.0 was really incomplete. Upgrade to
- a recent version, there are no known bugs in the current version.</p>
+ <p>XPath implementation prior to 2.3.0 was really incomplete. Upgrade toa
+ recent version, there are no known bugs in the current version.</p>
</li>
<li><em>The example provided in the web page does not compile.</em>
- <p>It's hard to maintain the documentation in sync with the code
- &lt;grin/&gt; ...</p>
- <p>Check the previous points 1/ and 2/ raised before, and please send
- patches.</p>
+ <p>It's hard to maintain the documentation in sync with the
+ code&lt;grin/&gt; ...</p>
+ <p>Check the previous points 1/ and 2/ raised before, and please
+ sendpatches.</p>
</li>
- <li><em>Where can I get more examples and information than provided on the
- web page?</em>
- <p>Ideally a libxml2 book would be nice. I have no such plan ... But you
- can:</p>
+ <li><em>Where can I get more examples and information than provided on
+ theweb page?</em>
+ <p>Ideally a libxml2 book would be nice. I have no such plan ... But
+ youcan:</p>
<ul>
- <li>check more deeply the <a href="html/libxml-lib.html">existing
- generated doc</a></li>
- <li>have a look at <a href="examples/index.html">the set of
- examples</a>.</li>
- <li>look for examples of use for libxml2 function using the Gnome code.
- For example the following will query the full Gnome CVS base for the
- use of the <strong>xmlAddChild()</strong> function:
+ <li>check more deeply the <a
+ href="html/libxml-lib.html">existinggenerated doc</a></li>
+ <li>have a look at <a href="examples/index.html">the set
+ ofexamples</a>.</li>
+ <li>look for examples of use for libxml2 function using the Gnome
+ code.For example the following will query the full Gnome CVS base for
+ theuse of the <strong>xmlAddChild()</strong>function:
<p><a
href="http://cvs.gnome.org/lxr/search?string=xmlAddChild">http://cvs.gnome.org/lxr/search?string=xmlAddChild</a></p>
- <p>This may be slow, a large hardware donation to the gnome project
- could cure this :-)</p>
+ <p>This may be slow, a large hardware donation to the gnome
+ projectcould cure this :-)</p>
</li>
<li><a
- href="http://cvs.gnome.org/bonsai/rview.cgi?cvsroot=/cvs/gnome&amp;dir=gnome-xml">Browse
- the libxml2 source</a> , I try to write code as clean and documented
- as possible, so looking at it may be helpful. In particular the code
- of xmllint.c and of the various testXXX.c test programs should
- provide good examples of how to do things with the library.</li>
+ href="http://cvs.gnome.org/bonsai/rview.cgi?cvsroot=/cvs/gnome&amp;dir=gnome-xml">Browsethe
+ libxml2 source</a>, I try to write code as clean and documentedas
+ possible, so looking at it may be helpful. In particular the codeof
+ xmllint.c and of the various testXXX.c test programs shouldprovide
+ good examples of how to do things with the library.</li>
</ul>
</li>
<li>What about C++ ?
- <p>libxml2 is written in pure C in order to allow easy reuse on a number
- of platforms, including embedded systems. I don't intend to convert to
- C++.</p>
+ <p>libxml2 is written in pure C in order to allow easy reuse on a
+ numberof platforms, including embedded systems. I don't intend to convert
+ toC++.</p>
<p>There is however a C++ wrapper which may fulfill your needs:</p>
<ul>
<li>by Ari Johnson &lt;ari@btigate.com&gt;:
@@ -474,12 +471,11 @@ pnode=pxmlDoc-&gt;children-&gt;children;</pre>
</ul>
</li>
<li>How to validate a document a posteriori ?
- <p>It is possible to validate documents which had not been validated at
- initial parsing time or documents which have been built from scratch
- using the API. Use the <a
- href="http://xmlsoft.org/html/libxml-valid.html#xmlValidateDtd">xmlValidateDtd()</a>
- function. It is also possible to simply add a DTD to an existing
- document:</p>
+ <p>It is possible to validate documents which had not been validated
+ atinitial parsing time or documents which have been built from
+ scratchusing the API. Use the <a
+ href="http://xmlsoft.org/html/libxml-valid.html#xmlValidateDtd">xmlValidateDtd()</a>function.
+ It is also possible to simply add a DTD to an existingdocument:</p>
<pre>xmlDocPtr doc; /* your existing document */
xmlDtdPtr dtd = xmlParseDTD(NULL, filename_of_dtd); /* parse the DTD */
@@ -491,10 +487,10 @@ xmlDtdPtr dtd = xmlParseDTD(NULL, filename_of_dtd); /* parse the DTD */
</pre>
</li>
<li>So what is this funky "xmlChar" used all the time?
- <p>It is a null terminated sequence of utf-8 characters. And only utf-8!
- You need to convert strings encoded in different ways to utf-8 before
- passing them to the API. This can be accomplished with the iconv library
- for instance.</p>
+ <p>It is a null terminated sequence of utf-8 characters. And only
+ utf-8!You need to convert strings encoded in different ways to utf-8
+ beforepassing them to the API. This can be accomplished with the iconv
+ libraryfor instance.</p>
</li>
<li>etc ...</li>
</ol>
@@ -505,190 +501,189 @@ xmlDtdPtr dtd = xmlParseDTD(NULL, filename_of_dtd); /* parse the DTD */
<p>There are several on-line resources related to using libxml:</p>
<ol>
- <li>Use the <a href="search.php">search engine</a> to look up
- information.</li>
+ <li>Use the <a href="search.php">search engine</a>to look
+ upinformation.</li>
<li>Check the <a href="FAQ.html">FAQ.</a></li>
- <li>Check the <a href="http://xmlsoft.org/html/libxml-lib.html">extensive
- documentation</a> automatically extracted from code comments.</li>
- <li>Look at the documentation about <a href="encoding.html">libxml
- internationalization support</a>.</li>
- <li>This page provides a global overview and <a href="example.html">some
- examples</a> on how to use libxml.</li>
+ <li>Check the <a
+ href="http://xmlsoft.org/html/libxml-lib.html">extensivedocumentation</a>automatically
+ extracted from code comments.</li>
+ <li>Look at the documentation about <a
+ href="encoding.html">libxmlinternationalization support</a>.</li>
+ <li>This page provides a global overview and <a
+ href="example.html">someexamples</a>on how to use libxml.</li>
<li><a href="examples/index.html">Code examples</a></li>
- <li>John Fleck's libxml2 tutorial: <a href="tutorial/index.html">html</a>
- or <a href="tutorial/xmltutorial.pdf">pdf</a>.</li>
+ <li>John Fleck's libxml2 tutorial: <a href="tutorial/index.html">html</a>or
+ <a href="tutorial/xmltutorial.pdf">pdf</a>.</li>
<li>If you need to parse large files, check the <a
- href="xmlreader.html">xmlReader</a> API tutorial</li>
- <li><a href="mailto:james@daa.com.au">James Henstridge</a> wrote <a
- href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">some nice
- documentation</a> explaining how to use the libxml SAX interface.</li>
+ href="xmlreader.html">xmlReader</a>API tutorial</li>
+ <li><a href="mailto:james@daa.com.au">James Henstridge</a>wrote <a
+ href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">some
+ nicedocumentation</a>explaining how to use the libxml SAX interface.</li>
<li>George Lebl wrote <a
- href="http://www-106.ibm.com/developerworks/library/l-gnome3/">an article
- for IBM developerWorks</a> about using libxml.</li>
- <li>Check <a href="http://cvs.gnome.org/lxr/source/gnome-xml/TODO">the TODO
- file</a>.</li>
- <li>Read the <a href="upgrade.html">1.x to 2.x upgrade path</a>
- description. If you are starting a new project using libxml you should
- really use the 2.x version.</li>
+ href="http://www-106.ibm.com/developerworks/library/l-gnome3/">an
+ articlefor IBM developerWorks</a>about using libxml.</li>
+ <li>Check <a href="http://cvs.gnome.org/lxr/source/gnome-xml/TODO">the
+ TODOfile</a>.</li>
+ <li>Read the <a href="upgrade.html">1.x to 2.x upgrade path</a>description.
+ If you are starting a new project using libxml you shouldreally use the
+ 2.x version.</li>
<li>And don't forget to look at the <a
href="http://mail.gnome.org/archives/xml/">mailing-list archive</a>.</li>
</ol>
<h2><a name="Reporting">Reporting bugs and getting help</a></h2>
-<p>Well, bugs or missing features are always possible, and I will make a
-point of fixing them in a timely fashion. The best way to report a bug is to
-use the <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Gnome
-bug tracking database</a> (make sure to use the "libxml2" module name). I
-look at reports there regularly and it's good to have a reminder when a bug
-is still open. Be sure to specify that the bug is for the package libxml2.</p>
+<p>Well, bugs or missing features are always possible, and I will make apoint
+of fixing them in a timely fashion. The best way to report a bug is touse the
+<a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Gnomebug
+tracking database</a>(make sure to use the "libxml2" module name). Ilook at
+reports there regularly and it's good to have a reminder when a bugis still
+open. Be sure to specify that the bug is for the package libxml2.</p>
-<p>For small problems you can try to get help on IRC, the #xml channel on
-irc.gnome.org (port 6667) usually have a few person subscribed which may help
-(but there is no garantee and if a real issue is raised it should go on the
-mailing-list for archival).</p>
+<p>For small problems you can try to get help on IRC, the #xml channel
+onirc.gnome.org (port 6667) usually have a few person subscribed which may
+help(but there is no garantee and if a real issue is raised it should go on
+themailing-list for archival).</p>
<p>There is also a mailing-list <a
-href="mailto:xml@gnome.org">xml@gnome.org</a> for libxml, with an <a
-href="http://mail.gnome.org/archives/xml/">on-line archive</a> (<a
-href="http://xmlsoft.org/messages">old</a>). To subscribe to this list,
-please visit the <a
-href="http://mail.gnome.org/mailman/listinfo/xml">associated Web</a> page and
-follow the instructions. <strong>Do not send code, I won't debug it</strong>
-(but patches are really appreciated!).</p>
-
-<p>Please note that with the current amount of virus and SPAM, sending mail
-to the list without being subscribed won't work. There is *far too many
-bounces* (in the order of a thousand a day !) I cannot approve them manually
-anymore. If your mail to the list bounced waiting for administrator approval,
-it is LOST ! Repost it and fix the problem triggering the error. Also please
-note that <span style="color: #FF0000; background-color: #FFFFFF">emails with
-a legal warning asking to not copy or redistribute freely the informations
-they contain</span> are <strong>NOT</strong> acceptable for the mailing-list,
-such mail will as much as possible be discarded automatically, and are less
-likely to be answered if they made it to the list, <strong>DO NOT</strong>
-post to the list from an email address where such legal requirements are
-automatically added, get private paying support if you can't share
-informations.</p>
-
-<p>Check the following <strong><span style="color: #FF0000">before
-posting</span></strong>:</p>
-<ul>
- <li>Read the <a href="FAQ.html">FAQ</a> and <a href="search.php">use the
- search engine</a> to get information related to your problem.</li>
- <li>Make sure you are <a href="ftp://xmlsoft.org/libxml2/">using a recent
- version</a>, and that the problem still shows up in a recent version.</li>
- <li>Check the <a href="http://mail.gnome.org/archives/xml/">list
- archives</a> to see if the problem was reported already. In this case
- there is probably a fix available, similarly check the <a
- href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">registered
- open bugs</a>.</li>
- <li>Make sure you can reproduce the bug with xmllint or one of the test
- programs found in source in the distribution.</li>
- <li>Please send the command showing the error as well as the input (as an
- attachment)</li>
+href="mailto:xml@gnome.org">xml@gnome.org</a>for libxml, with an <a
+href="http://mail.gnome.org/archives/xml/">on-line archive</a>(<a
+href="http://xmlsoft.org/messages">old</a>). To subscribe to this list,please
+visit the <a href="http://mail.gnome.org/mailman/listinfo/xml">associated
+Web</a>page andfollow the instructions. <strong>Do not send code, I won't
+debug it</strong>(but patches are really appreciated!).</p>
+
+<p>Please note that with the current amount of virus and SPAM, sending mailto
+the list without being subscribed won't work. There is *far too manybounces*
+(in the order of a thousand a day !) I cannot approve them manuallyanymore.
+If your mail to the list bounced waiting for administrator approval,it is
+LOST ! Repost it and fix the problem triggering the error. Also pleasenote
+that <span style="color: #FF0000; background-color: #FFFFFF">emails witha
+legal warning asking to not copy or redistribute freely the informationsthey
+contain</span>are <strong>NOT</strong>acceptable for the mailing-list,such
+mail will as much as possible be discarded automatically, and are lesslikely
+to be answered if they made it to the list, <strong>DO NOT</strong>post to
+the list from an email address where such legal requirements areautomatically
+added, get private paying support if you can't shareinformations.</p>
+
+<p>Check the following <strong><span
+style="color: #FF0000">beforeposting</span></strong>:</p>
+<ul>
+ <li>Read the <a href="FAQ.html">FAQ</a>and <a href="search.php">use
+ thesearch engine</a>to get information related to your problem.</li>
+ <li>Make sure you are <a href="ftp://xmlsoft.org/libxml2/">using a
+ recentversion</a>, and that the problem still shows up in a recent
+ version.</li>
+ <li>Check the <a
+ href="http://mail.gnome.org/archives/xml/">listarchives</a>to see if the
+ problem was reported already. In this casethere is probably a fix
+ available, similarly check the <a
+ href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">registeredopen
+ bugs</a>.</li>
+ <li>Make sure you can reproduce the bug with xmllint or one of the
+ testprograms found in source in the distribution.</li>
+ <li>Please send the command showing the error as well as the input (as
+ anattachment)</li>
</ul>
<p>Then send the bug with associated information to reproduce it to the <a
-href="mailto:xml@gnome.org">xml@gnome.org</a> list; if it's really libxml
-related I will approve it. Please do not send mail to me directly, it makes
-things really hard to track and in some cases I am not the best person to
-answer a given question, ask on the list.</p>
+href="mailto:xml@gnome.org">xml@gnome.org</a>list; if it's really
+libxmlrelated I will approve it. Please do not send mail to me directly, it
+makesthings really hard to track and in some cases I am not the best person
+toanswer a given question, ask on the list.</p>
<p>To <span style="color: #E50000">be really clear about support</span>:</p>
<ul>
- <li>Support or help <span style="color: #E50000">requests MUST be sent to
- the list or on bugzilla</span> in case of problems, so that the Question
- and Answers can be shared publicly. Failing to do so carries the implicit
- message "I want free support but I don't want to share the benefits with
- others" and is not welcome. I will automatically Carbon-Copy the
- xml@gnome.org mailing list for any technical reply made about libxml2 or
- libxslt.</li>
- <li>There is <span style="color: #E50000">no garantee of support</span>, if
- your question remains unanswered after a week, repost it, making sure you
- gave all the detail needed and the information requested.</li>
- <li>Failing to provide information as requested or double checking first
- for prior feedback also carries the implicit message "the time of the
- library maintainers is less valuable than my time" and might not be
- welcome.</li>
-</ul>
-
-<p>Of course, bugs reported with a suggested patch for fixing them will
-probably be processed faster than those without.</p>
+ <li>Support or help <span style="color: #E50000">requests MUST be sent
+ tothe list or on bugzilla</span>in case of problems, so that the
+ Questionand Answers can be shared publicly. Failing to do so carries the
+ implicitmessage "I want free support but I don't want to share the
+ benefits withothers" and is not welcome. I will automatically Carbon-Copy
+ thexml@gnome.org mailing list for any technical reply made about libxml2
+ orlibxslt.</li>
+ <li>There is <span style="color: #E50000">no garantee of support</span>,
+ ifyour question remains unanswered after a week, repost it, making sure
+ yougave all the detail needed and the information requested.</li>
+ <li>Failing to provide information as requested or double checking firstfor
+ prior feedback also carries the implicit message "the time of thelibrary
+ maintainers is less valuable than my time" and might not bewelcome.</li>
+</ul>
+
+<p>Of course, bugs reported with a suggested patch for fixing them
+willprobably be processed faster than those without.</p>
<p>If you're looking for help, a quick look at <a
-href="http://mail.gnome.org/archives/xml/">the list archive</a> may actually
-provide the answer. I usually send source samples when answering libxml2
-usage questions. The <a
-href="http://xmlsoft.org/html/book1.html">auto-generated documentation</a> is
-not as polished as I would like (i need to learn more about DocBook), but
-it's a good starting point.</p>
+href="http://mail.gnome.org/archives/xml/">the list archive</a>may
+actuallyprovide the answer. I usually send source samples when answering
+libxml2usage questions. The <a
+href="http://xmlsoft.org/html/book1.html">auto-generated
+documentation</a>isnot as polished as I would like (i need to learn more
+about DocBook), butit's a good starting point.</p>
<h2><a name="help">How to help</a></h2>
-<p>You can help the project in various ways, the best thing to do first is to
-subscribe to the mailing-list as explained before, check the <a
+<p>You can help the project in various ways, the best thing to do first is
+tosubscribe to the mailing-list as explained before, check the <a
href="http://mail.gnome.org/archives/xml/">archives </a>and the <a
-href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Gnome bug
-database</a>:</p>
+href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Gnome
+bugdatabase</a>:</p>
<ol>
<li>Provide patches when you find problems.</li>
- <li>Provide the diffs when you port libxml2 to a new platform. They may not
- be integrated in all cases but help pinpointing portability problems
- and</li>
- <li>Provide documentation fixes (either as patches to the code comments or
- as HTML diffs).</li>
- <li>Provide new documentations pieces (translations, examples, etc
- ...).</li>
+ <li>Provide the diffs when you port libxml2 to a new platform. They may
+ notbe integrated in all cases but help pinpointing portability
+ problemsand</li>
+ <li>Provide documentation fixes (either as patches to the code comments
+ oras HTML diffs).</li>
+ <li>Provide new documentations pieces (translations, examples, etc...).</li>
<li>Check the TODO file and try to close one of the items.</li>
- <li>Take one of the points raised in the archive or the bug database and
- provide a fix. <a href="mailto:daniel@veillard.com">Get in touch with me
- </a>before to avoid synchronization problems and check that the suggested
- fix will fit in nicely :-)</li>
+ <li>Take one of the points raised in the archive or the bug database
+ andprovide a fix. <a href="mailto:daniel@veillard.com">Get in touch with
+ me</a>before to avoid synchronization problems and check that the
+ suggestedfix will fit in nicely :-)</li>
</ol>
<h2><a name="Downloads">Downloads</a></h2>
<p>The latest versions of libxml2 can be found on the <a
-href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a> server ( <a
+href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a>server ( <a
href="http://xmlsoft.org/sources/">HTTP</a>, <a
-href="ftp://xmlsoft.org/libxml2/">FTP</a> and rsync are available), there is also
-mirrors (<a href="ftp://ftp.planetmirror.com/pub/xmlsoft/">Australia</a>( <a
-href="http://xmlsoft.planetmirror.com/">Web</a>), <a
+href="ftp://xmlsoft.org/libxml2/">FTP</a>and rsync are available), there is
+alsomirrors (<a href="ftp://ftp.planetmirror.com/pub/xmlsoft/">Australia</a>(
+<a href="http://xmlsoft.planetmirror.com/">Web</a>), <a
href="ftp://fr.rpmfind.net/pub/libxml/">France</a>) or on the <a
-href="ftp://ftp.gnome.org/pub/GNOME/MIRRORS.html">Gnome FTP server</a> as <a
-href="ftp://ftp.gnome.org/pub/GNOME/sources/libxml2/2.6/">source archive</a>
-, Antonin Sprinzl also provide <a href="ftp://gd.tuwien.ac.at/pub/libxml/">a
-mirror in Austria</a>. (NOTE that you need both the <a
-href="http://rpmfind.net/linux/RPM/libxml2.html">libxml(2)</a> and <a
-href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml(2)-devel</a>
-packages installed to compile applications using libxml.)</p>
+href="ftp://ftp.gnome.org/pub/GNOME/MIRRORS.html">Gnome FTP server</a>as <a
+href="ftp://ftp.gnome.org/pub/GNOME/sources/libxml2/2.6/">source archive</a>,
+Antonin Sprinzl also provide <a
+href="ftp://gd.tuwien.ac.at/pub/libxml/">amirror in Austria</a>. (NOTE that
+you need both the <a
+href="http://rpmfind.net/linux/RPM/libxml2.html">libxml(2)</a>and <a
+href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml(2)-devel</a>packages
+installed to compile applications using libxml.)</p>
<p>You can find all the history of libxml(2) and libxslt releases in the <a
-href="http://xmlsoft.org/sources/old/">old</a> directory. The precompiled
-Windows binaries made by Igor Zlatovic are available in the <a
-href="http://xmlsoft.org/sources/win32/">win32</a> directory.</p>
+href="http://xmlsoft.org/sources/old/">old</a>directory. The
+precompiledWindows binaries made by Igor Zlatovic are available in the <a
+href="http://xmlsoft.org/sources/win32/">win32</a>directory.</p>
<p>Binary ports:</p>
<ul>
<li>Red Hat RPMs for i386 are available directly on <a
- href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a>, the source RPM will compile on
- any architecture supported by Red Hat.</li>
- <li><a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a> is now the
- maintainer of the Windows port, <a
- href="http://www.zlatkovic.com/projects/libxml/index.html">he provides
- binaries</a>.</li>
+ href="ftp://xmlsoft.org/libxml2/">xmlsoft.org</a>, the source RPM will
+ compile onany architecture supported by Red Hat.</li>
+ <li><a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a>is now
+ themaintainer of the Windows port, <a
+ href="http://www.zlatkovic.com/projects/libxml/index.html">he
+ providesbinaries</a>.</li>
<li>Blastwave provides <a
- href="http://www.blastwave.org/packages.php/libxml2">Solaris
- binaries</a>.</li>
- <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a> provides <a
- href="http://www.explain.com.au/oss/libxml2xslt.html">Mac Os X
- binaries</a>.</li>
+ href="http://www.blastwave.org/packages.php/libxml2">Solarisbinaries</a>.</li>
+ <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a>provides <a
+ href="http://www.explain.com.au/oss/libxml2xslt.html">Mac Os
+ Xbinaries</a>.</li>
<li>The HP-UX porting center provides <a
href="http://hpux.connect.org.uk/hppd/hpux/Gnome/">HP-UX binaries</a></li>
<li>Bull provides precompiled <a
- href="http://gnome.bullfreeware.com/new_index.html">RPMs for AIX</a> as
- patr of their GNOME packages</li>
+ href="http://gnome.bullfreeware.com/new_index.html">RPMs for
+ AIX</a>aspatr of their GNOME packages</li>
</ul>
<p>If you know other supported binary ports, please <a
@@ -704,474 +699,491 @@ href="http://veillard.com/">contact me</a>.</p>
<p><a name="Contribs">Contributions:</a></p>
-<p>I do accept external contributions, especially if compiling on another
-platform, get in touch with the list to upload the package, wrappers for
-various languages have been provided, and can be found in the <a
+<p>I do accept external contributions, especially if compiling on
+anotherplatform, get in touch with the list to upload the package, wrappers
+forvarious languages have been provided, and can be found in the <a
href="python.html">bindings section</a></p>
<p>Libxml2 is also available from CVS:</p>
<ul>
- <li><p>The <a href="http://cvs.gnome.org/viewcvs/libxml2/">Gnome CVS
- base</a>. Check the <a
- href="http://developer.gnome.org/tools/cvs.html">Gnome CVS Tools</a>
- page; the CVS module is <b>libxml2</b>.</p>
+ <li><p>The <a href="http://cvs.gnome.org/viewcvs/libxml2/">Gnome
+ CVSbase</a>. Check the <a
+ href="http://developer.gnome.org/tools/cvs.html">Gnome CVS Tools</a>page;
+ the CVS module is <b>libxml2</b>.</p>
</li>
- <li>The <strong>libxslt</strong> module is also present there</li>
+ <li>The <strong>libxslt</strong>module is also present there</li>
</ul>
<h2><a name="News">Releases</a></h2>
-<p>Items not finished and worked on, get in touch with the list if you want
-to help those</p>
+<p>Items not finished and worked on, get in touch with the list if you wantto
+help those</p>
<ul>
<li>More testing on RelaxNG</li>
- <li>Finishing up <a href="http://www.w3.org/TR/xmlschema-1/">XML
- Schemas</a></li>
+ <li>Finishing up <a
+ href="http://www.w3.org/TR/xmlschema-1/">XMLSchemas</a></li>
</ul>
-<p>The <a href="ChangeLog.html">change log</a> describes the recents commits
-to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
+<p>The <a href="ChangeLog.html">change log</a>describes the recents commitsto
+the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a>code base.</p>
<p>There is the list of public releases:</p>
+<h3>2.6.25: Jun 6 2006</h3>
+<ul>
+ <li>portability fixes: Python detection (Joseph Sacco), compilation error
+ (William Brack and Graham Bennett), LynxOS patch (Olli Savia)</li>
+ <li>bug fixes: encoding buffer problem, mix of code and data in xmlIO.c
+ (Kjartan Maraas), entities in XSD validation (Kasimier Buchcik), various
+ XSD validation fixes (Kasimier), memory leak in pattern (Rob Richards and
+ Kasimier), attribute with colon in name (Rob Richards), XPath leak in
+ error reporting (Aleksey Sanin), XInclude text include of self
+ document.</li>
+ <li>improvements: Xpath optimizations (Kasimier), XPath object cache
+ (Kasimier), </li>
+</ul>
+
<h3>2.6.24: Apr 28 2006</h3>
<ul>
- <li>Portability fixes: configure on Windows, testapi compile on windows
- (Kasimier Buchcik, venkat naidu), Borland C++ 6 compile (Eric Zurcher),
- HP-UX compiler workaround (Rick Jones), xml2-config bugfix, gcc-4.1
- cleanups, Python detection scheme (Joseph Sacco), UTF-8 file paths on
- Windows (Roland Schwingel).
- </li>
- <li>Improvements: xmlDOMWrapReconcileNamespaces xmlDOMWrapCloneNode (Kasimier
- Buchcik), XML catalog debugging (Rick Jones), update to Unicode 4.01.</li>
- <li>Bug fixes: xmlParseChunk() problem in 2.6.23, xmlParseInNodeContext()
- on HTML docs, URI behaviour on Windows (Rob Richards), comment streaming
- bug, xmlParseComment (with William Brack), regexp bug fixes (DV &amp;
- Youri Golovanov), xmlGetNodePath on text/CDATA (Kasimier),
- one Relax-NG interleave bug, xmllint --path and --valid,
- XSD bugfixes (Kasimier), remove debug
- left in Python bindings (Nic Ferrier), xmlCatalogAdd bug (Martin Cole),
- xmlSetProp fixes (Rob Richards), HTML IDness (Rob Richards), a large
- number of cleanups and small fixes based on Coverity reports, bug
- in character ranges, Unicode tables const (Aivars Kalvans), schemas
- fix (Stefan Kost), xmlRelaxNGParse error deallocation,
- xmlSchemaAddSchemaDoc error deallocation, error handling on unallowed
- code point, ixmllint --nonet to never reach the net (Gary Coady),
- line break in writer after end PI (Jason Viers). </li>
+ <li>Portability fixes: configure on Windows, testapi compile on
+ windows(Kasimier Buchcik, venkat naidu), Borland C++ 6 compile (Eric
+ Zurcher),HP-UX compiler workaround (Rick Jones), xml2-config bugfix,
+ gcc-4.1cleanups, Python detection scheme (Joseph Sacco), UTF-8 file paths
+ onWindows (Roland Schwingel).</li>
+ <li>Improvements: xmlDOMWrapReconcileNamespaces xmlDOMWrapCloneNode
+ (KasimierBuchcik), XML catalog debugging (Rick Jones), update to Unicode
+ 4.01.</li>
+ <li>Bug fixes: xmlParseChunk() problem in 2.6.23, xmlParseInNodeContext()on
+ HTML docs, URI behaviour on Windows (Rob Richards), comment streamingbug,
+ xmlParseComment (with William Brack), regexp bug fixes (DV &amp;Youri
+ Golovanov), xmlGetNodePath on text/CDATA (Kasimier),one Relax-NG
+ interleave bug, xmllint --path and --valid,XSD bugfixes (Kasimier),
+ remove debugleft in Python bindings (Nic Ferrier), xmlCatalogAdd bug
+ (Martin Cole),xmlSetProp fixes (Rob Richards), HTML IDness (Rob
+ Richards), a largenumber of cleanups and small fixes based on Coverity
+ reports, bugin character ranges, Unicode tables const (Aivars Kalvans),
+ schemasfix (Stefan Kost), xmlRelaxNGParse error
+ deallocation,xmlSchemaAddSchemaDoc error deallocation, error handling on
+ unallowedcode point, ixmllint --nonet to never reach the net (Gary
+ Coady),line break in writer after end PI (Jason Viers).</li>
<li>Documentation: man pages updates and cleanups (Daniel Leidert).</li>
<li>New features: Relax NG structure error handlers.</li>
</ul>
<h3>2.6.23: Jan 5 2006</h3>
<ul>
- <li>portability fixes: Windows (Rob Richards), getaddrinfo on Windows
- (Kolja Nowak, Rob Richards), icc warnings (Kjartan Maraas),
- --with-minimum compilation fixes (William Brack), error case handling fix
- on Solaris (Albert Chin), don't use 'list' as parameter name reported by
- Samuel Diaz Garcia, more old Unices portability fixes (Albert Chin),
- MinGW compilation (Mark Junker), HP-UX compiler warnings (Rick
- Jones),</li>
- <li>code cleanup: xmlReportError (Adrian Mouat), remove xmlBufferClose
- (Geert Jansen), unreachable code (Oleksandr Kononenko), refactoring
- parsing code (Bjorn Reese)</li>
- <li>bug fixes: xmlBuildRelativeURI and empty path (William Brack),
- combinatory explosion and performances in regexp code, leak in
- xmlTextReaderReadString(), xmlStringLenDecodeEntities problem (Massimo
- Morara), Identity Constraints bugs and a segfault (Kasimier Buchcik),
- XPath pattern based evaluation bugs (DV &amp; Kasimier),
- xmlSchemaContentModelDump() memory leak (Kasimier), potential leak in
- xmlSchemaCheckCSelectorXPath(), xmlTextWriterVSprintf() misuse of
- vsnprintf (William Brack), XHTML serialization fix (Rob Richards), CRLF
- split problem (William), issues with non-namespaced attributes in
- xmlAddChild() xmlAddNextSibling() and xmlAddPrevSibling() (Rob Richards),
- HTML parsing of script, Python must not output to stdout (Nic Ferrier),
- exclusive C14N namespace visibility (Aleksey Sanin), XSD dataype
- totalDigits bug (Kasimier Buchcik), error handling when writing to an
- xmlBuffer (Rob Richards), runtest schemas error not reported (Hisashi
- Fujinaka), signed/unsigned problem in date/time code (Albert Chin), fix
- XSI driven XSD validation (Kasimier), parsing of xs:decimal (Kasimier),
- fix DTD writer output (Rob Richards), leak in xmlTextReaderReadInnerXml
- (Gary Coady), regexp bug affecting schemas (Kasimier), configuration of
- runtime debugging (Kasimier), xmlNodeBufGetContent bug on entity refs
- (Oleksandr Kononenko), xmlRegExecPushString2 bug (Sreeni Nair),
- compilation and build fixes (Michael Day), removed dependancies on
- xmlSchemaValidError (Kasimier), bug with &lt;xml:foo/&gt;, more XPath
- pattern based evaluation fixes (Kasimier)</li>
- <li>improvements: XSD Schemas redefinitions/restrictions (Kasimier
- Buchcik), node copy checks and fix for attribute (Rob Richards), counted
- transition bug in regexps, ctxt-&gt;standalone = -2 to indicate no
- standalone attribute was found, add xmlSchemaSetParserStructuredErrors()
- (Kasimier Buchcik), add xmlTextReaderSchemaValidateCtxt() to API
- (Kasimier), handle gzipped HTTP resources (Gary Coady), add
- htmlDocDumpMemoryFormat. (Rob Richards),</li>
- <li>documentation: typo (Michael Day), libxml man page (Albert Chin), save
- function to XML buffer (Geert Jansen), small doc fix (Aron Stansvik),</li>
+ <li>portability fixes: Windows (Rob Richards), getaddrinfo on Windows(Kolja
+ Nowak, Rob Richards), icc warnings (Kjartan Maraas),--with-minimum
+ compilation fixes (William Brack), error case handling fixon Solaris
+ (Albert Chin), don't use 'list' as parameter name reported bySamuel Diaz
+ Garcia, more old Unices portability fixes (Albert Chin),MinGW compilation
+ (Mark Junker), HP-UX compiler warnings (RickJones),</li>
+ <li>code cleanup: xmlReportError (Adrian Mouat), remove
+ xmlBufferClose(Geert Jansen), unreachable code (Oleksandr Kononenko),
+ refactoringparsing code (Bjorn Reese)</li>
+ <li>bug fixes: xmlBuildRelativeURI and empty path (William
+ Brack),combinatory explosion and performances in regexp code, leak
+ inxmlTextReaderReadString(), xmlStringLenDecodeEntities problem
+ (MassimoMorara), Identity Constraints bugs and a segfault (Kasimier
+ Buchcik),XPath pattern based evaluation bugs (DV &amp;
+ Kasimier),xmlSchemaContentModelDump() memory leak (Kasimier), potential
+ leak inxmlSchemaCheckCSelectorXPath(), xmlTextWriterVSprintf() misuse
+ ofvsnprintf (William Brack), XHTML serialization fix (Rob Richards),
+ CRLFsplit problem (William), issues with non-namespaced attributes
+ inxmlAddChild() xmlAddNextSibling() and xmlAddPrevSibling() (Rob
+ Richards),HTML parsing of script, Python must not output to stdout (Nic
+ Ferrier),exclusive C14N namespace visibility (Aleksey Sanin), XSD
+ dataypetotalDigits bug (Kasimier Buchcik), error handling when writing to
+ anxmlBuffer (Rob Richards), runtest schemas error not reported
+ (HisashiFujinaka), signed/unsigned problem in date/time code (Albert
+ Chin), fixXSI driven XSD validation (Kasimier), parsing of xs:decimal
+ (Kasimier),fix DTD writer output (Rob Richards), leak in
+ xmlTextReaderReadInnerXml(Gary Coady), regexp bug affecting schemas
+ (Kasimier), configuration ofruntime debugging (Kasimier),
+ xmlNodeBufGetContent bug on entity refs(Oleksandr Kononenko),
+ xmlRegExecPushString2 bug (Sreeni Nair),compilation and build fixes
+ (Michael Day), removed dependancies onxmlSchemaValidError (Kasimier), bug
+ with &lt;xml:foo/&gt;, more XPathpattern based evaluation fixes
+ (Kasimier)</li>
+ <li>improvements: XSD Schemas redefinitions/restrictions (KasimierBuchcik),
+ node copy checks and fix for attribute (Rob Richards), countedtransition
+ bug in regexps, ctxt-&gt;standalone = -2 to indicate nostandalone
+ attribute was found, add xmlSchemaSetParserStructuredErrors()(Kasimier
+ Buchcik), add xmlTextReaderSchemaValidateCtxt() to API(Kasimier), handle
+ gzipped HTTP resources (Gary Coady), addhtmlDocDumpMemoryFormat. (Rob
+ Richards),</li>
+ <li>documentation: typo (Michael Day), libxml man page (Albert Chin),
+ savefunction to XML buffer (Geert Jansen), small doc fix (Aron
+ Stansvik),</li>
</ul>
<h3>2.6.22: Sep 12 2005</h3>
<ul>
<li>build fixes: compile without schematron (Stéphane Bidoul)</li>
- <li>bug fixes: xmlDebugDumpNode on namespace node (Oleg Paraschenko)i,
- CDATA push parser bug, xmlElemDump problem with XHTML1 doc,
- XML_FEATURE_xxx clash with expat headers renamed XML_WITH_xxx, fix some
- output formatting for meta element (Rob Richards), script and style
- XHTML1 serialization (David Madore), Attribute derivation fixups in XSD
- (Kasimier Buchcik), better IDC error reports (Kasimier Buchcik)</li>
- <li>improvements: add XML_SAVE_NO_EMPTY xmlSaveOption (Rob Richards), add
- XML_SAVE_NO_XHTML xmlSaveOption, XML Schemas improvements preparing for
- derive (Kasimier Buchcik).</li>
- <li>documentation: generation of gtk-doc like docs, integration with
- devhelp.</li>
+ <li>bug fixes: xmlDebugDumpNode on namespace node (Oleg Paraschenko)i,CDATA
+ push parser bug, xmlElemDump problem with XHTML1 doc,XML_FEATURE_xxx
+ clash with expat headers renamed XML_WITH_xxx, fix someoutput formatting
+ for meta element (Rob Richards), script and styleXHTML1 serialization
+ (David Madore), Attribute derivation fixups in XSD(Kasimier Buchcik),
+ better IDC error reports (Kasimier Buchcik)</li>
+ <li>improvements: add XML_SAVE_NO_EMPTY xmlSaveOption (Rob Richards),
+ addXML_SAVE_NO_XHTML xmlSaveOption, XML Schemas improvements preparing
+ forderive (Kasimier Buchcik).</li>
+ <li>documentation: generation of gtk-doc like docs, integration
+ withdevhelp.</li>
</ul>
<h3>2.6.21: Sep 4 2005</h3>
<ul>
- <li>build fixes: Cygwin portability fixes (Gerrit P. Haase), calling
- convention problems on Windows (Marcus Boerger), cleanups based on Linus'
- sparse tool, update of win32/configure.js (Rob Richards), remove warnings
- on Windows(Marcus Boerger), compilation without SAX1, detection of the
- Python binary, use $GCC inestad of $CC = 'gcc' (Andrew W. Nosenko),
- compilation/link with threads and old gcc, compile problem by C370 on
- Z/OS,</li>
- <li>bug fixes: http_proxy environments (Peter Breitenlohner), HTML UTF-8
- bug (Jiri Netolicky), XPath NaN compare bug (William Brack),
- htmlParseScript potential bug, Schemas regexp handling of spaces, Base64
- Schemas comparisons NIST passes, automata build error xsd:all,
- xmlGetNodePath for namespaced attributes (Alexander Pohoyda), xmlSchemas
- foreign namespaces handling, XML Schemas facet comparison (Kupriyanov
- Anatolij), xmlSchemaPSimpleTypeErr error report (Kasimier Buchcik), xml:
- namespace ahndling in Schemas (Kasimier), empty model group in Schemas
- (Kasimier), wilcard in Schemas (Kasimier), URI composition (William),
- xs:anyType in Schemas (Kasimier), Python resolver emmitting error
- messages directly, Python xmlAttr.parent (Jakub Piotr Clapa), trying to
- fix the file path/URI conversion, xmlTextReaderGetAttribute fix (Rob
- Richards), xmlSchemaFreeAnnot memleak (Kasimier), HTML UTF-8
- serialization, streaming XPath, Schemas determinism detection problem,
- XInclude bug, Schemas context type (Dean Hill), validation fix (Derek
- Poon), xmlTextReaderGetAttribute[Ns] namespaces (Rob Richards), Schemas
- type fix (Kuba Nowakowski), UTF-8 parser bug, error in encoding handling,
- xmlGetLineNo fixes, bug on entities handling, entity name extraction in
- error handling with XInclude, text nodes in HTML body tags (Gary Coady),
- xml:id and IDness at the treee level fixes, XPath streaming patterns
- bugs.</li>
- <li>improvements: structured interfaces for schemas and RNG error reports
- (Marcus Boerger), optimization of the char data inner loop parsing
- (thanks to Behdad Esfahbod for the idea), schematron validation though
- not finished yet, xmlSaveOption to omit XML declaration, keyref match
- error reports (Kasimier), formal expression handling code not plugged
- yet, more lax mode for the HTML parser, parser XML_PARSE_COMPACT option
- for text nodes allocation.</li>
+ <li>build fixes: Cygwin portability fixes (Gerrit P. Haase),
+ callingconvention problems on Windows (Marcus Boerger), cleanups based on
+ Linus'sparse tool, update of win32/configure.js (Rob Richards), remove
+ warningson Windows(Marcus Boerger), compilation without SAX1, detection
+ of thePython binary, use $GCC inestad of $CC = 'gcc' (Andrew W.
+ Nosenko),compilation/link with threads and old gcc, compile problem by
+ C370 onZ/OS,</li>
+ <li>bug fixes: http_proxy environments (Peter Breitenlohner), HTML UTF-8bug
+ (Jiri Netolicky), XPath NaN compare bug (William Brack),htmlParseScript
+ potential bug, Schemas regexp handling of spaces, Base64Schemas
+ comparisons NIST passes, automata build error xsd:all,xmlGetNodePath for
+ namespaced attributes (Alexander Pohoyda), xmlSchemasforeign namespaces
+ handling, XML Schemas facet comparison (KupriyanovAnatolij),
+ xmlSchemaPSimpleTypeErr error report (Kasimier Buchcik), xml:namespace
+ ahndling in Schemas (Kasimier), empty model group in Schemas(Kasimier),
+ wilcard in Schemas (Kasimier), URI composition (William),xs:anyType in
+ Schemas (Kasimier), Python resolver emmitting errormessages directly,
+ Python xmlAttr.parent (Jakub Piotr Clapa), trying tofix the file path/URI
+ conversion, xmlTextReaderGetAttribute fix (RobRichards),
+ xmlSchemaFreeAnnot memleak (Kasimier), HTML UTF-8serialization, streaming
+ XPath, Schemas determinism detection problem,XInclude bug, Schemas
+ context type (Dean Hill), validation fix (DerekPoon),
+ xmlTextReaderGetAttribute[Ns] namespaces (Rob Richards), Schemastype fix
+ (Kuba Nowakowski), UTF-8 parser bug, error in encoding
+ handling,xmlGetLineNo fixes, bug on entities handling, entity name
+ extraction inerror handling with XInclude, text nodes in HTML body tags
+ (Gary Coady),xml:id and IDness at the treee level fixes, XPath streaming
+ patternsbugs.</li>
+ <li>improvements: structured interfaces for schemas and RNG error
+ reports(Marcus Boerger), optimization of the char data inner loop
+ parsing(thanks to Behdad Esfahbod for the idea), schematron validation
+ thoughnot finished yet, xmlSaveOption to omit XML declaration, keyref
+ matcherror reports (Kasimier), formal expression handling code not
+ pluggedyet, more lax mode for the HTML parser, parser XML_PARSE_COMPACT
+ optionfor text nodes allocation.</li>
<li>documentation: xmllint man page had --nonet duplicated</li>
</ul>
<h3>2.6.20: Jul 10 2005</h3>
<ul>
- <li>build fixes: Windows build (Rob Richards), Mingw compilation (Igor
- Zlatkovic), Windows Makefile (Igor), gcc warnings (Kasimier and
- andriy@google.com), use gcc weak references to pthread to avoid the
- pthread dependancy on Linux, compilation problem (Steve Nairn), compiling
- of subset (Morten Welinder), IPv6/ss_family compilation (William Brack),
- compilation when disabling parts of the library, standalone test
- distribution.</li>
- <li>bug fixes: bug in lang(), memory cleanup on errors (William Brack),
- HTTP query strings (Aron Stansvik), memory leak in DTD (William), integer
- overflow in XPath (William), nanoftp buffer size, pattern "." apth fixup
- (Kasimier), leak in tree reported by Malcolm Rowe, replaceNode patch
- (Brent Hendricks), CDATA with NULL content (Mark Vakoc), xml:base fixup
- on XInclude (William), pattern fixes (William), attribute bug in
- exclusive c14n (Aleksey Sanin), xml:space and xml:lang with SAX2 (Rob
- Richards), namespace trouble in complex parsing (Malcolm Rowe), XSD type
- QNames fixes (Kasimier), XPath streaming fixups (William), RelaxNG bug
- (Rob Richards), Schemas for Schemas fixes (Kasimier), removal of ID (Rob
- Richards), a small RelaxNG leak, HTML parsing in push mode bug (James
- Bursa), failure to detect UTF-8 parsing bugs in CDATA sections,
- areBlanks() heuristic failure, duplicate attributes in DTD bug
- (William).</li>
- <li>improvements: lot of work on Schemas by Kasimier Buchcik both on
- conformance and streaming, Schemas validation messages (Kasimier Buchcik,
- Matthew Burgess), namespace removal at the python level (Brent
- Hendricks), Update to new Schemas regression tests from W3C/Nist
- (Kasimier), xmlSchemaValidateFile() (Kasimier), implementation of
- xmlTextReaderReadInnerXml and xmlTextReaderReadOuterXml (James Wert),
- standalone test framework and programs, new DOM import APIs
- xmlDOMWrapReconcileNamespaces() xmlDOMWrapAdoptNode() and
- xmlDOMWrapRemoveNode(), extension of xmllint capabilities for SAX and
- Schemas regression tests, xmlStopParser() available in pull mode too,
- ienhancement to xmllint --shell namespaces support, Windows port of the
- standalone testing tools (Kasimier and William),
- xmlSchemaValidateStream() xmlSchemaSAXPlug() and xmlSchemaSAXUnplug() SAX
- Schemas APIs, Schemas xmlReader support.</li>
+ <li>build fixes: Windows build (Rob Richards), Mingw compilation
+ (IgorZlatkovic), Windows Makefile (Igor), gcc warnings (Kasimier
+ andandriy@google.com), use gcc weak references to pthread to avoid
+ thepthread dependancy on Linux, compilation problem (Steve Nairn),
+ compilingof subset (Morten Welinder), IPv6/ss_family compilation (William
+ Brack),compilation when disabling parts of the library, standalone
+ testdistribution.</li>
+ <li>bug fixes: bug in lang(), memory cleanup on errors (William Brack),HTTP
+ query strings (Aron Stansvik), memory leak in DTD (William),
+ integeroverflow in XPath (William), nanoftp buffer size, pattern "." apth
+ fixup(Kasimier), leak in tree reported by Malcolm Rowe, replaceNode
+ patch(Brent Hendricks), CDATA with NULL content (Mark Vakoc), xml:base
+ fixupon XInclude (William), pattern fixes (William), attribute bug
+ inexclusive c14n (Aleksey Sanin), xml:space and xml:lang with SAX2
+ (RobRichards), namespace trouble in complex parsing (Malcolm Rowe), XSD
+ typeQNames fixes (Kasimier), XPath streaming fixups (William), RelaxNG
+ bug(Rob Richards), Schemas for Schemas fixes (Kasimier), removal of ID
+ (RobRichards), a small RelaxNG leak, HTML parsing in push mode bug
+ (JamesBursa), failure to detect UTF-8 parsing bugs in CDATA
+ sections,areBlanks() heuristic failure, duplicate attributes in DTD
+ bug(William).</li>
+ <li>improvements: lot of work on Schemas by Kasimier Buchcik both
+ onconformance and streaming, Schemas validation messages (Kasimier
+ Buchcik,Matthew Burgess), namespace removal at the python level
+ (BrentHendricks), Update to new Schemas regression tests from
+ W3C/Nist(Kasimier), xmlSchemaValidateFile() (Kasimier), implementation
+ ofxmlTextReaderReadInnerXml and xmlTextReaderReadOuterXml (James
+ Wert),standalone test framework and programs, new DOM import
+ APIsxmlDOMWrapReconcileNamespaces() xmlDOMWrapAdoptNode()
+ andxmlDOMWrapRemoveNode(), extension of xmllint capabilities for SAX
+ andSchemas regression tests, xmlStopParser() available in pull mode
+ too,ienhancement to xmllint --shell namespaces support, Windows port of
+ thestandalone testing tools (Kasimier and
+ William),xmlSchemaValidateStream() xmlSchemaSAXPlug() and
+ xmlSchemaSAXUnplug() SAXSchemas APIs, Schemas xmlReader support.</li>
</ul>
<h3>2.6.19: Apr 02 2005</h3>
<ul>
- <li>build fixes: drop .la from RPMs, --with-minimum build fix (William
- Brack), use XML_SOCKLEN_T instead of SOCKLEN_T because it breaks with AIX
- 5.3 compiler, fixed elfgcchack.h generation and PLT reduction code on
- Linux/ELF/gcc4</li>
- <li>bug fixes: schemas type decimal fixups (William Brack), xmmlint return
- code (Gerry Murphy), small schemas fixes (Matthew Burgess and GUY
- Fabrice), workaround "DAV:" namespace brokeness in c14n (Aleksey Sanin),
- segfault in Schemas (Kasimier Buchcik), Schemas attribute validation
- (Kasimier), Prop related functions and xmlNewNodeEatName (Rob Richards),
- HTML serialization of name attribute on a elements, Python error handlers
- leaks and improvement (Brent Hendricks), uninitialized variable in
- encoding code, Relax-NG validation bug, potential crash if
- gnorableWhitespace is NULL, xmlSAXParseDoc and xmlParseDoc signatures,
- switched back to assuming UTF-8 in case no encoding is given at
- serialization time</li>
- <li>improvements: lot of work on Schemas by Kasimier Buchcik on facets
- checking and also mixed handling.</li>
+ <li>build fixes: drop .la from RPMs, --with-minimum build fix
+ (WilliamBrack), use XML_SOCKLEN_T instead of SOCKLEN_T because it breaks
+ with AIX5.3 compiler, fixed elfgcchack.h generation and PLT reduction
+ code onLinux/ELF/gcc4</li>
+ <li>bug fixes: schemas type decimal fixups (William Brack), xmmlint
+ returncode (Gerry Murphy), small schemas fixes (Matthew Burgess and
+ GUYFabrice), workaround "DAV:" namespace brokeness in c14n (Aleksey
+ Sanin),segfault in Schemas (Kasimier Buchcik), Schemas attribute
+ validation(Kasimier), Prop related functions and xmlNewNodeEatName (Rob
+ Richards),HTML serialization of name attribute on a elements, Python
+ error handlersleaks and improvement (Brent Hendricks), uninitialized
+ variable inencoding code, Relax-NG validation bug, potential crash
+ ifgnorableWhitespace is NULL, xmlSAXParseDoc and xmlParseDoc
+ signatures,switched back to assuming UTF-8 in case no encoding is given
+ atserialization time</li>
+ <li>improvements: lot of work on Schemas by Kasimier Buchcik on
+ facetschecking and also mixed handling.</li>
<li></li>
</ul>
<h3>2.6.18: Mar 13 2005</h3>
<ul>
- <li>build fixes: warnings (Peter Breitenlohner), testapi.c generation,
- Bakefile support (Francesco Montorsi), Windows compilation (Joel Reed),
- some gcc4 fixes, HP-UX portability fixes (Rick Jones).</li>
- <li>bug fixes: xmlSchemaElementDump namespace (Kasimier Buchcik), push and
- xmlreader stopping on non-fatal errors, thread support for dictionnaries
- reference counting (Gary Coady), internal subset and push problem, URL
- saved in xmlCopyDoc, various schemas bug fixes (Kasimier), Python paths
- fixup (Stephane Bidoul), xmlGetNodePath and namespaces, xmlSetNsProp fix
- (Mike Hommey), warning should not count as error (William Brack),
- xmlCreatePushParser empty chunk, XInclude parser flags (William), cleanup
- FTP and HTTP code to reuse the uri parsing and IPv6 (William),
- xmlTextWriterStartAttributeNS fix (Rob Richards), XMLLINT_INDENT being
- empty (William), xmlWriter bugs (Rob Richards), multithreading on Windows
- (Rich Salz), xmlSearchNsByHref fix (Kasimier), Python binding leak (Brent
- Hendricks), aliasing bug exposed by gcc4 on s390, xmlTextReaderNext bug
- (Rob Richards), Schemas decimal type fixes (William Brack),
- xmlByteConsumed static buffer (Ben Maurer).</li>
- <li>improvement: speedup parsing comments and DTDs, dictionnary support for
- hash tables, Schemas Identity constraints (Kasimier), streaming XPath
- subset, xmlTextReaderReadString added (Bjorn Reese), Schemas canonical
- values handling (Kasimier), add xmlTextReaderByteConsumed (Aron
- Stansvik),</li>
+ <li>build fixes: warnings (Peter Breitenlohner), testapi.c
+ generation,Bakefile support (Francesco Montorsi), Windows compilation
+ (Joel Reed),some gcc4 fixes, HP-UX portability fixes (Rick Jones).</li>
+ <li>bug fixes: xmlSchemaElementDump namespace (Kasimier Buchcik), push
+ andxmlreader stopping on non-fatal errors, thread support for
+ dictionnariesreference counting (Gary Coady), internal subset and push
+ problem, URLsaved in xmlCopyDoc, various schemas bug fixes (Kasimier),
+ Python pathsfixup (Stephane Bidoul), xmlGetNodePath and namespaces,
+ xmlSetNsProp fix(Mike Hommey), warning should not count as error (William
+ Brack),xmlCreatePushParser empty chunk, XInclude parser flags (William),
+ cleanupFTP and HTTP code to reuse the uri parsing and IPv6
+ (William),xmlTextWriterStartAttributeNS fix (Rob Richards),
+ XMLLINT_INDENT beingempty (William), xmlWriter bugs (Rob Richards),
+ multithreading on Windows(Rich Salz), xmlSearchNsByHref fix (Kasimier),
+ Python binding leak (BrentHendricks), aliasing bug exposed by gcc4 on
+ s390, xmlTextReaderNext bug(Rob Richards), Schemas decimal type fixes
+ (William Brack),xmlByteConsumed static buffer (Ben Maurer).</li>
+ <li>improvement: speedup parsing comments and DTDs, dictionnary support
+ forhash tables, Schemas Identity constraints (Kasimier), streaming
+ XPathsubset, xmlTextReaderReadString added (Bjorn Reese), Schemas
+ canonicalvalues handling (Kasimier), add xmlTextReaderByteConsumed
+ (AronStansvik),</li>
<li>Documentation: Wiki support (Joel Reed)</li>
</ul>
<h3>2.6.17: Jan 16 2005</h3>
<ul>
- <li>build fixes: Windows, warnings removal (William Brack),
- maintainer-clean dependency(William), build in a different directory
- (William), fixing --with-minimum configure build (William), BeOS build
- (Marcin Konicki), Python-2.4 detection (William), compilation on AIX (Dan
- McNichol)</li>
- <li>bug fixes: xmlTextReaderHasAttributes (Rob Richards), xmlCtxtReadFile()
- to use the catalog(s), loop on output (William Brack), XPath memory leak,
- ID deallocation problem (Steve Shepard), debugDumpNode crash (William),
- warning not using error callback (William), xmlStopParser bug (William),
- UTF-16 with BOM on DTDs (William), namespace bug on empty elements in
- push mode (Rob Richards), line and col computations fixups (Aleksey
- Sanin), xmlURIEscape fix (William), xmlXPathErr on bad range (William),
- patterns with too many steps, bug in RNG choice optimization, line number
- sometimes missing.</li>
- <li>improvements: XSD Schemas (Kasimier Buchcik), python generator
- (William), xmlUTF8Strpos speedup (William), unicode Python strings
- (William), XSD error reports (Kasimier Buchcik), Python __str__ call
- serialize().</li>
- <li>new APIs: added xmlDictExists(), GetLineNumber and GetColumnNumber for
- the xmlReader (Aleksey Sanin), Dynamic Shared Libraries APIs (mostly Joel
- Reed), error extraction API from regexps, new XMLSave option for format
- (Phil Shafer)</li>
- <li>documentation: site improvement (John Fleck), FAQ entries
- (William).</li>
+ <li>build fixes: Windows, warnings removal (William Brack),maintainer-clean
+ dependency(William), build in a different directory(William), fixing
+ --with-minimum configure build (William), BeOS build(Marcin Konicki),
+ Python-2.4 detection (William), compilation on AIX (DanMcNichol)</li>
+ <li>bug fixes: xmlTextReaderHasAttributes (Rob Richards),
+ xmlCtxtReadFile()to use the catalog(s), loop on output (William Brack),
+ XPath memory leak,ID deallocation problem (Steve Shepard), debugDumpNode
+ crash (William),warning not using error callback (William), xmlStopParser
+ bug (William),UTF-16 with BOM on DTDs (William), namespace bug on empty
+ elements inpush mode (Rob Richards), line and col computations fixups
+ (AlekseySanin), xmlURIEscape fix (William), xmlXPathErr on bad range
+ (William),patterns with too many steps, bug in RNG choice optimization,
+ line numbersometimes missing.</li>
+ <li>improvements: XSD Schemas (Kasimier Buchcik), python
+ generator(William), xmlUTF8Strpos speedup (William), unicode Python
+ strings(William), XSD error reports (Kasimier Buchcik), Python __str__
+ callserialize().</li>
+ <li>new APIs: added xmlDictExists(), GetLineNumber and GetColumnNumber
+ forthe xmlReader (Aleksey Sanin), Dynamic Shared Libraries APIs (mostly
+ JoelReed), error extraction API from regexps, new XMLSave option for
+ format(Phil Shafer)</li>
+ <li>documentation: site improvement (John Fleck), FAQ entries(William).</li>
</ul>
<h3>2.6.16: Nov 10 2004</h3>
<ul>
- <li>general hardening and bug fixing crossing all the API based on new
- automated regression testing</li>
+ <li>general hardening and bug fixing crossing all the API based on
+ newautomated regression testing</li>
<li>build fix: IPv6 build and test on AIX (Dodji Seketeli)</li>
- <li>bug fixes: problem with XML::Libxml reported by Petr Pajas, encoding
- conversion functions return values, UTF-8 bug affecting XPath reported by
- Markus Bertheau, catalog problem with NULL entries (William Brack)</li>
- <li>documentation: fix to xmllint man page, some API function descritpion
- were updated.</li>
- <li>improvements: DTD validation APIs provided at the Python level (Brent
- Hendricks)</li>
+ <li>bug fixes: problem with XML::Libxml reported by Petr Pajas,
+ encodingconversion functions return values, UTF-8 bug affecting XPath
+ reported byMarkus Bertheau, catalog problem with NULL entries (William
+ Brack)</li>
+ <li>documentation: fix to xmllint man page, some API function
+ descritpionwere updated.</li>
+ <li>improvements: DTD validation APIs provided at the Python level
+ (BrentHendricks)</li>
</ul>
<h3>2.6.15: Oct 27 2004</h3>
<ul>
<li>security fixes on the nanoftp and nanohttp modules</li>
- <li>build fixes: xmllint detection bug in configure, building outside the
- source tree (Thomas Fitzsimmons)</li>
- <li>bug fixes: HTML parser on broken ASCII chars in names (William), Python
- paths (Malcolm Tredinnick), xmlHasNsProp and default namespace (William),
- saving to python file objects (Malcolm Tredinnick), DTD lookup fix
- (Malcolm), save back &lt;group&gt; in catalogs (William), tree build
- fixes (DV and Rob Richards), Schemas memory bug, structured error handler
- on Python 64bits, thread local memory deallocation, memory leak reported
- by Volker Roth, xmlValidateDtd in the presence of an internal subset,
- entities and _private problem (William), xmlBuildRelativeURI error
- (William).</li>
- <li>improvements: better XInclude error reports (William), tree debugging
- module and tests, convenience functions at the Reader API (Graham
- Bennett), add support for PI in the HTML parser.</li>
+ <li>build fixes: xmllint detection bug in configure, building outside
+ thesource tree (Thomas Fitzsimmons)</li>
+ <li>bug fixes: HTML parser on broken ASCII chars in names (William),
+ Pythonpaths (Malcolm Tredinnick), xmlHasNsProp and default namespace
+ (William),saving to python file objects (Malcolm Tredinnick), DTD lookup
+ fix(Malcolm), save back &lt;group&gt; in catalogs (William), tree
+ buildfixes (DV and Rob Richards), Schemas memory bug, structured error
+ handleron Python 64bits, thread local memory deallocation, memory leak
+ reportedby Volker Roth, xmlValidateDtd in the presence of an internal
+ subset,entities and _private problem (William), xmlBuildRelativeURI
+ error(William).</li>
+ <li>improvements: better XInclude error reports (William), tree
+ debuggingmodule and tests, convenience functions at the Reader API
+ (GrahamBennett), add support for PI in the HTML parser.</li>
</ul>
<h3>2.6.14: Sep 29 2004</h3>
<ul>
- <li>build fixes: configure paths for xmllint and xsltproc, compilation
- without HTML parser, compilation warning cleanups (William Brack &amp;
- Malcolm Tredinnick), VMS makefile update (Craig Berry),</li>
- <li>bug fixes: xmlGetUTF8Char (William Brack), QName properties (Kasimier
- Buchcik), XInclude testing, Notation serialization, UTF8ToISO8859x
- transcoding (Mark Itzcovitz), lots of XML Schemas cleanup and fixes
- (Kasimier), ChangeLog cleanup (Stepan Kasal), memory fixes (Mark Vakoc),
- handling of failed realloc(), out of bound array adressing in Schemas
- date handling, Python space/tabs cleanups (Malcolm Tredinnick), NMTOKENS
- E20 validation fix (Malcolm),</li>
- <li>improvements: added W3C XML Schemas testsuite (Kasimier Buchcik), add
- xmlSchemaValidateOneElement (Kasimier), Python exception hierearchy
- (Malcolm Tredinnick), Python libxml2 driver improvement (Malcolm
- Tredinnick), Schemas support for xsi:schemaLocation,
- xsi:noNamespaceSchemaLocation, xsi:type (Kasimier Buchcik)</li>
+ <li>build fixes: configure paths for xmllint and xsltproc,
+ compilationwithout HTML parser, compilation warning cleanups (William
+ Brack &amp;Malcolm Tredinnick), VMS makefile update (Craig Berry),</li>
+ <li>bug fixes: xmlGetUTF8Char (William Brack), QName properties
+ (KasimierBuchcik), XInclude testing, Notation serialization,
+ UTF8ToISO8859xtranscoding (Mark Itzcovitz), lots of XML Schemas cleanup
+ and fixes(Kasimier), ChangeLog cleanup (Stepan Kasal), memory fixes (Mark
+ Vakoc),handling of failed realloc(), out of bound array adressing in
+ Schemasdate handling, Python space/tabs cleanups (Malcolm Tredinnick),
+ NMTOKENSE20 validation fix (Malcolm),</li>
+ <li>improvements: added W3C XML Schemas testsuite (Kasimier Buchcik),
+ addxmlSchemaValidateOneElement (Kasimier), Python exception
+ hierearchy(Malcolm Tredinnick), Python libxml2 driver improvement
+ (MalcolmTredinnick), Schemas support for
+ xsi:schemaLocation,xsi:noNamespaceSchemaLocation, xsi:type (Kasimier
+ Buchcik)</li>
</ul>
<h3>2.6.13: Aug 31 2004</h3>
<ul>
- <li>build fixes: Windows and zlib (Igor Zlatkovic), -O flag with gcc,
- Solaris compiler warning, fixing RPM BuildRequires,</li>
- <li>fixes: DTD loading on Windows (Igor), Schemas error reports APIs
- (Kasimier Buchcik), Schemas validation crash, xmlCheckUTF8 (William Brack
- and Julius Mittenzwei), Schemas facet check (Kasimier), default namespace
- problem (William), Schemas hexbinary empty values, encoding error could
- genrate a serialization loop.</li>
- <li>Improvements: Schemas validity improvements (Kasimier), added --path
- and --load-trace options to xmllint</li>
+ <li>build fixes: Windows and zlib (Igor Zlatkovic), -O flag with
+ gcc,Solaris compiler warning, fixing RPM BuildRequires,</li>
+ <li>fixes: DTD loading on Windows (Igor), Schemas error reports
+ APIs(Kasimier Buchcik), Schemas validation crash, xmlCheckUTF8 (William
+ Brackand Julius Mittenzwei), Schemas facet check (Kasimier), default
+ namespaceproblem (William), Schemas hexbinary empty values, encoding
+ error couldgenrate a serialization loop.</li>
+ <li>Improvements: Schemas validity improvements (Kasimier), added --pathand
+ --load-trace options to xmllint</li>
<li>documentation: tutorial update (John Fleck)</li>
</ul>
<h3>2.6.12: Aug 22 2004</h3>
<ul>
- <li>build fixes: fix --with-minimum, elfgcchack.h fixes (Peter
- Breitenlohner), perl path lookup (William), diff on Solaris (Albert
- Chin), some 64bits cleanups.</li>
- <li>Python: avoid a warning with 2.3 (William Brack), tab and space mixes
- (William), wrapper generator fixes (William), Cygwin support (Gerrit P.
- Haase), node wrapper fix (Marc-Antoine Parent), XML Schemas support
- (Torkel Lyng)</li>
+ <li>build fixes: fix --with-minimum, elfgcchack.h fixes
+ (PeterBreitenlohner), perl path lookup (William), diff on Solaris
+ (AlbertChin), some 64bits cleanups.</li>
+ <li>Python: avoid a warning with 2.3 (William Brack), tab and space
+ mixes(William), wrapper generator fixes (William), Cygwin support (Gerrit
+ P.Haase), node wrapper fix (Marc-Antoine Parent), XML Schemas
+ support(Torkel Lyng)</li>
<li>Schemas: a lot of bug fixes and improvements from Kasimier Buchcik</li>
- <li>fixes: RVT fixes (William), XPath context resets bug (William), memory
- debug (Steve Hay), catalog white space handling (Peter Breitenlohner),
- xmlReader state after attribute reading (William), structured error
- handler (William), XInclude generated xml:base fixup (William), Windows
- memory reallocation problem (Steve Hay), Out of Memory conditions
- handling (William and Olivier Andrieu), htmlNewDoc() charset bug,
- htmlReadMemory init (William), a posteriori validation DTD base
- (William), notations serialization missing, xmlGetNodePath (Dodji),
- xmlCheckUTF8 (Diego Tartara), missing line numbers on entity
- (William)</li>
- <li>improvements: DocBook catalog build scrip (William), xmlcatalog tool
- (Albert Chin), xmllint --c14n option, no_proxy environment (Mike Hommey),
- xmlParseInNodeContext() addition, extend xmllint --shell, allow XInclude
- to not generate start/end nodes, extend xmllint --version to include CVS
- tag (William)</li>
- <li>documentation: web pages fixes, validity API docs fixes (William)
- schemas API fix (Eric Haszlakiewicz), xmllint man page (John Fleck)</li>
+ <li>fixes: RVT fixes (William), XPath context resets bug (William),
+ memorydebug (Steve Hay), catalog white space handling (Peter
+ Breitenlohner),xmlReader state after attribute reading (William),
+ structured errorhandler (William), XInclude generated xml:base fixup
+ (William), Windowsmemory reallocation problem (Steve Hay), Out of Memory
+ conditionshandling (William and Olivier Andrieu), htmlNewDoc() charset
+ bug,htmlReadMemory init (William), a posteriori validation DTD
+ base(William), notations serialization missing, xmlGetNodePath
+ (Dodji),xmlCheckUTF8 (Diego Tartara), missing line numbers on
+ entity(William)</li>
+ <li>improvements: DocBook catalog build scrip (William), xmlcatalog
+ tool(Albert Chin), xmllint --c14n option, no_proxy environment (Mike
+ Hommey),xmlParseInNodeContext() addition, extend xmllint --shell, allow
+ XIncludeto not generate start/end nodes, extend xmllint --version to
+ include CVStag (William)</li>
+ <li>documentation: web pages fixes, validity API docs fixes
+ (William)schemas API fix (Eric Haszlakiewicz), xmllint man page (John
+ Fleck)</li>
</ul>
<h3>2.6.11: July 5 2004</h3>
<ul>
- <li>Schemas: a lot of changes and improvements by Kasimier Buchcik for
- attributes, namespaces and simple types.</li>
- <li>build fixes: --with-minimum (William Brack), some gcc cleanup
- (William), --with-thread-alloc (William)</li>
- <li>portability: Windows binary package change (Igor Zlatkovic), Catalog
- path on Windows</li>
- <li>documentation: update to the tutorial (John Fleck), xmllint return code
- (John Fleck), man pages (Ville Skytta),</li>
- <li>bug fixes: C14N bug serializing namespaces (Aleksey Sanin), testSAX
- properly initialize the library (William), empty node set in XPath
- (William), xmlSchemas errors (William), invalid charref problem pointed
- by Morus Walter, XInclude xml:base generation (William), Relax-NG bug
- with div processing (William), XPointer and xml:base problem(William),
- Reader and entities, xmllint return code for schemas (William), reader
- streaming problem (Steve Ball), DTD serialization problem (William),
- libxml.m4 fixes (Mike Hommey), do not provide destructors as methods on
- Python classes, xmlReader buffer bug, Python bindings memory interfaces
- improvement (with Stéphane Bidoul), Fixed the push parser to be back to
- synchronous behaviour.</li>
- <li>improvement: custom per-thread I/O enhancement (Rob Richards), register
- namespace in debug shell (Stefano Debenedetti), Python based regression
- test for non-Unix users (William), dynamically increase the number of
- XPath extension functions in Python and fix a memory leak (Marc-Antoine
- Parent and William)</li>
- <li>performance: hack done with Arjan van de Ven to reduce ELF footprint
- and generated code on Linux, plus use gcc runtime profiling to optimize
- the code generated in the RPM packages.</li>
+ <li>Schemas: a lot of changes and improvements by Kasimier Buchcik
+ forattributes, namespaces and simple types.</li>
+ <li>build fixes: --with-minimum (William Brack), some gcc
+ cleanup(William), --with-thread-alloc (William)</li>
+ <li>portability: Windows binary package change (Igor Zlatkovic),
+ Catalogpath on Windows</li>
+ <li>documentation: update to the tutorial (John Fleck), xmllint return
+ code(John Fleck), man pages (Ville Skytta),</li>
+ <li>bug fixes: C14N bug serializing namespaces (Aleksey Sanin),
+ testSAXproperly initialize the library (William), empty node set in
+ XPath(William), xmlSchemas errors (William), invalid charref problem
+ pointedby Morus Walter, XInclude xml:base generation (William), Relax-NG
+ bugwith div processing (William), XPointer and xml:base
+ problem(William),Reader and entities, xmllint return code for schemas
+ (William), readerstreaming problem (Steve Ball), DTD serialization
+ problem (William),libxml.m4 fixes (Mike Hommey), do not provide
+ destructors as methods onPython classes, xmlReader buffer bug, Python
+ bindings memory interfacesimprovement (with Stéphane Bidoul), Fixed the
+ push parser to be back tosynchronous behaviour.</li>
+ <li>improvement: custom per-thread I/O enhancement (Rob Richards),
+ registernamespace in debug shell (Stefano Debenedetti), Python based
+ regressiontest for non-Unix users (William), dynamically increase the
+ number ofXPath extension functions in Python and fix a memory leak
+ (Marc-AntoineParent and William)</li>
+ <li>performance: hack done with Arjan van de Ven to reduce ELF footprintand
+ generated code on Linux, plus use gcc runtime profiling to optimizethe
+ code generated in the RPM packages.</li>
</ul>
<h3>2.6.10: May 17 2004</h3>
<ul>
<li>Web page generated for ChangeLog</li>
<li>build fixes: --without-html problems, make check without make all</li>
- <li>portability: problem with xpath.c on Windows (MSC and Borland), memcmp
- vs. strncmp on Solaris, XPath tests on Windows (Mark Vakoc), C++ do not
- use "list" as parameter name, make tests work with Python 1.5 (Ed
- Davis),</li>
- <li>improvements: made xmlTextReaderMode public, small buffers resizing
- (Morten Welinder), add --maxmem option to xmllint, add
- xmlPopInputCallback() for Matt Sergeant, refactoring of serialization
- escaping, added escaping customization</li>
- <li>bugfixes: xsd:extension (Taihei Goi), assorted regexp bugs (William
- Brack), xmlReader end of stream problem, node deregistration with reader,
- URI escaping and filemanes, XHTML1 formatting (Nick Wellnhofer), regexp
- transition reduction (William), various XSD Schemas fixes (Kasimier
- Buchcik), XInclude fallback problem (William), weird problems with DTD
- (William), structured error handler callback context (William), reverse
- xmlEncodeSpecialChars() behaviour back to escaping '"'</li>
+ <li>portability: problem with xpath.c on Windows (MSC and Borland),
+ memcmpvs. strncmp on Solaris, XPath tests on Windows (Mark Vakoc), C++ do
+ notuse "list" as parameter name, make tests work with Python 1.5
+ (EdDavis),</li>
+ <li>improvements: made xmlTextReaderMode public, small buffers
+ resizing(Morten Welinder), add --maxmem option to xmllint,
+ addxmlPopInputCallback() for Matt Sergeant, refactoring of
+ serializationescaping, added escaping customization</li>
+ <li>bugfixes: xsd:extension (Taihei Goi), assorted regexp bugs
+ (WilliamBrack), xmlReader end of stream problem, node deregistration with
+ reader,URI escaping and filemanes, XHTML1 formatting (Nick Wellnhofer),
+ regexptransition reduction (William), various XSD Schemas fixes
+ (KasimierBuchcik), XInclude fallback problem (William), weird problems
+ with DTD(William), structured error handler callback context (William),
+ reversexmlEncodeSpecialChars() behaviour back to escaping '"'</li>
</ul>
<h3>2.6.9: Apr 18 2004</h3>
<ul>
<li>implement xml:id Working Draft, relaxed XPath id() checking</li>
- <li>bugfixes: xmlCtxtReset (Brent Hendricks), line number and CDATA (Dave
- Beckett), Relax-NG compilation (William Brack), Regexp patches (with
- William), xmlUriEscape (Mark Vakoc), a Relax-NG notAllowed problem (with
- William), Relax-NG name classes compares (William), XInclude duplicate
- fallback (William), external DTD encoding detection (William), a DTD
- validation bug (William), xmlReader Close() fix, recusive extention
- schemas</li>
- <li>improvements: use xmlRead* APIs in test tools (Mark Vakoc), indenting
- save optimization, better handle IIS broken HTTP redirect behaviour (Ian
- Hummel), HTML parser frameset (James Bursa), libxml2-python RPM
- dependancy, XML Schemas union support (Kasimier Buchcik), warning removal
- clanup (William), keep ChangeLog compressed when installing from RPMs</li>
- <li>documentation: examples and xmlDocDumpMemory docs (John Fleck), new
- example (load, xpath, modify, save), xmlCatalogDump() comments,</li>
- <li>Windows: Borland C++ builder (Eric Zurcher), work around Microsoft
- compiler NaN handling bug (Mark Vakoc)</li>
+ <li>bugfixes: xmlCtxtReset (Brent Hendricks), line number and CDATA
+ (DaveBeckett), Relax-NG compilation (William Brack), Regexp patches
+ (withWilliam), xmlUriEscape (Mark Vakoc), a Relax-NG notAllowed problem
+ (withWilliam), Relax-NG name classes compares (William), XInclude
+ duplicatefallback (William), external DTD encoding detection (William), a
+ DTDvalidation bug (William), xmlReader Close() fix, recusive
+ extentionschemas</li>
+ <li>improvements: use xmlRead* APIs in test tools (Mark Vakoc),
+ indentingsave optimization, better handle IIS broken HTTP redirect
+ behaviour (IanHummel), HTML parser frameset (James Bursa), libxml2-python
+ RPMdependancy, XML Schemas union support (Kasimier Buchcik), warning
+ removalclanup (William), keep ChangeLog compressed when installing from
+ RPMs</li>
+ <li>documentation: examples and xmlDocDumpMemory docs (John Fleck),
+ newexample (load, xpath, modify, save), xmlCatalogDump() comments,</li>
+ <li>Windows: Borland C++ builder (Eric Zurcher), work around
+ Microsoftcompiler NaN handling bug (Mark Vakoc)</li>
</ul>
<h3>2.6.8: Mar 23 2004</h3>
<ul>
<li>First step of the cleanup of the serialization code and APIs</li>
- <li>XML Schemas: mixed content (Adam Dickmeiss), QName handling fixes (Adam
- Dickmeiss), anyURI for "" (John Belmonte)</li>
+ <li>XML Schemas: mixed content (Adam Dickmeiss), QName handling fixes
+ (AdamDickmeiss), anyURI for "" (John Belmonte)</li>
<li>Python: Canonicalization C14N support added (Anthony Carrico)</li>
<li>xmlDocCopyNode() extension (William)</li>
- <li>Relax-NG: fix when processing XInclude results (William), external
- reference in interleave (William), missing error on &lt;choice&gt;
- failure (William), memory leak in schemas datatype facets.</li>
+ <li>Relax-NG: fix when processing XInclude results (William),
+ externalreference in interleave (William), missing error on
+ &lt;choice&gt;failure (William), memory leak in schemas datatype
+ facets.</li>
<li>xmlWriter: patch for better DTD support (Alfred Mickautsch)</li>
- <li>bug fixes: xmlXPathLangFunction memory leak (Mike Hommey and William
- Brack), no ID errors if using HTML_PARSE_NOERROR, xmlcatalog fallbacks to
- URI on SYSTEM lookup failure, XInclude parse flags inheritance (William),
- XInclude and XPointer fixes for entities (William), XML parser bug
- reported by Holger Rauch, nanohttp fd leak (William), regexps char
- groups '-' handling (William), dictionnary reference counting problems,
- do not close stderr.</li>
+ <li>bug fixes: xmlXPathLangFunction memory leak (Mike Hommey and
+ WilliamBrack), no ID errors if using HTML_PARSE_NOERROR, xmlcatalog
+ fallbacks toURI on SYSTEM lookup failure, XInclude parse flags
+ inheritance (William),XInclude and XPointer fixes for entities (William),
+ XML parser bugreported by Holger Rauch, nanohttp fd leak (William),
+ regexps chargroups '-' handling (William), dictionnary reference counting
+ problems,do not close stderr.</li>
<li>performance patches from Petr Pajas</li>
<li>Documentation fixes: XML_CATALOG_FILES in man pages (Mike Hommey)</li>
- <li>compilation and portability fixes: --without-valid, catalog cleanups
- (Peter Breitenlohner), MingW patch (Roland Schwingel), cross-compilation
- to Windows (Christophe de Vienne), --with-html-dir fixup (Julio Merino
- Vidal), Windows build (Eric Zurcher)</li>
+ <li>compilation and portability fixes: --without-valid, catalog
+ cleanups(Peter Breitenlohner), MingW patch (Roland Schwingel),
+ cross-compilationto Windows (Christophe de Vienne), --with-html-dir
+ fixup (Julio MerinoVidal), Windows build (Eric Zurcher)</li>
</ul>
<h3>2.6.7: Feb 23 2004</h3>
@@ -1180,63 +1192,64 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<li>xmlWriter: updates and fixes (Alfred Mickautsch, Lucas Brasilino)</li>
<li>XPath optimization (Petr Pajas)</li>
<li>DTD ID handling optimization</li>
- <li>bugfixes: xpath number with &gt; 19 fractional (William Brack), push
- mode with unescaped '&gt;' characters, fix xmllint --stream --timing, fix
- xmllint --memory --stream memory usage, xmlAttrSerializeTxtContent
- handling NULL, trying to fix Relax-NG/Perl interface.</li>
+ <li>bugfixes: xpath number with &gt; 19 fractional (William Brack),
+ pushmode with unescaped '&gt;' characters, fix xmllint --stream --timing,
+ fixxmllint --memory --stream memory usage,
+ xmlAttrSerializeTxtContenthandling NULL, trying to fix Relax-NG/Perl
+ interface.</li>
<li>python: 2.3 compatibility, whitespace fixes (Malcolm Tredinnick)</li>
<li>Added relaxng option to xmllint --shell</li>
</ul>
<h3>2.6.6: Feb 12 2004</h3>
<ul>
- <li>nanohttp and nanoftp: buffer overflow error on URI parsing (Igor and
- William) reported by Yuuichi Teranishi</li>
- <li>bugfixes: make test and path issues, xmlWriter attribute serialization
- (William Brack), xmlWriter indentation (William), schemas validation
- (Eric Haszlakiewicz), XInclude dictionnaries issues (William and Oleg
- Paraschenko), XInclude empty fallback (William), HTML warnings (William),
- XPointer in XInclude (William), Python namespace serialization,
- isolat1ToUTF8 bound error (Alfred Mickautsch), output of parameter
- entities in internal subset (William), internal subset bug in push mode,
- &lt;xs:all&gt; fix (Alexey Sarytchev)</li>
- <li>Build: fix for automake-1.8 (Alexander Winston), warnings removal
- (Philip Ludlam), SOCKLEN_T detection fixes (Daniel Richard), fix
- --with-minimum configuration.</li>
+ <li>nanohttp and nanoftp: buffer overflow error on URI parsing (Igor
+ andWilliam) reported by Yuuichi Teranishi</li>
+ <li>bugfixes: make test and path issues, xmlWriter attribute
+ serialization(William Brack), xmlWriter indentation (William), schemas
+ validation(Eric Haszlakiewicz), XInclude dictionnaries issues (William
+ and OlegParaschenko), XInclude empty fallback (William), HTML warnings
+ (William),XPointer in XInclude (William), Python namespace
+ serialization,isolat1ToUTF8 bound error (Alfred Mickautsch), output of
+ parameterentities in internal subset (William), internal subset bug in
+ push mode,&lt;xs:all&gt; fix (Alexey Sarytchev)</li>
+ <li>Build: fix for automake-1.8 (Alexander Winston), warnings
+ removal(Philip Ludlam), SOCKLEN_T detection fixes (Daniel Richard),
+ fix--with-minimum configuration.</li>
<li>XInclude: allow the 2001 namespace without warning.</li>
- <li>Documentation: missing example/index.html (John Fleck), version
- dependancies (John Fleck)</li>
+ <li>Documentation: missing example/index.html (John Fleck),
+ versiondependancies (John Fleck)</li>
<li>reader API: structured error reporting (Steve Ball)</li>
- <li>Windows compilation: mingw, msys (Mikhail Grushinskiy), function
- prototype (Cameron Johnson), MSVC6 compiler warnings, _WINSOCKAPI_
- patch</li>
- <li>Parsers: added xmlByteConsumed(ctxt) API to get the byte offest in
- input.</li>
+ <li>Windows compilation: mingw, msys (Mikhail Grushinskiy),
+ functionprototype (Cameron Johnson), MSVC6 compiler warnings,
+ _WINSOCKAPI_patch</li>
+ <li>Parsers: added xmlByteConsumed(ctxt) API to get the byte offest
+ ininput.</li>
</ul>
<h3>2.6.5: Jan 25 2004</h3>
<ul>
- <li>Bugfixes: dictionnaries for schemas (William Brack), regexp segfault
- (William), xs:all problem (William), a number of XPointer bugfixes
- (William), xmllint error go to stderr, DTD validation problem with
- namespace, memory leak (William), SAX1 cleanup and minimal options fixes
- (Mark Vadoc), parser context reset on error (Shaun McCance), XPath union
- evaluation problem (William) , xmlReallocLoc with NULL (Aleksey Sanin),
- XML Schemas double free (Steve Ball), XInclude with no href, argument
- callbacks order for XPath callbacks (Frederic Peters)</li>
- <li>Documentation: python scripts (William Brack), xslt stylesheets (John
- Fleck), doc (Sven Zimmerman), I/O example.</li>
- <li>Python bindings: fixes (William), enum support (Stéphane Bidoul),
- structured error reporting (Stéphane Bidoul)</li>
- <li>XInclude: various fixes for conformance, problem related to dictionnary
- references (William &amp; me), recursion (William)</li>
- <li>xmlWriter: indentation (Lucas Brasilino), memory leaks (Alfred
- Mickautsch),</li>
+ <li>Bugfixes: dictionnaries for schemas (William Brack), regexp
+ segfault(William), xs:all problem (William), a number of XPointer
+ bugfixes(William), xmllint error go to stderr, DTD validation problem
+ withnamespace, memory leak (William), SAX1 cleanup and minimal options
+ fixes(Mark Vadoc), parser context reset on error (Shaun McCance), XPath
+ unionevaluation problem (William) , xmlReallocLoc with NULL (Aleksey
+ Sanin),XML Schemas double free (Steve Ball), XInclude with no href,
+ argumentcallbacks order for XPath callbacks (Frederic Peters)</li>
+ <li>Documentation: python scripts (William Brack), xslt stylesheets
+ (JohnFleck), doc (Sven Zimmerman), I/O example.</li>
+ <li>Python bindings: fixes (William), enum support (Stéphane
+ Bidoul),structured error reporting (Stéphane Bidoul)</li>
+ <li>XInclude: various fixes for conformance, problem related to
+ dictionnaryreferences (William &amp; me), recursion (William)</li>
+ <li>xmlWriter: indentation (Lucas Brasilino), memory leaks
+ (AlfredMickautsch),</li>
<li>xmlSchemas: normalizedString datatype (John Belmonte)</li>
<li>code cleanup for strings functions (William)</li>
<li>Windows: compiler patches (Mark Vakoc)</li>
- <li>Parser optimizations, a few new XPath and dictionnary APIs for future
- XSLT optimizations.</li>
+ <li>Parser optimizations, a few new XPath and dictionnary APIs for
+ futureXSLT optimizations.</li>
</ul>
<h3>2.6.4: Dec 24 2003</h3>
@@ -1244,41 +1257,41 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<li>Windows build fixes (Igor Zlatkovic)</li>
<li>Some serious XInclude problems reported by Oleg Paraschenko and</li>
<li>Unix and Makefile packaging fixes (me, William Brack,</li>
- <li>Documentation improvements (John Fleck, William Brack), example fix
- (Lucas Brasilino)</li>
- <li>bugfixes: xmlTextReaderExpand() with xmlReaderWalker, XPath handling of
- NULL strings (William Brack) , API building reader or parser from
- filedescriptor should not close it, changed XPath sorting to be stable
- again (William Brack), xmlGetNodePath() generating '(null)' (William
- Brack), DTD validation and namespace bug (William Brack), XML Schemas
- double inclusion behaviour</li>
+ <li>Documentation improvements (John Fleck, William Brack), example
+ fix(Lucas Brasilino)</li>
+ <li>bugfixes: xmlTextReaderExpand() with xmlReaderWalker, XPath handling
+ ofNULL strings (William Brack) , API building reader or parser
+ fromfiledescriptor should not close it, changed XPath sorting to be
+ stableagain (William Brack), xmlGetNodePath() generating '(null)'
+ (WilliamBrack), DTD validation and namespace bug (William Brack), XML
+ Schemasdouble inclusion behaviour</li>
</ul>
<h3>2.6.3: Dec 10 2003</h3>
<ul>
<li>documentation updates and cleanup (DV, William Brack, John Fleck)</li>
- <li>added a repository of examples, examples from Aleksey Sanin, Dodji
- Seketeli, Alfred Mickautsch</li>
- <li>Windows updates: Mark Vakoc, Igor Zlatkovic, Eric Zurcher, Mingw
- (Kenneth Haley)</li>
+ <li>added a repository of examples, examples from Aleksey Sanin,
+ DodjiSeketeli, Alfred Mickautsch</li>
+ <li>Windows updates: Mark Vakoc, Igor Zlatkovic, Eric Zurcher,
+ Mingw(Kenneth Haley)</li>
<li>Unicode range checking (William Brack)</li>
<li>code cleanup (William Brack)</li>
<li>Python bindings: doc (John Fleck), bug fixes</li>
<li>UTF-16 cleanup and BOM issues (William Brack)</li>
- <li>bug fixes: ID and xmlReader validation, XPath (William Brack),
- xmlWriter (Alfred Mickautsch), hash.h inclusion problem, HTML parser
- (James Bursa), attribute defaulting and validation, some serialization
- cleanups, XML_GET_LINE macro, memory debug when using threads (William
- Brack), serialization of attributes and entities content, xmlWriter
- (Daniel Schulman)</li>
- <li>XInclude bugfix, new APIs and update to the last version including the
- namespace change.</li>
- <li>XML Schemas improvements: include (Robert Stepanek), import and
- namespace handling, fixed the regression tests troubles, added examples
- based on Eric van der Vlist book, regexp fixes</li>
- <li>preliminary pattern support for streaming (needed for schemas
- constraints), added xmlTextReaderPreservePattern() to collect subdocument
- when streaming.</li>
+ <li>bug fixes: ID and xmlReader validation, XPath (William Brack),xmlWriter
+ (Alfred Mickautsch), hash.h inclusion problem, HTML parser(James Bursa),
+ attribute defaulting and validation, some serializationcleanups,
+ XML_GET_LINE macro, memory debug when using threads (WilliamBrack),
+ serialization of attributes and entities content, xmlWriter(Daniel
+ Schulman)</li>
+ <li>XInclude bugfix, new APIs and update to the last version including
+ thenamespace change.</li>
+ <li>XML Schemas improvements: include (Robert Stepanek), import
+ andnamespace handling, fixed the regression tests troubles, added
+ examplesbased on Eric van der Vlist book, regexp fixes</li>
+ <li>preliminary pattern support for streaming (needed for
+ schemasconstraints), added xmlTextReaderPreservePattern() to collect
+ subdocumentwhen streaming.</li>
<li>various fixes in the structured error handling</li>
</ul>
@@ -1294,107 +1307,106 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<li>a posteriori DTD validation fixes</li>
<li>xmlReader bug fixes: Walker fixes, python bindings</li>
<li>fixed xmlStopParser() to really stop the parser and errors</li>
- <li>always generate line numbers when using the new xmlReadxxx
- functions</li>
+ <li>always generate line numbers when using the new xmlReadxxxfunctions</li>
<li>added XInclude support to the xmlReader interface</li>
<li>implemented XML_PARSE_NONET parser option</li>
<li>DocBook XSLT processing bug fixed</li>
<li>HTML serialization for &lt;p&gt; elements (William Brack and me)</li>
<li>XPointer failure in XInclude are now handled as resource errors</li>
- <li>fixed xmllint --html to use the HTML serializer on output (added
- --xmlout to implement the previous behaviour of saving it using the XML
- serializer)</li>
+ <li>fixed xmllint --html to use the HTML serializer on output
+ (added--xmlout to implement the previous behaviour of saving it using the
+ XMLserializer)</li>
</ul>
<h3>2.6.1: Oct 28 2003</h3>
<ul>
<li>Mostly bugfixes after the big 2.6.0 changes</li>
- <li>Unix compilation patches: libxml.m4 (Patrick Welche), warnings cleanup
- (William Brack)</li>
- <li>Windows compilation patches (Joachim Bauch, Stephane Bidoul, Igor
- Zlatkovic)</li>
+ <li>Unix compilation patches: libxml.m4 (Patrick Welche), warnings
+ cleanup(William Brack)</li>
+ <li>Windows compilation patches (Joachim Bauch, Stephane Bidoul,
+ IgorZlatkovic)</li>
<li>xmlWriter bugfix (Alfred Mickautsch)</li>
<li>chvalid.[ch]: couple of fixes from Stephane Bidoul</li>
- <li>context reset: error state reset, push parser reset (Graham
- Bennett)</li>
+ <li>context reset: error state reset, push parser reset (GrahamBennett)</li>
<li>context reuse: generate errors if file is not readable</li>
- <li>defaulted attributes for element coming from internal entities
- (Stephane Bidoul)</li>
+ <li>defaulted attributes for element coming from internal entities(Stephane
+ Bidoul)</li>
<li>Python: tab and spaces mix (William Brack)</li>
<li>Error handler could crash in DTD validation in 2.6.0</li>
<li>xmlReader: do not use the document or element _private field</li>
<li>testSAX.c: avoid a problem with some PIs (Massimo Morara)</li>
- <li>general bug fixes: mandatory encoding in text decl, serializing
- Document Fragment nodes, xmlSearchNs 2.6.0 problem (Kasimier Buchcik),
- XPath errors not reported, slow HTML parsing of large documents.</li>
+ <li>general bug fixes: mandatory encoding in text decl, serializingDocument
+ Fragment nodes, xmlSearchNs 2.6.0 problem (Kasimier Buchcik),XPath errors
+ not reported, slow HTML parsing of large documents.</li>
</ul>
<h3>2.6.0: Oct 20 2003</h3>
<ul>
- <li>Major revision release: should be API and ABI compatible but got a lot
- of change</li>
- <li>Increased the library modularity, far more options can be stripped out,
- a --with-minimum configuration will weight around 160KBytes</li>
- <li>Use per parser and per document dictionnary, allocate names and small
- text nodes from the dictionnary</li>
- <li>Switch to a SAX2 like parser rewrote most of the XML parser core,
- provides namespace resolution and defaulted attributes, minimize memory
- allocations and copies, namespace checking and specific error handling,
- immutable buffers, make predefined entities static structures, etc...</li>
- <li>rewrote all the error handling in the library, all errors can be
- intercepted at a structured level, with precise information
- available.</li>
- <li>New simpler and more generic XML and HTML parser APIs, allowing to
- easilly modify the parsing options and reuse parser context for multiple
- consecutive documents.</li>
- <li>Similar new APIs for the xmlReader, for options and reuse, provided new
- functions to access content as const strings, use them for Python
- bindings</li>
- <li>a lot of other smaller API improvements: xmlStrPrintf (Aleksey Sanin),
- Walker i.e. reader on a document tree based on Alfred Mickautsch code,
- make room in nodes for line numbers, reference counting and future PSVI
- extensions, generation of character ranges to be checked with faster
- algorithm (William), xmlParserMaxDepth (Crutcher Dunnavant), buffer
- access</li>
+ <li>Major revision release: should be API and ABI compatible but got a
+ lotof change</li>
+ <li>Increased the library modularity, far more options can be stripped
+ out,a --with-minimum configuration will weight around 160KBytes</li>
+ <li>Use per parser and per document dictionnary, allocate names and
+ smalltext nodes from the dictionnary</li>
+ <li>Switch to a SAX2 like parser rewrote most of the XML parser
+ core,provides namespace resolution and defaulted attributes, minimize
+ memoryallocations and copies, namespace checking and specific error
+ handling,immutable buffers, make predefined entities static structures,
+ etc...</li>
+ <li>rewrote all the error handling in the library, all errors can
+ beintercepted at a structured level, with precise
+ informationavailable.</li>
+ <li>New simpler and more generic XML and HTML parser APIs, allowing
+ toeasilly modify the parsing options and reuse parser context for
+ multipleconsecutive documents.</li>
+ <li>Similar new APIs for the xmlReader, for options and reuse, provided
+ newfunctions to access content as const strings, use them for
+ Pythonbindings</li>
+ <li>a lot of other smaller API improvements: xmlStrPrintf (Aleksey
+ Sanin),Walker i.e. reader on a document tree based on Alfred Mickautsch
+ code,make room in nodes for line numbers, reference counting and future
+ PSVIextensions, generation of character ranges to be checked with
+ fasteralgorithm (William), xmlParserMaxDepth (Crutcher Dunnavant),
+ bufferaccess</li>
<li>New xmlWriter API provided by Alfred Mickautsch</li>
<li>Schemas: base64 support by Anthony Carrico</li>
- <li>Parser&lt;-&gt;HTTP integration fix, proper processing of the Mime-Type
- and charset informations if available.</li>
- <li>Relax-NG: bug fixes including the one reported by Martijn Faassen and
- zeroOrMore, better error reporting.</li>
- <li>Python bindings (Stéphane Bidoul), never use stdout for errors
- output</li>
- <li>Portability: all the headers have macros for export and calling
- convention definitions (Igor Zlatkovic), VMS update (Craig A. Berry),
- Windows: threads (Jesse Pelton), Borland compiler (Eric Zurcher, Igor),
- Mingw (Igor), typos (Mark Vakoc), beta version (Stephane Bidoul),
- warning cleanups on AIX and MIPS compilers (William Brack), BeOS (Marcin
- 'Shard' Konicki)</li>
- <li>Documentation fixes and README (William Brack), search fix (William),
- tutorial updates (John Fleck), namespace docs (Stefan Kost)</li>
- <li>Bug fixes: xmlCleanupParser (Dave Beckett), threading uninitialized
- mutexes, HTML doctype lowercase, SAX/IO (William), compression detection
- and restore (William), attribute declaration in DTDs (William), namespace
- on attribute in HTML output (William), input filename (Rob Richards),
- namespace DTD validation, xmlReplaceNode (Chris Ryland), I/O callbacks
- (Markus Keim), CDATA serialization (Shaun McCance), xmlReader (Peter
- Derr), high codepoint charref like &amp;#x10FFFF;, buffer access in push
- mode (Justin Fletcher), TLS threads on Windows (Jesse Pelton), XPath bug
- (William), xmlCleanupParser (Marc Liyanage), CDATA output (William), HTTP
- error handling.</li>
- <li>xmllint options: --dtdvalidfpi for Tobias Reif, --sax1 for compat
- testing, --nodict for building without tree dictionnary, --nocdata to
- replace CDATA by text, --nsclean to remove surperfluous namespace
- declarations</li>
+ <li>Parser&lt;-&gt;HTTP integration fix, proper processing of the
+ Mime-Typeand charset informations if available.</li>
+ <li>Relax-NG: bug fixes including the one reported by Martijn Faassen
+ andzeroOrMore, better error reporting.</li>
+ <li>Python bindings (Stéphane Bidoul), never use stdout for
+ errorsoutput</li>
+ <li>Portability: all the headers have macros for export and
+ callingconvention definitions (Igor Zlatkovic), VMS update (Craig A.
+ Berry),Windows: threads (Jesse Pelton), Borland compiler (Eric Zurcher,
+ Igor),Mingw (Igor), typos (Mark Vakoc), beta version (Stephane
+ Bidoul),warning cleanups on AIX and MIPS compilers (William Brack), BeOS
+ (Marcin'Shard' Konicki)</li>
+ <li>Documentation fixes and README (William Brack), search fix
+ (William),tutorial updates (John Fleck), namespace docs (Stefan Kost)</li>
+ <li>Bug fixes: xmlCleanupParser (Dave Beckett), threading
+ uninitializedmutexes, HTML doctype lowercase, SAX/IO (William),
+ compression detectionand restore (William), attribute declaration in DTDs
+ (William), namespaceon attribute in HTML output (William), input filename
+ (Rob Richards),namespace DTD validation, xmlReplaceNode (Chris Ryland),
+ I/O callbacks(Markus Keim), CDATA serialization (Shaun McCance),
+ xmlReader (PeterDerr), high codepoint charref like &amp;#x10FFFF;, buffer
+ access in pushmode (Justin Fletcher), TLS threads on Windows (Jesse
+ Pelton), XPath bug(William), xmlCleanupParser (Marc Liyanage), CDATA
+ output (William), HTTPerror handling.</li>
+ <li>xmllint options: --dtdvalidfpi for Tobias Reif, --sax1 for
+ compattesting, --nodict for building without tree dictionnary, --nocdata
+ toreplace CDATA by text, --nsclean to remove surperfluous
+ namespacedeclarations</li>
<li>added xml2-config --libtool-libs option from Kevin P. Fleming</li>
- <li>a lot of profiling and tuning of the code, speedup patch for
- xmlSearchNs() by Luca Padovani. The xmlReader should do far less
- allocation and it speed should get closer to SAX. Chris Anderson worked
- on speeding and cleaning up repetitive checking code.</li>
+ <li>a lot of profiling and tuning of the code, speedup patch
+ forxmlSearchNs() by Luca Padovani. The xmlReader should do far
+ lessallocation and it speed should get closer to SAX. Chris Anderson
+ workedon speeding and cleaning up repetitive checking code.</li>
<li>cleanup of "make tests"</li>
<li>libxml-2.0-uninstalled.pc from Malcolm Tredinnick</li>
- <li>deactivated the broken docBook SGML parser code and plugged the XML
- parser instead.</li>
+ <li>deactivated the broken docBook SGML parser code and plugged the
+ XMLparser instead.</li>
</ul>
<h3>2.5.11: Sep 9 2003</h3>
@@ -1411,8 +1423,8 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<ul>
<li>Windows Makefiles (William Brack)</li>
<li>UTF-16 support fixes (Mark Itzcovitz)</li>
- <li>Makefile and portability (William Brack) automake, Linux alpha, Mingw
- on Windows (Mikhail Grushinskiy)</li>
+ <li>Makefile and portability (William Brack) automake, Linux alpha, Mingwon
+ Windows (Mikhail Grushinskiy)</li>
<li>HTML parser (Oliver Stoeneberg)</li>
<li>XInclude performance problem reported by Kevin Ruscoe</li>
<li>XML parser performance problem reported by Grant Goodale</li>
@@ -1422,13 +1434,13 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<h3>2.5.9: Aug 9 2003</h3>
<ul>
- <li>bugfixes: IPv6 portability, xmlHasNsProp (Markus Keim), Windows build
- (Wiliam Brake, Jesse Pelton, Igor), Schemas (Peter Sobisch), threading
- (Rob Richards), hexBinary type (), UTF-16 BOM (Dodji Seketeli),
- xmlReader, Relax-NG schemas compilation, namespace handling, EXSLT (Sean
- Griffin), HTML parsing problem (William Brack), DTD validation for mixed
- content + namespaces, HTML serialization, library initialization,
- progressive HTML parser</li>
+ <li>bugfixes: IPv6 portability, xmlHasNsProp (Markus Keim), Windows
+ build(Wiliam Brake, Jesse Pelton, Igor), Schemas (Peter Sobisch),
+ threading(Rob Richards), hexBinary type (), UTF-16 BOM (Dodji
+ Seketeli),xmlReader, Relax-NG schemas compilation, namespace handling,
+ EXSLT (SeanGriffin), HTML parsing problem (William Brack), DTD validation
+ for mixedcontent + namespaces, HTML serialization, library
+ initialization,progressive HTML parser</li>
<li>better interfaces for Relax-NG error handling (Joachim Bauch, )</li>
<li>adding xmlXIncludeProcessTree() for XInclud'ing in a subtree</li>
<li>doc fixes and improvements (John Fleck)</li>
@@ -1436,86 +1448,86 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<li>couple of new UTF-8 helper functions (William Brack)</li>
<li>general encoding cleanup + ISO-8859-x without iconv (Peter Jacobi)</li>
<li>xmlTextReader cleanup + enum for node types (Bjorn Reese)</li>
- <li>general compilation/warning cleanup Solaris/HP-UX/... (William
- Brack)</li>
+ <li>general compilation/warning cleanup Solaris/HP-UX/...
+ (WilliamBrack)</li>
</ul>
<h3>2.5.8: Jul 6 2003</h3>
<ul>
- <li>bugfixes: XPath, XInclude, file/URI mapping, UTF-16 save (Mark
- Itzcovitz), UTF-8 checking, URI saving, error printing (William Brack),
- PI related memleak, compilation without schemas or without xpath (Joerg
- Schmitz-Linneweber/Garry Pennington), xmlUnlinkNode problem with DTDs,
- rpm problem on , i86_64, removed a few compilation problems from 2.5.7,
- xmlIOParseDTD, and xmlSAXParseDTD (Malcolm Tredinnick)</li>
+ <li>bugfixes: XPath, XInclude, file/URI mapping, UTF-16 save
+ (MarkItzcovitz), UTF-8 checking, URI saving, error printing (William
+ Brack),PI related memleak, compilation without schemas or without xpath
+ (JoergSchmitz-Linneweber/Garry Pennington), xmlUnlinkNode problem with
+ DTDs,rpm problem on , i86_64, removed a few compilation problems from
+ 2.5.7,xmlIOParseDTD, and xmlSAXParseDTD (Malcolm Tredinnick)</li>
<li>portability: DJGPP (MsDos) , OpenVMS (Craig A. Berry)</li>
<li>William Brack fixed multithreading lock problems</li>
<li>IPv6 patch for FTP and HTTP accesses (Archana Shah/Wipro)</li>
- <li>Windows fixes (Igor Zlatkovic, Eric Zurcher), threading (Stéphane
- Bidoul)</li>
+ <li>Windows fixes (Igor Zlatkovic, Eric Zurcher), threading
+ (StéphaneBidoul)</li>
<li>A few W3C Schemas Structure improvements</li>
<li>W3C Schemas Datatype improvements (Charlie Bozeman)</li>
- <li>Python bindings for thread globals (Stéphane Bidoul), and method/class
- generator</li>
+ <li>Python bindings for thread globals (Stéphane Bidoul), and
+ method/classgenerator</li>
<li>added --nonet option to xmllint</li>
<li>documentation improvements (John Fleck)</li>
</ul>
<h3>2.5.7: Apr 25 2003</h3>
<ul>
- <li>Relax-NG: Compiling to regexp and streaming validation on top of the
- xmlReader interface, added to xmllint --stream</li>
+ <li>Relax-NG: Compiling to regexp and streaming validation on top of
+ thexmlReader interface, added to xmllint --stream</li>
<li>xmlReader: Expand(), Next() and DOM access glue, bug fixes</li>
<li>Support for large files: RGN validated a 4.5GB instance</li>
<li>Thread support is now configured in by default</li>
- <li>Fixes: update of the Trio code (Bjorn), WXS Date and Duration fixes
- (Charles Bozeman), DTD and namespaces (Brent Hendricks), HTML push parser
- and zero bytes handling, some missing Windows file path conversions,
- behaviour of the parser and validator in the presence of "out of memory"
- error conditions</li>
- <li>extended the API to be able to plug a garbage collecting memory
- allocator, added xmlMallocAtomic() and modified the allocations
- accordingly.</li>
- <li>Performances: removed excessive malloc() calls, speedup of the push and
- xmlReader interfaces, removed excessive thread locking</li>
+ <li>Fixes: update of the Trio code (Bjorn), WXS Date and Duration
+ fixes(Charles Bozeman), DTD and namespaces (Brent Hendricks), HTML push
+ parserand zero bytes handling, some missing Windows file path
+ conversions,behaviour of the parser and validator in the presence of "out
+ of memory"error conditions</li>
+ <li>extended the API to be able to plug a garbage collecting
+ memoryallocator, added xmlMallocAtomic() and modified the
+ allocationsaccordingly.</li>
+ <li>Performances: removed excessive malloc() calls, speedup of the push
+ andxmlReader interfaces, removed excessive thread locking</li>
<li>Documentation: man page (John Fleck), xmlReader documentation</li>
<li>Python: adding binding for xmlCatalogAddLocal (Brent M Hendricks)</li>
</ul>
<h3>2.5.6: Apr 1 2003</h3>
<ul>
- <li>Fixed W3C XML Schemas datatype, should be compliant now except for
- binHex and base64 which are not supported yet.</li>
- <li>bug fixes: non-ASCII IDs, HTML output, XInclude on large docs and
- XInclude entities handling, encoding detection on external subsets, XML
- Schemas bugs and memory leaks, HTML parser (James Bursa)</li>
+ <li>Fixed W3C XML Schemas datatype, should be compliant now except
+ forbinHex and base64 which are not supported yet.</li>
+ <li>bug fixes: non-ASCII IDs, HTML output, XInclude on large docs
+ andXInclude entities handling, encoding detection on external subsets,
+ XMLSchemas bugs and memory leaks, HTML parser (James Bursa)</li>
<li>portability: python/trio (Albert Chin), Sun compiler warnings</li>
<li>documentation: added --relaxng option to xmllint man page (John)</li>
- <li>improved error reporting: xml:space, start/end tag mismatches, Relax NG
- errors</li>
+ <li>improved error reporting: xml:space, start/end tag mismatches, Relax
+ NGerrors</li>
</ul>
<h3>2.5.5: Mar 24 2003</h3>
<ul>
- <li>Lot of fixes on the Relax NG implementation. More testing including
- DocBook and TEI examples.</li>
+ <li>Lot of fixes on the Relax NG implementation. More testing
+ includingDocBook and TEI examples.</li>
<li>Increased the support for W3C XML Schemas datatype</li>
<li>Several bug fixes in the URI handling layer</li>
- <li>Bug fixes: HTML parser, xmlReader, DTD validation, XPath, encoding
- conversion, line counting in the parser.</li>
+ <li>Bug fixes: HTML parser, xmlReader, DTD validation, XPath,
+ encodingconversion, line counting in the parser.</li>
<li>Added support for $XMLLINT_INDENT environment variable, FTP delete</li>
<li>Fixed the RPM spec file name</li>
</ul>
<h3>2.5.4: Feb 20 2003</h3>
<ul>
- <li>Conformance testing and lot of fixes on Relax NG and XInclude
- implementation</li>
+ <li>Conformance testing and lot of fixes on Relax NG and
+ XIncludeimplementation</li>
<li>Implementation of XPointer element() scheme</li>
- <li>Bug fixes: XML parser, XInclude entities merge, validity checking on
- namespaces,
- <p>2 serialization bugs, node info generation problems, a DTD regexp
- generation problem.</p>
+ <li>Bug fixes: XML parser, XInclude entities merge, validity checking
+ onnamespaces,
+ <p>2 serialization bugs, node info generation problems, a DTD
+ regexpgeneration problem.</p>
</li>
<li>Portability: windows updates and path canonicalization (Igor)</li>
<li>A few typo fixes (Kjartan Maraas)</li>
@@ -1524,11 +1536,11 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<h3>2.5.3: Feb 10 2003</h3>
<ul>
- <li>RelaxNG and XML Schemas datatypes improvements, and added a first
- version of RelaxNG Python bindings</li>
- <li>Fixes: XLink (Sean Chittenden), XInclude (Sean Chittenden), API fix for
- serializing namespace nodes, encoding conversion bug, XHTML1
- serialization</li>
+ <li>RelaxNG and XML Schemas datatypes improvements, and added a
+ firstversion of RelaxNG Python bindings</li>
+ <li>Fixes: XLink (Sean Chittenden), XInclude (Sean Chittenden), API fix
+ forserializing namespace nodes, encoding conversion bug,
+ XHTML1serialization</li>
<li>Portability fixes: Windows (Igor), AMD 64bits RPM spec file</li>
</ul>
@@ -1536,17 +1548,17 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<ul>
<li>First implementation of RelaxNG, added --relaxng flag to xmllint</li>
<li>Schemas support now compiled in by default.</li>
- <li>Bug fixes: DTD validation, namespace checking, XInclude and entities,
- delegateURI in XML Catalogs, HTML parser, XML reader (Stéphane Bidoul),
- XPath parser and evaluation, UTF8ToUTF8 serialization, XML reader memory
- consumption, HTML parser, HTML serialization in the presence of
- namespaces</li>
+ <li>Bug fixes: DTD validation, namespace checking, XInclude and
+ entities,delegateURI in XML Catalogs, HTML parser, XML reader (Stéphane
+ Bidoul),XPath parser and evaluation, UTF8ToUTF8 serialization, XML
+ reader memoryconsumption, HTML parser, HTML serialization in the presence
+ ofnamespaces</li>
<li>added an HTML API to check elements and attributes.</li>
- <li>Documentation improvement, PDF for the tutorial (John Fleck), doc
- patches (Stefan Kost)</li>
+ <li>Documentation improvement, PDF for the tutorial (John Fleck),
+ docpatches (Stefan Kost)</li>
<li>Portability fixes: NetBSD (Julio Merino), Windows (Igor Zlatkovic)</li>
- <li>Added python bindings for XPointer, contextual error reporting
- (Stéphane Bidoul)</li>
+ <li>Added python bindings for XPointer, contextual error reporting(Stéphane
+ Bidoul)</li>
<li>URI/file escaping problems (Stefano Zacchiroli)</li>
</ul>
@@ -1559,20 +1571,20 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<h3>2.5.0: Jan 6 2003</h3>
<ul>
- <li>New <a href="xmlreader.html">XmltextReader interface</a> based on C#
- API (with help of Stéphane Bidoul)</li>
+ <li>New <a href="xmlreader.html">XmltextReader interface</a>based on C#API
+ (with help of Stéphane Bidoul)</li>
<li>Windows: more exports, including the new API (Igor)</li>
<li>XInclude fallback fix</li>
- <li>Python: bindings for the new API, packaging (Stéphane Bidoul),
- drv_libxml2.py Python xml.sax driver (Stéphane Bidoul), fixes, speedup
- and iterators for Python-2.2 (Hannu Krosing)</li>
- <li>Tutorial fixes (john Fleck and Niraj Tolia) xmllint man update
- (John)</li>
+ <li>Python: bindings for the new API, packaging (Stéphane
+ Bidoul),drv_libxml2.py Python xml.sax driver (Stéphane Bidoul), fixes,
+ speedupand iterators for Python-2.2 (Hannu Krosing)</li>
+ <li>Tutorial fixes (john Fleck and Niraj Tolia) xmllint man
+ update(John)</li>
<li>Fix an XML parser bug raised by Vyacheslav Pindyura</li>
<li>Fix for VMS serialization (Nigel Hall) and config (Craig A. Berry)</li>
<li>Entities handling fixes</li>
- <li>new API to optionally track node creation and deletion (Lukas
- Schroeder)</li>
+ <li>new API to optionally track node creation and deletion
+ (LukasSchroeder)</li>
<li>Added documentation for the XmltextReader interface and some <a
href="guidelines.html">XML guidelines</a></li>
</ul>
@@ -1580,23 +1592,24 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<h3>2.4.30: Dec 12 2002</h3>
<ul>
<li>2.4.29 broke the python bindings, rereleasing</li>
- <li>Improvement/fixes of the XML API generator, and couple of minor code
- fixes.</li>
+ <li>Improvement/fixes of the XML API generator, and couple of minor
+ codefixes.</li>
</ul>
<h3>2.4.29: Dec 11 2002</h3>
<ul>
- <li>Windows fixes (Igor): Windows CE port, pthread linking, python bindings
- (Stéphane Bidoul), Mingw (Magnus Henoch), and export list updates</li>
+ <li>Windows fixes (Igor): Windows CE port, pthread linking, python
+ bindings(Stéphane Bidoul), Mingw (Magnus Henoch), and export list
+ updates</li>
<li>Fix for prev in python bindings (ERDI Gergo)</li>
<li>Fix for entities handling (Marcus Clarke)</li>
- <li>Refactored the XML and HTML dumps to a single code path, fixed XHTML1
- dump</li>
+ <li>Refactored the XML and HTML dumps to a single code path, fixed
+ XHTML1dump</li>
<li>Fix for URI parsing when handling URNs with fragment identifiers</li>
<li>Fix for HTTP URL escaping problem</li>
<li>added an TextXmlReader (C#) like API (work in progress)</li>
- <li>Rewrote the API in XML generation script, includes a C parser and saves
- more informations needed for C# bindings</li>
+ <li>Rewrote the API in XML generation script, includes a C parser and
+ savesmore informations needed for C# bindings</li>
</ul>
<h3>2.4.28: Nov 22 2002</h3>
@@ -1613,15 +1626,15 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<h3>2.4.27: Nov 17 2002</h3>
<ul>
<li>fixes for the Python bindings</li>
- <li>a number of bug fixes: SGML catalogs, xmlParseBalancedChunkMemory(),
- HTML parser, Schemas (Charles Bozeman), document fragment support
- (Christian Glahn), xmlReconciliateNs (Brian Stafford), XPointer,
- xmlFreeNode(), xmlSAXParseMemory (Peter Jones), xmlGetNodePath (Petr
- Pajas), entities processing</li>
+ <li>a number of bug fixes: SGML catalogs,
+ xmlParseBalancedChunkMemory(),HTML parser, Schemas (Charles Bozeman),
+ document fragment support(Christian Glahn), xmlReconciliateNs (Brian
+ Stafford), XPointer,xmlFreeNode(), xmlSAXParseMemory (Peter Jones),
+ xmlGetNodePath (PetrPajas), entities processing</li>
<li>added grep to xmllint --shell</li>
<li>VMS update patch from Craig A. Berry</li>
- <li>cleanup of the Windows build with support for more compilers (Igor),
- better thread support on Windows</li>
+ <li>cleanup of the Windows build with support for more compilers
+ (Igor),better thread support on Windows</li>
<li>cleanup of Unix Makefiles and spec file</li>
<li>Improvements to the documentation (John Fleck)</li>
</ul>
@@ -1629,27 +1642,26 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<h3>2.4.26: Oct 18 2002</h3>
<ul>
<li>Patches for Windows CE port, improvements on Windows paths handling</li>
- <li>Fixes to the validation code (DTD and Schemas), xmlNodeGetPath() ,
- HTML serialization, Namespace compliance, and a number of small
- problems</li>
+ <li>Fixes to the validation code (DTD and Schemas), xmlNodeGetPath() ,HTML
+ serialization, Namespace compliance, and a number of smallproblems</li>
</ul>
<h3>2.4.25: Sep 26 2002</h3>
<ul>
- <li>A number of bug fixes: XPath, validation, Python bindings, DOM and
- tree, xmlI/O, Html</li>
+ <li>A number of bug fixes: XPath, validation, Python bindings, DOM andtree,
+ xmlI/O, Html</li>
<li>Serious rewrite of XInclude</li>
- <li>Made XML Schemas regexp part of the default build and APIs, small fix
- and improvement of the regexp core</li>
+ <li>Made XML Schemas regexp part of the default build and APIs, small
+ fixand improvement of the regexp core</li>
<li>Changed the validation code to reuse XML Schemas regexp APIs</li>
- <li>Better handling of Windows file paths, improvement of Makefiles (Igor,
- Daniel Gehriger, Mark Vakoc)</li>
- <li>Improved the python I/O bindings, the tests, added resolver and regexp
- APIs</li>
+ <li>Better handling of Windows file paths, improvement of Makefiles
+ (Igor,Daniel Gehriger, Mark Vakoc)</li>
+ <li>Improved the python I/O bindings, the tests, added resolver and
+ regexpAPIs</li>
<li>New logos from Marc Liyanage</li>
<li>Tutorial improvements: John Fleck, Christopher Harris</li>
- <li>Makefile: Fixes for AMD x86_64 (Mandrake), DESTDIR (Christophe
- Merlet)</li>
+ <li>Makefile: Fixes for AMD x86_64 (Mandrake), DESTDIR
+ (ChristopheMerlet)</li>
<li>removal of all stderr/perror use for error reporting</li>
<li>Better error reporting: XPath and DTD validation</li>
<li>update of the trio portability layer (Bjorn Reese)</li>
@@ -1658,8 +1670,8 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<p><strong>2.4.24: Aug 22 2002</strong></p>
<ul>
<li>XPath fixes (William), xf:escape-uri() (Wesley Terpstra)</li>
- <li>Python binding fixes: makefiles (William), generator, rpm build, x86-64
- (fcrozat)</li>
+ <li>Python binding fixes: makefiles (William), generator, rpm build,
+ x86-64(fcrozat)</li>
<li>HTML &lt;style&gt; and boolean attributes serializer fixes</li>
<li>C14N improvements by Aleksey</li>
<li>doc cleanups: Rick Jones</li>
@@ -1673,38 +1685,37 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p>
<li>c14n fixes, testsuite and performances: Aleksey Sanin</li>
<li>added xmlDocFormatDump: Chema Celorio</li>
<li>new tutorial: John Fleck</li>
- <li>new hash functions and performances: Sander Vesik, portability fix from
- Peter Jacobi</li>
- <li>a number of bug fixes: XPath (William Brack, Richard Jinks), XML and
- HTML parsers, ID lookup function</li>
+ <li>new hash functions and performances: Sander Vesik, portability fix
+ fromPeter Jacobi</li>
+ <li>a number of bug fixes: XPath (William Brack, Richard Jinks), XML
+ andHTML parsers, ID lookup function</li>
<li>removal of all remaining sprintf: Aleksey Sanin</li>
</ul>
<h3>2.4.22: May 27 2002</h3>
<ul>
- <li>a number of bug fixes: configure scripts, base handling, parser, memory
- usage, HTML parser, XPath, documentation (Christian Cornelssen),
- indentation, URI parsing</li>
- <li>Optimizations for XMLSec, fixing and making public some of the network
- protocol handlers (Aleksey)</li>
+ <li>a number of bug fixes: configure scripts, base handling, parser,
+ memoryusage, HTML parser, XPath, documentation (Christian
+ Cornelssen),indentation, URI parsing</li>
+ <li>Optimizations for XMLSec, fixing and making public some of the
+ networkprotocol handlers (Aleksey)</li>
<li>performance patch from Gary Pennington</li>
- <li>Charles Bozeman provided date and time support for XML Schemas
- datatypes</li>
+ <li>Charles Bozeman provided date and time support for XML
+ Schemasdatatypes</li>
</ul>
<h3>2.4.21: Apr 29 2002</h3>
-<p>This release is both a bug fix release and also contains the early XML
-Schemas <a href="http://www.w3.org/TR/xmlschema-1/">structures</a> and <a
-href="http://www.w3.org/TR/xmlschema-2/">datatypes</a> code, beware, all
-interfaces are likely to change, there is huge holes, it is clearly a work in
-progress and don't even think of putting this code in a production system,
-it's actually not compiled in by default. The real fixes are:</p>
+<p>This release is both a bug fix release and also contains the early
+XMLSchemas <a href="http://www.w3.org/TR/xmlschema-1/">structures</a>and <a
+href="http://www.w3.org/TR/xmlschema-2/">datatypes</a>code, beware,
+allinterfaces are likely to change, there is huge holes, it is clearly a work
+inprogress and don't even think of putting this code in a production
+system,it's actually not compiled in by default. The real fixes are:</p>
<ul>
<li>a couple of bugs or limitations introduced in 2.4.20</li>
<li>patches for Borland C++ and MSC by Igor</li>
- <li>some fixes on XPath strings and conformance patches by Richard
- Jinks</li>
+ <li>some fixes on XPath strings and conformance patches by RichardJinks</li>
<li>patch from Aleksey for the ExcC14N specification</li>
<li>OSF/1 bug fix by Bjorn</li>
</ul>
@@ -1713,14 +1724,14 @@ it's actually not compiled in by default. The real fixes are:</p>
<ul>
<li>bug fixes: file descriptor leak, XPath, HTML output, DTD validation</li>
<li>XPath conformance testing by Richard Jinks</li>
- <li>Portability fixes: Solaris, MPE/iX, Windows, OSF/1, python bindings,
- libxml.m4</li>
+ <li>Portability fixes: Solaris, MPE/iX, Windows, OSF/1, python
+ bindings,libxml.m4</li>
</ul>
<h3>2.4.19: Mar 25 2002</h3>
<ul>
- <li>bug fixes: half a dozen XPath bugs, Validation, ISO-Latin to UTF8
- encoder</li>
+ <li>bug fixes: half a dozen XPath bugs, Validation, ISO-Latin to
+ UTF8encoder</li>
<li>portability fixes in the HTTP code</li>
<li>memory allocation checks using valgrind, and profiling tests</li>
<li>revamp of the Windows build and Makefiles</li>
@@ -1728,8 +1739,8 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.4.18: Mar 18 2002</h3>
<ul>
- <li>bug fixes: tree, SAX, canonicalization, validation, portability,
- XPath</li>
+ <li>bug fixes: tree, SAX, canonicalization, validation,
+ portability,XPath</li>
<li>removed the --with-buffer option it was becoming unmaintainable</li>
<li>serious cleanup of the Python makefiles</li>
<li>speedup patch to XPath very effective for DocBook stylesheets</li>
@@ -1738,17 +1749,19 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.4.17: Mar 8 2002</h3>
<ul>
- <li>a lot of bug fixes, including "namespace nodes have no parents in
- XPath"</li>
- <li>fixed/improved the Python wrappers, added more examples and more
- regression tests, XPath extension functions can now return node-sets</li>
+ <li>a lot of bug fixes, including "namespace nodes have no parents
+ inXPath"</li>
+ <li>fixed/improved the Python wrappers, added more examples and
+ moreregression tests, XPath extension functions can now return
+ node-sets</li>
<li>added the XML Canonicalization support from Aleksey Sanin</li>
</ul>
<h3>2.4.16: Feb 20 2002</h3>
<ul>
- <li>a lot of bug fixes, most of them were triggered by the XML Testsuite
- from OASIS and W3C. Compliance has been significantly improved.</li>
+ <li>a lot of bug fixes, most of them were triggered by the XML
+ Testsuitefrom OASIS and W3C. Compliance has been significantly
+ improved.</li>
<li>a couple of portability fixes too.</li>
</ul>
@@ -1762,40 +1775,40 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.4.14: Feb 8 2002</h3>
<ul>
<li>Change of License to the <a
- href="http://www.opensource.org/licenses/mit-license.html">MIT
- License</a> basically for integration in XFree86 codebase, and removing
- confusion around the previous dual-licensing</li>
- <li>added Python bindings, beta software but should already be quite
- complete</li>
- <li>a large number of fixes and cleanups, especially for all tree
- manipulations</li>
- <li>cleanup of the headers, generation of a reference API definition in
- XML</li>
+ href="http://www.opensource.org/licenses/mit-license.html">MITLicense</a>basically
+ for integration in XFree86 codebase, and removingconfusion around the
+ previous dual-licensing</li>
+ <li>added Python bindings, beta software but should already be
+ quitecomplete</li>
+ <li>a large number of fixes and cleanups, especially for all
+ treemanipulations</li>
+ <li>cleanup of the headers, generation of a reference API definition
+ inXML</li>
</ul>
<h3>2.4.13: Jan 14 2002</h3>
<ul>
<li>update of the documentation: John Fleck and Charlie Bozeman</li>
<li>cleanup of timing code from Justin Fletcher</li>
- <li>fixes for Windows and initial thread support on Win32: Igor and Serguei
- Narojnyi</li>
+ <li>fixes for Windows and initial thread support on Win32: Igor and
+ SergueiNarojnyi</li>
<li>Cygwin patch from Robert Collins</li>
<li>added xmlSetEntityReferenceFunc() for Keith Isdale work on xsldbg</li>
</ul>
<h3>2.4.12: Dec 7 2001</h3>
<ul>
- <li>a few bug fixes: thread (Gary Pennington), xmllint (Geert Kloosterman),
- XML parser (Robin Berjon), XPointer (Danny Jamshy), I/O cleanups
- (robert)</li>
+ <li>a few bug fixes: thread (Gary Pennington), xmllint (Geert
+ Kloosterman),XML parser (Robin Berjon), XPointer (Danny Jamshy), I/O
+ cleanups(robert)</li>
<li>Eric Lavigne contributed project files for MacOS</li>
<li>some makefiles cleanups</li>
</ul>
<h3>2.4.11: Nov 26 2001</h3>
<ul>
- <li>fixed a couple of errors in the includes, fixed a few bugs, some code
- cleanups</li>
+ <li>fixed a couple of errors in the includes, fixed a few bugs, some
+ codecleanups</li>
<li>xmllint man pages improvement by Heiko Rupp</li>
<li>updated VMS build instructions from John A Fotheringham</li>
<li>Windows Makefiles updates from Igor</li>
@@ -1806,8 +1819,8 @@ it's actually not compiled in by default. The real fixes are:</p>
<li>URI escaping fix (Joel Young)</li>
<li>added xmlGetNodePath() (for paths or XPointers generation)</li>
<li>Fixes namespace handling problems when using DTD and validation</li>
- <li>improvements on xmllint: Morus Walter patches for --format and
- --encode, Stefan Kost and Heiko Rupp improvements on the --shell</li>
+ <li>improvements on xmllint: Morus Walter patches for --format and--encode,
+ Stefan Kost and Heiko Rupp improvements on the --shell</li>
<li>fixes for xmlcatalog linking pointed by Weiqi Gao</li>
<li>fixes to the HTML parser</li>
</ul>
@@ -1820,8 +1833,8 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.4.8: Nov 4 2001</h3>
<ul>
- <li>fixed SGML catalogs broken in previous release, updated xmlcatalog
- tool</li>
+ <li>fixed SGML catalogs broken in previous release, updated
+ xmlcatalogtool</li>
<li>fixed a compile errors and some includes troubles.</li>
</ul>
@@ -1829,8 +1842,8 @@ it's actually not compiled in by default. The real fixes are:</p>
<ul>
<li>exported some debugging interfaces</li>
<li>serious rewrite of the catalog code</li>
- <li>integrated Gary Pennington thread safety patch, added configure option
- and regression tests</li>
+ <li>integrated Gary Pennington thread safety patch, added configure
+ optionand regression tests</li>
<li>removed an HTML parser bug</li>
<li>fixed a couple of potentially serious validation bugs</li>
<li>integrated the SGML DocBook support in xmllint</li>
@@ -1854,20 +1867,19 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.4.5: Sep 14 2001</h3>
<ul>
<li>Remove a few annoying bugs in 2.4.4</li>
- <li>forces the HTML serializer to output decimal charrefs since some
- version of Netscape can't handle hexadecimal ones</li>
+ <li>forces the HTML serializer to output decimal charrefs since someversion
+ of Netscape can't handle hexadecimal ones</li>
</ul>
<h3>1.8.16: Sep 14 2001</h3>
<ul>
- <li>maintenance release of the old libxml1 branch, couple of bug and
- portability fixes</li>
+ <li>maintenance release of the old libxml1 branch, couple of bug
+ andportability fixes</li>
</ul>
<h3>2.4.4: Sep 12 2001</h3>
<ul>
- <li>added --convert to xmlcatalog, bug fixes and cleanups of XML
- Catalog</li>
+ <li>added --convert to xmlcatalog, bug fixes and cleanups of XMLCatalog</li>
<li>a few bug fixes and some portability changes</li>
<li>some documentation cleanups</li>
</ul>
@@ -1901,17 +1913,17 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.4.0: July 10 2001</h3>
<ul>
<li>Fixed a few bugs in XPath, validation, and tree handling.</li>
- <li>Fixed XML Base implementation, added a couple of examples to the
- regression tests</li>
+ <li>Fixed XML Base implementation, added a couple of examples to
+ theregression tests</li>
<li>A bit of cleanup</li>
</ul>
<h3>2.3.14: July 5 2001</h3>
<ul>
- <li>fixed some entities problems and reduce memory requirement when
- substituting them</li>
- <li>lots of improvements in the XPath queries interpreter can be
- substantially faster</li>
+ <li>fixed some entities problems and reduce memory requirement
+ whensubstituting them</li>
+ <li>lots of improvements in the XPath queries interpreter can
+ besubstantially faster</li>
<li>Makefiles and configure cleanups</li>
<li>Fixes to XPath variable eval, and compare on empty node set</li>
<li>HTML tag closing bug fixed</li>
@@ -1937,26 +1949,27 @@ it's actually not compiled in by default. The real fixes are:</p>
<li>fixed line number counting</li>
<li>fixed serious problems in the XInclude processing</li>
<li>added support for UTF8 BOM at beginning of entities</li>
- <li>fixed a strange gcc optimizer bugs in xpath handling of float, gcc-3.0
- miscompile uri.c (William), Thomas Leitner provided a fix for the
- optimizer on Tru64</li>
- <li>incorporated Yon Derek and Igor Zlatkovic fixes and improvements for
- compilation on Windows MSC</li>
+ <li>fixed a strange gcc optimizer bugs in xpath handling of float,
+ gcc-3.0miscompile uri.c (William), Thomas Leitner provided a fix for
+ theoptimizer on Tru64</li>
+ <li>incorporated Yon Derek and Igor Zlatkovic fixes and improvements
+ forcompilation on Windows MSC</li>
<li>update of libxml-doc.el (Felix Natter)</li>
<li>fixed 2 bugs in URI normalization code</li>
</ul>
<h3>2.3.11: June 17 2001</h3>
<ul>
- <li>updates to trio, Makefiles and configure should fix some portability
- problems (alpha)</li>
- <li>fixed some HTML serialization problems (pre, script, and block/inline
- handling), added encoding aware APIs, cleanup of this code</li>
+ <li>updates to trio, Makefiles and configure should fix some
+ portabilityproblems (alpha)</li>
+ <li>fixed some HTML serialization problems (pre, script, and
+ block/inlinehandling), added encoding aware APIs, cleanup of this
+ code</li>
<li>added xmlHasNsProp()</li>
- <li>implemented a specific PI for encoding support in the DocBook SGML
- parser</li>
- <li>some XPath fixes (-Infinity, / as a function parameter and namespaces
- node selection)</li>
+ <li>implemented a specific PI for encoding support in the DocBook
+ SGMLparser</li>
+ <li>some XPath fixes (-Infinity, / as a function parameter and
+ namespacesnode selection)</li>
<li>fixed a performance problem and an error in the validation code</li>
<li>fixed XInclude routine to implement the recursive behaviour</li>
<li>fixed xmlFreeNode problem when libxml is included statically twice</li>
@@ -1966,8 +1979,8 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.3.10: June 1 2001</h3>
<ul>
<li>fixed the SGML catalog support</li>
- <li>a number of reported bugs got fixed, in XPath, iconv detection,
- XInclude processing</li>
+ <li>a number of reported bugs got fixed, in XPath, iconv detection,XInclude
+ processing</li>
<li>XPath string function should now handle unicode correctly</li>
</ul>
@@ -1980,8 +1993,8 @@ it's actually not compiled in by default. The real fixes are:</p>
<li>some documentation cleanups</li>
<li>trying to get better linking on Solaris (-R)</li>
<li>XPath API cleanup from Thomas Broyer</li>
- <li>Validation bug fixed #54631, added a patch from Gary Pennington, fixed
- xmlValidGetValidElements()</li>
+ <li>Validation bug fixed #54631, added a patch from Gary Pennington,
+ fixedxmlValidGetValidElements()</li>
<li>Added an INSTALL file</li>
<li>Attribute removal added to API: #54433</li>
<li>added a basic support for SGML catalogs</li>
@@ -2000,10 +2013,10 @@ it's actually not compiled in by default. The real fixes are:</p>
<ul>
<li>Integrated an SGML DocBook parser for the Gnome project</li>
<li>Fixed a few things in the HTML parser</li>
- <li>Fixed some XPath bugs raised by XSLT use, tried to fix the floating
- point portability issue</li>
- <li>Speed improvement (8M/s for SAX, 3M/s for DOM, 1.5M/s for
- DOM+validation using the XML REC as input and a 700MHz celeron).</li>
+ <li>Fixed some XPath bugs raised by XSLT use, tried to fix the
+ floatingpoint portability issue</li>
+ <li>Speed improvement (8M/s for SAX, 3M/s for DOM, 1.5M/s forDOM+validation
+ using the XML REC as input and a 700MHz celeron).</li>
<li>incorporated more Windows cleanup</li>
<li>added xmlSaveFormatFile()</li>
<li>fixed problems in copying nodes with entities references (gdome)</li>
@@ -2026,40 +2039,41 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.3.6: April 8 2001</h3>
<ul>
- <li>Code cleanup using extreme gcc compiler warning options, found and
- cleared half a dozen potential problem</li>
+ <li>Code cleanup using extreme gcc compiler warning options, found
+ andcleared half a dozen potential problem</li>
<li>the Eazel team found an XML parser bug</li>
- <li>cleaned up the user of some of the string formatting function. used the
- trio library code to provide the one needed when the platform is missing
- them</li>
- <li>xpath: removed a memory leak and fixed the predicate evaluation
- problem, extended the testsuite and cleaned up the result. XPointer seems
- broken ...</li>
+ <li>cleaned up the user of some of the string formatting function. used
+ thetrio library code to provide the one needed when the platform is
+ missingthem</li>
+ <li>xpath: removed a memory leak and fixed the predicate evaluationproblem,
+ extended the testsuite and cleaned up the result. XPointer seemsbroken
+ ...</li>
</ul>
<h3>2.3.5: Mar 23 2001</h3>
<ul>
- <li>Biggest change is separate parsing and evaluation of XPath expressions,
- there is some new APIs for this too</li>
- <li>included a number of bug fixes(XML push parser, 51876, notations,
- 52299)</li>
+ <li>Biggest change is separate parsing and evaluation of XPath
+ expressions,there is some new APIs for this too</li>
+ <li>included a number of bug fixes(XML push parser, 51876,
+ notations,52299)</li>
<li>Fixed some portability issues</li>
</ul>
<h3>2.3.4: Mar 10 2001</h3>
<ul>
<li>Fixed bugs #51860 and #51861</li>
- <li>Added a global variable xmlDefaultBufferSize to allow default buffer
- size to be application tunable.</li>
- <li>Some cleanup in the validation code, still a bug left and this part
- should probably be rewritten to support ambiguous content model :-\</li>
- <li>Fix a couple of serious bugs introduced or raised by changes in 2.3.3
- parser</li>
+ <li>Added a global variable xmlDefaultBufferSize to allow default
+ buffersize to be application tunable.</li>
+ <li>Some cleanup in the validation code, still a bug left and this
+ partshould probably be rewritten to support ambiguous content model
+ :-\</li>
+ <li>Fix a couple of serious bugs introduced or raised by changes in
+ 2.3.3parser</li>
<li>Fixed another bug in xmlNodeGetContent()</li>
<li>Bjorn fixed XPath node collection and Number formatting</li>
<li>Fixed a loop reported in the HTML parsing</li>
- <li>blank space are reported even if the Dtd content model proves that they
- are formatting spaces, this is for XML conformance</li>
+ <li>blank space are reported even if the Dtd content model proves that
+ theyare formatting spaces, this is for XML conformance</li>
</ul>
<h3>2.3.3: Mar 1 2001</h3>
@@ -2081,22 +2095,22 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.3.1: Feb 15 2001</h3>
<ul>
<li>some XPath and HTML bug fixes for XSLT</li>
- <li>small extension of the hash table interfaces for DOM gdome2
- implementation</li>
+ <li>small extension of the hash table interfaces for DOM
+ gdome2implementation</li>
<li>A few bug fixes</li>
</ul>
<h3>2.3.0: Feb 8 2001 (2.2.12 was on 25 Jan but I didn't kept track)</h3>
<ul>
<li>Lots of XPath bug fixes</li>
- <li>Add a mode with Dtd lookup but without validation error reporting for
- XSLT</li>
+ <li>Add a mode with Dtd lookup but without validation error reporting
+ forXSLT</li>
<li>Add support for text node without escaping (XSLT)</li>
<li>bug fixes for xmlCheckFilename</li>
<li>validation code bug fixes from Gary Pennington</li>
<li>Patch from Paul D. Smith correcting URI path normalization</li>
- <li>Patch to allow simultaneous install of libxml-devel and
- libxml2-devel</li>
+ <li>Patch to allow simultaneous install of libxml-devel
+ andlibxml2-devel</li>
<li>the example Makefile is now fixed</li>
<li>added HTML to the RPM packages</li>
<li>tree copying bugfixes</li>
@@ -2129,8 +2143,8 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.2.8: Nov 13 2000</h3>
<ul>
- <li>First version of <a href="http://www.w3.org/TR/xinclude">XInclude</a>
- support</li>
+ <li>First version of <a
+ href="http://www.w3.org/TR/xinclude">XInclude</a>support</li>
<li>Patch in conditional section handling</li>
<li>updated MS compiler project</li>
<li>fixed some XPath problems</li>
@@ -2149,12 +2163,12 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.2.6: Oct 25 2000:</h3>
<ul>
- <li>Added an hash table module, migrated a number of internal structure to
- those</li>
+ <li>Added an hash table module, migrated a number of internal structure
+ tothose</li>
<li>Fixed a posteriori validation problems</li>
<li>HTTP module cleanups</li>
- <li>HTML parser improvements (tag errors, script/style handling, attribute
- normalization)</li>
+ <li>HTML parser improvements (tag errors, script/style handling,
+ attributenormalization)</li>
<li>coalescing of adjacent text nodes</li>
<li>couple of XPath bug fixes, exported the internal API</li>
</ul>
@@ -2162,10 +2176,10 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.2.5: Oct 15 2000:</h3>
<ul>
<li>XPointer implementation and testsuite</li>
- <li>Lot of XPath fixes, added variable and functions registration, more
- tests</li>
- <li>Portability fixes, lots of enhancements toward an easy Windows build
- and release</li>
+ <li>Lot of XPath fixes, added variable and functions registration,
+ moretests</li>
+ <li>Portability fixes, lots of enhancements toward an easy Windows buildand
+ release</li>
<li>Late validation fixes</li>
<li>Integrated a lot of contributed patches</li>
<li>added memory management docs</li>
@@ -2183,10 +2197,10 @@ it's actually not compiled in by default. The real fixes are:</p>
<ul>
<li>bug fixes</li>
<li>cleanup of entity handling code</li>
- <li>overall review of all loops in the parsers, all sprintf usage has been
- checked too</li>
- <li>Far better handling of larges Dtd. Validating against DocBook XML Dtd
- works smoothly now.</li>
+ <li>overall review of all loops in the parsers, all sprintf usage has
+ beenchecked too</li>
+ <li>Far better handling of larges Dtd. Validating against DocBook XML
+ Dtdworks smoothly now.</li>
</ul>
<h3>1.8.10: Sep 6 2000</h3>
@@ -2205,29 +2219,29 @@ it's actually not compiled in by default. The real fixes are:</p>
<li>a purely bug fixes release</li>
<li>fixed an encoding support problem when parsing from a memory block</li>
<li>fixed a DOCTYPE parsing problem</li>
- <li>removed a bug in the function allowing to override the memory
- allocation routines</li>
+ <li>removed a bug in the function allowing to override the memoryallocation
+ routines</li>
</ul>
<h3>2.2.0: July 14 2000</h3>
<ul>
<li>applied a lot of portability fixes</li>
- <li>better encoding support/cleanup and saving (content is now always
- encoded in UTF-8)</li>
+ <li>better encoding support/cleanup and saving (content is now
+ alwaysencoded in UTF-8)</li>
<li>the HTML parser now correctly handles encodings</li>
<li>added xmlHasProp()</li>
<li>fixed a serious problem with &amp;#38;</li>
<li>propagated the fix to FTP client</li>
<li>cleanup, bugfixes, etc ...</li>
- <li>Added a page about <a href="encoding.html">libxml Internationalization
- support</a></li>
+ <li>Added a page about <a href="encoding.html">libxml
+ Internationalizationsupport</a></li>
</ul>
<h3>1.8.9: July 9 2000</h3>
<ul>
<li>fixed the spec the RPMs should be better</li>
- <li>fixed a serious bug in the FTP implementation, released 1.8.9 to solve
- rpmfind users problem</li>
+ <li>fixed a serious bug in the FTP implementation, released 1.8.9 to
+ solverpmfind users problem</li>
</ul>
<h3>2.1.1: July 1 2000</h3>
@@ -2238,17 +2252,17 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.1.0 and 1.8.8: June 29 2000</h3>
<ul>
- <li>1.8.8 is mostly a commodity package for upgrading to libxml2 according
- to <a href="upgrade.html">new instructions</a>. It fixes a nasty problem
- about &amp;#38; charref parsing</li>
- <li>2.1.0 also ease the upgrade from libxml v1 to the recent version. it
- also contains numerous fixes and enhancements:
+ <li>1.8.8 is mostly a commodity package for upgrading to libxml2
+ accordingto <a href="upgrade.html">new instructions</a>. It fixes a nasty
+ problemabout &amp;#38; charref parsing</li>
+ <li>2.1.0 also ease the upgrade from libxml v1 to the recent version.
+ italso contains numerous fixes and enhancements:
<ul>
<li>added xmlStopParser() to stop parsing</li>
<li>improved a lot parsing speed when there is large CDATA blocs</li>
<li>includes XPath patches provided by Picdar Technology</li>
- <li>tried to fix as much as possible DTD validation and namespace
- related problems</li>
+ <li>tried to fix as much as possible DTD validation and
+ namespacerelated problems</li>
<li>output to a given encoding has been added/tested</li>
<li>lot of various fixes</li>
</ul>
@@ -2257,96 +2271,97 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>2.0.0: Apr 12 2000</h3>
<ul>
- <li>First public release of libxml2. If you are using libxml, it's a good
- idea to check the 1.x to 2.x upgrade instructions. NOTE: while initially
- scheduled for Apr 3 the release occurred only on Apr 12 due to massive
- workload.</li>
- <li>The include are now located under $prefix/include/libxml (instead of
- $prefix/include/gnome-xml), they also are referenced by
+ <li>First public release of libxml2. If you are using libxml, it's a
+ goodidea to check the 1.x to 2.x upgrade instructions. NOTE: while
+ initiallyscheduled for Apr 3 the release occurred only on Apr 12 due to
+ massiveworkload.</li>
+ <li>The include are now located under $prefix/include/libxml (instead
+ of$prefix/include/gnome-xml), they also are referenced by
<pre>#include &lt;libxml/xxx.h&gt;</pre>
<p>instead of</p>
<pre>#include "xxx.h"</pre>
</li>
<li>a new URI module for parsing URIs and following strictly RFC 2396</li>
- <li>the memory allocation routines used by libxml can now be overloaded
- dynamically by using xmlMemSetup()</li>
- <li>The previously CVS only tool tester has been renamed
- <strong>xmllint</strong> and is now installed as part of the libxml2
- package</li>
- <li>The I/O interface has been revamped. There is now ways to plug in
- specific I/O modules, either at the URI scheme detection level using
- xmlRegisterInputCallbacks() or by passing I/O functions when creating a
- parser context using xmlCreateIOParserCtxt()</li>
- <li>there is a C preprocessor macro LIBXML_VERSION providing the version
- number of the libxml module in use</li>
- <li>a number of optional features of libxml can now be excluded at
- configure time (FTP/HTTP/HTML/XPath/Debug)</li>
+ <li>the memory allocation routines used by libxml can now be
+ overloadeddynamically by using xmlMemSetup()</li>
+ <li>The previously CVS only tool tester has been
+ renamed<strong>xmllint</strong>and is now installed as part of the
+ libxml2package</li>
+ <li>The I/O interface has been revamped. There is now ways to plug
+ inspecific I/O modules, either at the URI scheme detection level
+ usingxmlRegisterInputCallbacks() or by passing I/O functions when
+ creating aparser context using xmlCreateIOParserCtxt()</li>
+ <li>there is a C preprocessor macro LIBXML_VERSION providing the
+ versionnumber of the libxml module in use</li>
+ <li>a number of optional features of libxml can now be excluded atconfigure
+ time (FTP/HTTP/HTML/XPath/Debug)</li>
</ul>
<h3>2.0.0beta: Mar 14 2000</h3>
<ul>
<li>This is a first Beta release of libxml version 2</li>
- <li>It's available only from<a href="ftp://xmlsoft.org/libxml2/">xmlsoft.org
- FTP</a>, it's packaged as libxml2-2.0.0beta and available as tar and
- RPMs</li>
- <li>This version is now the head in the Gnome CVS base, the old one is
- available under the tag LIB_XML_1_X</li>
- <li>This includes a very large set of changes. From a programmatic point
- of view applications should not have to be modified too much, check the
- <a href="upgrade.html">upgrade page</a></li>
+ <li>It's available only from<a
+ href="ftp://xmlsoft.org/libxml2/">xmlsoft.orgFTP</a>, it's packaged as
+ libxml2-2.0.0beta and available as tar andRPMs</li>
+ <li>This version is now the head in the Gnome CVS base, the old one
+ isavailable under the tag LIB_XML_1_X</li>
+ <li>This includes a very large set of changes. From a programmatic pointof
+ view applications should not have to be modified too much, check the<a
+ href="upgrade.html">upgrade page</a></li>
<li>Some interfaces may changes (especially a bit about encoding).</li>
<li>the updates includes:
<ul>
- <li>fix I18N support. ISO-Latin-x/UTF-8/UTF-16 (nearly) seems correctly
- handled now</li>
- <li>Better handling of entities, especially well-formedness checking
- and proper PEref extensions in external subsets</li>
+ <li>fix I18N support. ISO-Latin-x/UTF-8/UTF-16 (nearly) seems
+ correctlyhandled now</li>
+ <li>Better handling of entities, especially well-formedness checkingand
+ proper PEref extensions in external subsets</li>
<li>DTD conditional sections</li>
<li>Validation now correctly handle entities content</li>
- <li><a href="http://rpmfind.net/tools/gdome/messages/0039.html">change
- structures to accommodate DOM</a></li>
+ <li><a
+ href="http://rpmfind.net/tools/gdome/messages/0039.html">changestructures
+ to accommodate DOM</a></li>
</ul>
</li>
<li>Serious progress were made toward compliance, <a
- href="conf/result.html">here are the result of the test</a> against the
- OASIS testsuite (except the Japanese tests since I don't support that
- encoding yet). This URL is rebuilt every couple of hours using the CVS
- head version.</li>
+ href="conf/result.html">here are the result of the test</a>against
+ theOASIS testsuite (except the Japanese tests since I don't support
+ thatencoding yet). This URL is rebuilt every couple of hours using the
+ CVShead version.</li>
</ul>
<h3>1.8.7: Mar 6 2000</h3>
<ul>
<li>This is a bug fix release:</li>
- <li>It is possible to disable the ignorable blanks heuristic used by
- libxml-1.x, a new function xmlKeepBlanksDefault(0) will allow this. Note
- that for adherence to XML spec, this behaviour will be disabled by
- default in 2.x . The same function will allow to keep compatibility for
- old code.</li>
- <li>Blanks in &lt;a&gt; &lt;/a&gt; constructs are not ignored anymore,
- avoiding heuristic is really the Right Way :-\</li>
- <li>The unchecked use of snprintf which was breaking libxml-1.8.6
- compilation on some platforms has been fixed</li>
- <li>nanoftp.c nanohttp.c: Fixed '#' and '?' stripping when processing
- URIs</li>
+ <li>It is possible to disable the ignorable blanks heuristic used
+ bylibxml-1.x, a new function xmlKeepBlanksDefault(0) will allow this.
+ Notethat for adherence to XML spec, this behaviour will be disabled
+ bydefault in 2.x . The same function will allow to keep compatibility
+ forold code.</li>
+ <li>Blanks in &lt;a&gt; &lt;/a&gt; constructs are not ignored
+ anymore,avoiding heuristic is really the Right Way :-\</li>
+ <li>The unchecked use of snprintf which was breaking
+ libxml-1.8.6compilation on some platforms has been fixed</li>
+ <li>nanoftp.c nanohttp.c: Fixed '#' and '?' stripping when
+ processingURIs</li>
</ul>
<h3>1.8.6: Jan 31 2000</h3>
<ul>
<li>added a nanoFTP transport module, debugged until the new version of <a
- href="http://rpmfind.net/linux/rpm2html/rpmfind.html">rpmfind</a> can use
- it without troubles</li>
+ href="http://rpmfind.net/linux/rpm2html/rpmfind.html">rpmfind</a>can
+ useit without troubles</li>
</ul>
<h3>1.8.5: Jan 21 2000</h3>
<ul>
<li>adding APIs to parse a well balanced chunk of XML (production <a
- href="http://www.w3.org/TR/REC-xml#NT-content">[43] content</a> of the
- XML spec)</li>
+ href="http://www.w3.org/TR/REC-xml#NT-content">[43] content</a>of theXML
+ spec)</li>
<li>fixed a hideous bug in xmlGetProp pointed by Rune.Djurhuus@fast.no</li>
- <li>Jody Goldberg &lt;jgoldberg@home.com&gt; provided another patch trying
- to solve the zlib checks problems</li>
- <li>The current state in gnome CVS base is expected to ship as 1.8.5 with
- gnumeric soon</li>
+ <li>Jody Goldberg &lt;jgoldberg@home.com&gt; provided another patch
+ tryingto solve the zlib checks problems</li>
+ <li>The current state in gnome CVS base is expected to ship as 1.8.5
+ withgnumeric soon</li>
</ul>
<h3>1.8.4: Jan 13 2000</h3>
@@ -2365,45 +2380,46 @@ it's actually not compiled in by default. The real fixes are:</p>
<li>fixed the DTD parsing code to work with the xhtml DTD</li>
<li>added xmlRemoveProp(), xmlRemoveID() and xmlRemoveRef()</li>
<li>Fixed bugs in xmlNewNs()</li>
- <li>External entity loading code has been revamped, now it uses
- xmlLoadExternalEntity(), some fix on entities processing were added</li>
+ <li>External entity loading code has been revamped, now it
+ usesxmlLoadExternalEntity(), some fix on entities processing were
+ added</li>
<li>cleaned up WIN32 includes of socket stuff</li>
</ul>
<h3>1.8.2: Dec 21 1999</h3>
<ul>
- <li>I got another problem with includes and C++, I hope this issue is fixed
- for good this time</li>
- <li>Added a few tree modification functions: xmlReplaceNode,
- xmlAddPrevSibling, xmlAddNextSibling, xmlNodeSetName and
- xmlDocSetRootElement</li>
+ <li>I got another problem with includes and C++, I hope this issue is
+ fixedfor good this time</li>
+ <li>Added a few tree modification functions:
+ xmlReplaceNode,xmlAddPrevSibling, xmlAddNextSibling, xmlNodeSetName
+ andxmlDocSetRootElement</li>
<li>Tried to improve the HTML output with help from <a
href="mailto:clahey@umich.edu">Chris Lahey</a></li>
</ul>
<h3>1.8.1: Dec 18 1999</h3>
<ul>
- <li>various patches to avoid troubles when using libxml with C++ compilers
- the "namespace" keyword and C escaping in include files</li>
+ <li>various patches to avoid troubles when using libxml with C++
+ compilersthe "namespace" keyword and C escaping in include files</li>
<li>a problem in one of the core macros IS_CHAR was corrected</li>
- <li>fixed a bug introduced in 1.8.0 breaking default namespace processing,
- and more specifically the Dia application</li>
- <li>fixed a posteriori validation (validation after parsing, or by using a
- Dtd not specified in the original document)</li>
+ <li>fixed a bug introduced in 1.8.0 breaking default namespace
+ processing,and more specifically the Dia application</li>
+ <li>fixed a posteriori validation (validation after parsing, or by using
+ aDtd not specified in the original document)</li>
<li>fixed a bug in</li>
</ul>
<h3>1.8.0: Dec 12 1999</h3>
<ul>
<li>cleanup, especially memory wise</li>
- <li>the parser should be more reliable, especially the HTML one, it should
- not crash, whatever the input !</li>
- <li>Integrated various patches, especially a speedup improvement for large
- dataset from <a href="mailto:cnygard@bellatlantic.net">Carl Nygard</a>,
- configure with --with-buffers to enable them.</li>
+ <li>the parser should be more reliable, especially the HTML one, it
+ shouldnot crash, whatever the input !</li>
+ <li>Integrated various patches, especially a speedup improvement for
+ largedataset from <a href="mailto:cnygard@bellatlantic.net">Carl
+ Nygard</a>,configure with --with-buffers to enable them.</li>
<li>attribute normalization, oops should have been added long ago !</li>
- <li>attributes defaulted from DTDs should be available, xmlSetProp() now
- does entities escaping by default.</li>
+ <li>attributes defaulted from DTDs should be available, xmlSetProp()
+ nowdoes entities escaping by default.</li>
</ul>
<h3>1.7.4: Oct 25 1999</h3>
@@ -2417,40 +2433,40 @@ it's actually not compiled in by default. The real fixes are:</p>
<h3>1.7.3: Sep 29 1999</h3>
<ul>
<li>portability problems fixed</li>
- <li>snprintf was used unconditionally, leading to link problems on system
- were it's not available, fixed</li>
+ <li>snprintf was used unconditionally, leading to link problems on
+ systemwere it's not available, fixed</li>
</ul>
<h3>1.7.1: Sep 24 1999</h3>
<ul>
- <li>The basic type for strings manipulated by libxml has been renamed in
- 1.7.1 from <strong>CHAR</strong> to <strong>xmlChar</strong>. The reason
- is that CHAR was conflicting with a predefined type on Windows. However
- on non WIN32 environment, compatibility is provided by the way of a
- <strong>#define </strong>.</li>
- <li>Changed another error : the use of a structure field called errno, and
- leading to troubles on platforms where it's a macro</li>
+ <li>The basic type for strings manipulated by libxml has been renamed
+ in1.7.1 from <strong>CHAR</strong>to <strong>xmlChar</strong>. The
+ reasonis that CHAR was conflicting with a predefined type on Windows.
+ Howeveron non WIN32 environment, compatibility is provided by the way of
+ a<strong>#define </strong>.</li>
+ <li>Changed another error : the use of a structure field called errno,
+ andleading to troubles on platforms where it's a macro</li>
</ul>
<h3>1.7.0: Sep 23 1999</h3>
<ul>
<li>Added the ability to fetch remote DTD or parsed entities, see the <a
- href="html/libxml-nanohttp.html">nanohttp</a> module.</li>
- <li>Added an errno to report errors by another mean than a simple printf
- like callback</li>
+ href="html/libxml-nanohttp.html">nanohttp</a>module.</li>
+ <li>Added an errno to report errors by another mean than a simple
+ printflike callback</li>
<li>Finished ID/IDREF support and checking when validation</li>
<li>Serious memory leaks fixed (there is now a <a
- href="html/libxml-xmlmemory.html">memory wrapper</a> module)</li>
- <li>Improvement of <a href="http://www.w3.org/TR/xpath">XPath</a>
- implementation</li>
+ href="html/libxml-xmlmemory.html">memory wrapper</a>module)</li>
+ <li>Improvement of <a
+ href="http://www.w3.org/TR/xpath">XPath</a>implementation</li>
<li>Added an HTML parser front-end</li>
</ul>
<h2><a name="XML">XML</a></h2>
-<p><a href="http://www.w3.org/TR/REC-xml">XML is a standard</a> for
-markup-based structured documents. Here is <a name="example">an example XML
-document</a>:</p>
+<p><a href="http://www.w3.org/TR/REC-xml">XML is a
+standard</a>formarkup-based structured documents. Here is <a
+name="example">an example XMLdocument</a>:</p>
<pre>&lt;?xml version="1.0"?&gt;
&lt;EXAMPLE prop1="gnome is great" prop2="&amp;amp; linux too"&gt;
&lt;head&gt;
@@ -2464,141 +2480,139 @@ document</a>:</p>
&lt;/chapter&gt;
&lt;/EXAMPLE&gt;</pre>
-<p>The first line specifies that it is an XML document and gives useful
-information about its encoding. Then the rest of the document is a text
-format whose structure is specified by tags between brackets. <strong>Each
-tag opened has to be closed</strong>. XML is pedantic about this. However, if
-a tag is empty (no content), a single tag can serve as both the opening and
-closing tag if it ends with <code>/&gt;</code> rather than with
-<code>&gt;</code>. Note that, for example, the image tag has no content (just
-an attribute) and is closed by ending the tag with <code>/&gt;</code>.</p>
-
-<p>XML can be applied successfully to a wide range of tasks, ranging from
-long term structured document maintenance (where it follows the steps of
-SGML) to simple data encoding mechanisms like configuration file formatting
-(glade), spreadsheets (gnumeric), or even shorter lived documents such as
-WebDAV where it is used to encode remote calls between a client and a
-server.</p>
+<p>The first line specifies that it is an XML document and gives
+usefulinformation about its encoding. Then the rest of the document is a
+textformat whose structure is specified by tags between brackets.
+<strong>Eachtag opened has to be closed</strong>. XML is pedantic about this.
+However, ifa tag is empty (no content), a single tag can serve as both the
+opening andclosing tag if it ends with <code>/&gt;</code>rather than
+with<code>&gt;</code>. Note that, for example, the image tag has no content
+(justan attribute) and is closed by ending the tag with
+<code>/&gt;</code>.</p>
+
+<p>XML can be applied successfully to a wide range of tasks, ranging fromlong
+term structured document maintenance (where it follows the steps ofSGML) to
+simple data encoding mechanisms like configuration file formatting(glade),
+spreadsheets (gnumeric), or even shorter lived documents such asWebDAV where
+it is used to encode remote calls between a client and aserver.</p>
<h2><a name="XSLT">XSLT</a></h2>
<p>Check <a href="http://xmlsoft.org/XSLT">the separate libxslt page</a></p>
-<p><a href="http://www.w3.org/TR/xslt">XSL Transformations</a>, is a
-language for transforming XML documents into other XML documents (or
-HTML/textual output).</p>
+<p><a href="http://www.w3.org/TR/xslt">XSL Transformations</a>, is alanguage
+for transforming XML documents into other XML documents (orHTML/textual
+output).</p>
-<p>A separate library called libxslt is available implementing XSLT-1.0 for
-libxml2. This module "libxslt" too can be found in the Gnome CVS base.</p>
+<p>A separate library called libxslt is available implementing XSLT-1.0
+forlibxml2. This module "libxslt" too can be found in the Gnome CVS base.</p>
<p>You can check the progresses on the libxslt <a
href="http://xmlsoft.org/XSLT/ChangeLog.html">Changelog</a>.</p>
<h2><a name="Python">Python and bindings</a></h2>
-<p>There are a number of language bindings and wrappers available for
-libxml2, the list below is not exhaustive. Please contact the <a
-href="http://mail.gnome.org/mailman/listinfo/xml-bindings">xml-bindings@gnome.org</a>
-(<a href="http://mail.gnome.org/archives/xml-bindings/">archives</a>) in
-order to get updates to this list or to discuss the specific topic of libxml2
-or libxslt wrappers or bindings:</p>
-<ul>
- <li><a href="http://libxmlplusplus.sourceforge.net/">Libxml++</a> seems the
- most up-to-date C++ bindings for libxml2, check the <a
- href="http://libxmlplusplus.sourceforge.net/reference/html/hierarchy.html">documentation</a>
- and the <a
+<p>There are a number of language bindings and wrappers available forlibxml2,
+the list below is not exhaustive. Please contact the <a
+href="http://mail.gnome.org/mailman/listinfo/xml-bindings">xml-bindings@gnome.org</a>(<a
+href="http://mail.gnome.org/archives/xml-bindings/">archives</a>) inorder to
+get updates to this list or to discuss the specific topic of libxml2or
+libxslt wrappers or bindings:</p>
+<ul>
+ <li><a href="http://libxmlplusplus.sourceforge.net/">Libxml++</a>seems
+ themost up-to-date C++ bindings for libxml2, check the <a
+ href="http://libxmlplusplus.sourceforge.net/reference/html/hierarchy.html">documentation</a>and
+ the <a
href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/libxmlplusplus/libxml%2b%2b/examples/">examples</a>.</li>
- <li>There is another <a href="http://libgdome-cpp.berlios.de/">C++ wrapper
- based on the gdome2 bindings</a> maintained by Tobias Peters.</li>
+ <li>There is another <a href="http://libgdome-cpp.berlios.de/">C++
+ wrapperbased on the gdome2 bindings</a>maintained by Tobias Peters.</li>
<li>and a third C++ wrapper by Peter Jones &lt;pjones@pmade.org&gt;
<p>Website: <a
href="http://pmade.org/pjones/software/xmlwrapp/">http://pmade.org/pjones/software/xmlwrapp/</a></p>
</li>
<li><a
- href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">Matt
- Sergeant</a> developed <a
- href="http://axkit.org/download/">XML::LibXSLT</a>, a Perl wrapper for
- libxml2/libxslt as part of the <a href="http://axkit.com/">AxKit XML
- application server</a>.</li>
+ href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">MattSergeant</a>developed
+ <a href="http://axkit.org/download/">XML::LibXSLT</a>, a Perl wrapper
+ forlibxml2/libxslt as part of the <a href="http://axkit.com/">AxKit
+ XMLapplication server</a>.</li>
<li>If you're interested into scripting XML processing, have a look at <a
- href="http://xsh.sourceforge.net/">XSH</a> an XML editing shell based on
- Libxml2 Perl bindings.</li>
- <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a> provides an
- earlier version of the libxml/libxslt <a
+ href="http://xsh.sourceforge.net/">XSH</a>an XML editing shell based
+ onLibxml2 Perl bindings.</li>
+ <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a>provides
+ anearlier version of the libxml/libxslt <a
href="http://www.rexx.com/~dkuhlman">wrappers for Python</a>.</li>
<li>Gopal.V and Peter Minten develop <a
- href="http://savannah.gnu.org/projects/libxmlsharp">libxml#</a>, a set of
- C# libxml2 bindings.</li>
+ href="http://savannah.gnu.org/projects/libxmlsharp">libxml#</a>, a set
+ ofC# libxml2 bindings.</li>
<li>Petr Kozelka provides <a
- href="http://sourceforge.net/projects/libxml2-pas">Pascal units to glue
- libxml2</a> with Kylix, Delphi and other Pascal compilers.</li>
+ href="http://sourceforge.net/projects/libxml2-pas">Pascal units to
+ gluelibxml2</a>with Kylix, Delphi and other Pascal compilers.</li>
<li>Uwe Fechner also provides <a
- href="http://sourceforge.net/projects/idom2-pas/">idom2</a>, a DOM2
- implementation for Kylix2/D5/D6 from Borland.</li>
- <li>There is <a href="http://libxml.rubyforge.org/">bindings for Ruby</a>
- and libxml2 bindings are also available in Ruby through the <a
- href="http://libgdome-ruby.berlios.de/">libgdome-ruby</a> module
- maintained by Tobias Peters.</li>
+ href="http://sourceforge.net/projects/idom2-pas/">idom2</a>, a
+ DOM2implementation for Kylix2/D5/D6 from Borland.</li>
+ <li>There is <a href="http://libxml.rubyforge.org/">bindings for
+ Ruby</a>and libxml2 bindings are also available in Ruby through the <a
+ href="http://libgdome-ruby.berlios.de/">libgdome-ruby</a>modulemaintained
+ by Tobias Peters.</li>
<li>Steve Ball and contributors maintains <a
- href="http://tclxml.sourceforge.net/">libxml2 and libxslt bindings for
- Tcl</a>.</li>
+ href="http://tclxml.sourceforge.net/">libxml2 and libxslt bindings
+ forTcl</a>.</li>
<li>libxml2 and libxslt is the default XML library for PHP5.</li>
- <li><a href="http://savannah.gnu.org/projects/classpathx/">LibxmlJ</a> is
- an effort to create a 100% JAXP-compatible Java wrapper for libxml2 and
- libxslt as part of GNU ClasspathX project.</li>
- <li>Patrick McPhee provides Rexx bindings fof libxml2 and libxslt, look for
- <a href="http://www.interlog.com/~ptjm/software.html">RexxXML</a>.</li>
+ <li><a href="http://savannah.gnu.org/projects/classpathx/">LibxmlJ</a>isan
+ effort to create a 100% JAXP-compatible Java wrapper for libxml2
+ andlibxslt as part of GNU ClasspathX project.</li>
+ <li>Patrick McPhee provides Rexx bindings fof libxml2 and libxslt, look
+ for<a href="http://www.interlog.com/~ptjm/software.html">RexxXML</a>.</li>
<li><a
- href="http://www.satimage.fr/software/en/xml_suite.html">Satimage</a>
- provides <a
- href="http://www.satimage.fr/software/en/downloads_osaxen.html">XMLLib
- osax</a>. This is an osax for Mac OS X with a set of commands to
- implement in AppleScript the XML DOM, XPATH and XSLT. Also includes
- commands for Property-lists (Apple's fast lookup table XML format.)</li>
+ href="http://www.satimage.fr/software/en/xml_suite.html">Satimage</a>provides
+ <a
+ href="http://www.satimage.fr/software/en/downloads_osaxen.html">XMLLibosax</a>.
+ This is an osax for Mac OS X with a set of commands toimplement in
+ AppleScript the XML DOM, XPATH and XSLT. Also includescommands for
+ Property-lists (Apple's fast lookup table XML format.)</li>
<li>Francesco Montorsi developped <a
- href="https://sourceforge.net/project/showfiles.php?group_id=51305&amp;package_id=45182">wxXml2</a>
- wrappers that interface libxml2, allowing wxWidgets applications to
- load/save/edit XML instances.</li>
+ href="https://sourceforge.net/project/showfiles.php?group_id=51305&amp;package_id=45182">wxXml2</a>wrappers
+ that interface libxml2, allowing wxWidgets applications toload/save/edit
+ XML instances.</li>
</ul>
-<p>The distribution includes a set of Python bindings, which are guaranteed
-to be maintained as part of the library in the future, though the Python
-interface have not yet reached the completeness of the C API.</p>
+<p>The distribution includes a set of Python bindings, which are guaranteedto
+be maintained as part of the library in the future, though the
+Pythoninterface have not yet reached the completeness of the C API.</p>
-<p>Note that some of the Python purist dislike the default set of Python
-bindings, rather than complaining I suggest they have a look at <a
-href="http://codespeak.net/lxml/">lxml the more pythonic bindings for libxml2
-and libxslt</a> and <a
-href="http://codespeak.net/mailman/listinfo/lxml-dev">help Martijn
-Faassen</a> complete those.</p>
+<p>Note that some of the Python purist dislike the default set of
+Pythonbindings, rather than complaining I suggest they have a look at <a
+href="http://codespeak.net/lxml/">lxml the more pythonic bindings for
+libxml2and libxslt</a>and <a
+href="http://codespeak.net/mailman/listinfo/lxml-dev">help
+MartijnFaassen</a>complete those.</p>
-<p><a href="mailto:stephane.bidoul@softwareag.com">Stéphane Bidoul</a>
-maintains <a href="http://users.skynet.be/sbi/libxml-python/">a Windows port
-of the Python bindings</a>.</p>
+<p><a href="mailto:stephane.bidoul@softwareag.com">Stéphane
+Bidoul</a>maintains <a href="http://users.skynet.be/sbi/libxml-python/">a
+Windows portof the Python bindings</a>.</p>
-<p>Note to people interested in building bindings, the API is formalized as
-<a href="libxml2-api.xml">an XML API description file</a> which allows to
-automate a large part of the Python bindings, this includes function
-descriptions, enums, structures, typedefs, etc... The Python script used to
-build the bindings is python/generator.py in the source distribution.</p>
+<p>Note to people interested in building bindings, the API is formalized as<a
+href="libxml2-api.xml">an XML API description file</a>which allows toautomate
+a large part of the Python bindings, this includes functiondescriptions,
+enums, structures, typedefs, etc... The Python script used tobuild the
+bindings is python/generator.py in the source distribution.</p>
<p>To install the Python bindings there are 2 options:</p>
<ul>
<li>If you use an RPM based distribution, simply install the <a
- href="http://rpmfind.net/linux/rpm2html/search.php?query=libxml2-python">libxml2-python
- RPM</a> (and if needed the <a
- href="http://rpmfind.net/linux/rpm2html/search.php?query=libxslt-python">libxslt-python
- RPM</a>).</li>
- <li>Otherwise use the <a href="ftp://xmlsoft.org/libxml2/python/">libxml2-python
- module distribution</a> corresponding to your installed version of
- libxml2 and libxslt. Note that to install it you will need both libxml2
- and libxslt installed and run "python setup.py build install" in the
- module tree.</li>
+ href="http://rpmfind.net/linux/rpm2html/search.php?query=libxml2-python">libxml2-pythonRPM</a>(and
+ if needed the <a
+ href="http://rpmfind.net/linux/rpm2html/search.php?query=libxslt-python">libxslt-pythonRPM</a>).</li>
+ <li>Otherwise use the <a
+ href="ftp://xmlsoft.org/libxml2/python/">libxml2-pythonmodule
+ distribution</a>corresponding to your installed version oflibxml2 and
+ libxslt. Note that to install it you will need both libxml2and libxslt
+ installed and run "python setup.py build install" in themodule tree.</li>
</ul>
-<p>The distribution includes a set of examples and regression tests for the
-python bindings in the <code>python/tests</code> directory. Here are some
-excerpts from those tests:</p>
+<p>The distribution includes a set of examples and regression tests for
+thepython bindings in the <code>python/tests</code>directory. Here are
+someexcerpts from those tests:</p>
<h3>tst.py:</h3>
@@ -2619,32 +2633,33 @@ if child.name != "foo":
sys.exit(1)
doc.freeDoc()</pre>
-<p>The Python module is called libxml2; parseFile is the equivalent of
-xmlParseFile (most of the bindings are automatically generated, and the xml
-prefix is removed and the casing convention are kept). All node seen at the
-binding level share the same subset of accessors:</p>
-<ul>
- <li><code>name</code> : returns the node name</li>
- <li><code>type</code> : returns a string indicating the node type</li>
- <li><code>content</code> : returns the content of the node, it is based on
- xmlNodeGetContent() and hence is recursive.</li>
- <li><code>parent</code> , <code>children</code>, <code>last</code>,
- <code>next</code>, <code>prev</code>, <code>doc</code>,
- <code>properties</code>: pointing to the associated element in the tree,
- those may return None in case no such link exists.</li>
-</ul>
-
-<p>Also note the need to explicitly deallocate documents with freeDoc() .
-Reference counting for libxml2 trees would need quite a lot of work to
-function properly, and rather than risk memory leaks if not implemented
-correctly it sounds safer to have an explicit function to free a tree. The
-wrapper python objects like doc, root or child are them automatically garbage
-collected.</p>
+<p>The Python module is called libxml2; parseFile is the equivalent
+ofxmlParseFile (most of the bindings are automatically generated, and the
+xmlprefix is removed and the casing convention are kept). All node seen at
+thebinding level share the same subset of accessors:</p>
+<ul>
+ <li><code>name</code>: returns the node name</li>
+ <li><code>type</code>: returns a string indicating the node type</li>
+ <li><code>content</code>: returns the content of the node, it is based
+ onxmlNodeGetContent() and hence is recursive.</li>
+ <li><code>parent</code>, <code>children</code>,
+ <code>last</code>,<code>next</code>, <code>prev</code>,
+ <code>doc</code>,<code>properties</code>: pointing to the associated
+ element in the tree,those may return None in case no such link
+ exists.</li>
+</ul>
+
+<p>Also note the need to explicitly deallocate documents with freeDoc()
+.Reference counting for libxml2 trees would need quite a lot of work
+tofunction properly, and rather than risk memory leaks if not
+implementedcorrectly it sounds safer to have an explicit function to free a
+tree. Thewrapper python objects like doc, root or child are them
+automatically garbagecollected.</p>
<h3>validate.py:</h3>
-<p>This test check the validation interfaces and redirection of error
-messages:</p>
+<p>This test check the validation interfaces and redirection of
+errormessages:</p>
<pre>import libxml2
#deactivate error messages from the validation
@@ -2662,19 +2677,19 @@ doc.freeDoc()
if valid != 0:
print "validity check failed"</pre>
-<p>The first thing to notice is the call to registerErrorHandler(), it
-defines a new error handler global to the library. It is used to avoid seeing
-the error messages when trying to validate the invalid document.</p>
+<p>The first thing to notice is the call to registerErrorHandler(), itdefines
+a new error handler global to the library. It is used to avoid seeingthe
+error messages when trying to validate the invalid document.</p>
-<p>The main interest of that test is the creation of a parser context with
-createFileParserCtxt() and how the behaviour can be changed before calling
-parseDocument() . Similarly the informations resulting from the parsing phase
-are also available using context methods.</p>
+<p>The main interest of that test is the creation of a parser context
+withcreateFileParserCtxt() and how the behaviour can be changed before
+callingparseDocument() . Similarly the informations resulting from the
+parsing phaseare also available using context methods.</p>
-<p>Contexts like nodes are defined as class and the libxml2 wrappers maps the
-C function interfaces in terms of objects method as much as possible. The
-best to get a complete view of what methods are supported is to look at the
-libxml2.py module containing all the wrappers.</p>
+<p>Contexts like nodes are defined as class and the libxml2 wrappers maps
+theC function interfaces in terms of objects method as much as possible.
+Thebest to get a complete view of what methods are supported is to look at
+thelibxml2.py module containing all the wrappers.</p>
<h3>push.py:</h3>
@@ -2687,19 +2702,20 @@ doc = ctxt.doc()
doc.freeDoc()</pre>
-<p>The context is created with a special call based on the
-xmlCreatePushParser() from the C library. The first argument is an optional
-SAX callback object, then the initial set of data, the length and the name of
-the resource in case URI-References need to be computed by the parser.</p>
+<p>The context is created with a special call based on
+thexmlCreatePushParser() from the C library. The first argument is an
+optionalSAX callback object, then the initial set of data, the length and the
+name ofthe resource in case URI-References need to be computed by the
+parser.</p>
-<p>Then the data are pushed using the parseChunk() method, the last call
-setting the third argument terminate to 1.</p>
+<p>Then the data are pushed using the parseChunk() method, the last
+callsetting the third argument terminate to 1.</p>
<h3>pushSAX.py:</h3>
-<p>this test show the use of the event based parsing interfaces. In this case
-the parser does not build a document, but provides callback information as
-the parser makes progresses analyzing the data being provided:</p>
+<p>this test show the use of the event based parsing interfaces. In this
+casethe parser does not build a document, but provides callback information
+asthe parser makes progresses analyzing the data being provided:</p>
<pre>import libxml2
log = ""
@@ -2750,17 +2766,17 @@ if log != reference:
print "Error got: %s" % log
print "Expected: %s" % reference</pre>
-<p>The key object in that test is the handler, it provides a number of entry
-points which can be called by the parser as it makes progresses to indicate
-the information set obtained. The full set of callback is larger than what
-the callback class in that specific example implements (see the SAX
-definition for a complete list). The wrapper will only call those supplied by
-the object when activated. The startElement receives the names of the element
-and a dictionary containing the attributes carried by this element.</p>
+<p>The key object in that test is the handler, it provides a number of
+entrypoints which can be called by the parser as it makes progresses to
+indicatethe information set obtained. The full set of callback is larger than
+whatthe callback class in that specific example implements (see the
+SAXdefinition for a complete list). The wrapper will only call those supplied
+bythe object when activated. The startElement receives the names of the
+elementand a dictionary containing the attributes carried by this element.</p>
-<p>Also note that the reference string generated from the callback shows a
-single character call even though the string "bar" is passed to the parser
-from 2 different call to parseChunk()</p>
+<p>Also note that the reference string generated from the callback shows
+asingle character call even though the string "bar" is passed to the
+parserfrom 2 different call to parseChunk()</p>
<h3>xpath.py:</h3>
@@ -2779,18 +2795,19 @@ if res[0].name != "doc" or res[1].name != "foo":
doc.freeDoc()
ctxt.xpathFreeContext()</pre>
-<p>This test parses a file, then create an XPath context to evaluate XPath
-expression on it. The xpathEval() method execute an XPath query and returns
-the result mapped in a Python way. String and numbers are natively converted,
-and node sets are returned as a tuple of libxml2 Python nodes wrappers. Like
-the document, the XPath context need to be freed explicitly, also not that
-the result of the XPath query may point back to the document tree and hence
-the document must be freed after the result of the query is used.</p>
+<p>This test parses a file, then create an XPath context to evaluate
+XPathexpression on it. The xpathEval() method execute an XPath query and
+returnsthe result mapped in a Python way. String and numbers are natively
+converted,and node sets are returned as a tuple of libxml2 Python nodes
+wrappers. Likethe document, the XPath context need to be freed explicitly,
+also not thatthe result of the XPath query may point back to the document
+tree and hencethe document must be freed after the result of the query is
+used.</p>
<h3>xpathext.py:</h3>
-<p>This test shows how to extend the XPath engine with functions written in
-python:</p>
+<p>This test shows how to extend the XPath engine with functions written
+inpython:</p>
<pre>import libxml2
def foo(ctx, x):
@@ -2805,13 +2822,13 @@ if res != 2:
doc.freeDoc()
ctxt.xpathFreeContext()</pre>
-<p>Note how the extension function is registered with the context (but that
-part is not yet finalized, this may change slightly in the future).</p>
+<p>Note how the extension function is registered with the context (but
+thatpart is not yet finalized, this may change slightly in the future).</p>
<h3>tstxpath.py:</h3>
-<p>This test is similar to the previous one but shows how the extension
-function can access the XPath evaluation context:</p>
+<p>This test is similar to the previous one but shows how the
+extensionfunction can access the XPath evaluation context:</p>
<pre>def foo(ctx, x):
global called
@@ -2823,9 +2840,9 @@ function can access the XPath evaluation context:</p>
called = ctxt.function()
return x + 1</pre>
-<p>All the interfaces around the XPath parser(or rather evaluation) context
-are not finalized, but it should be sufficient to do contextual work at the
-evaluation point.</p>
+<p>All the interfaces around the XPath parser(or rather evaluation)
+contextare not finalized, but it should be sufficient to do contextual work
+at theevaluation point.</p>
<h3>Memory debugging:</h3>
@@ -2842,15 +2859,15 @@ else:
print "Memory leak %d bytes" % (libxml2.debugMemory(1))
libxml2.dumpMemory()</pre>
-<p>Those activate the memory debugging interface of libxml2 where all
-allocated block in the library are tracked. The prologue then cleans up the
-library state and checks that all allocated memory has been freed. If not it
-calls dumpMemory() which saves that list in a <code>.memdump</code> file.</p>
+<p>Those activate the memory debugging interface of libxml2 where
+allallocated block in the library are tracked. The prologue then cleans up
+thelibrary state and checks that all allocated memory has been freed. If not
+itcalls dumpMemory() which saves that list in a <code>.memdump</code>file.</p>
<h2><a name="architecture">libxml2 architecture</a></h2>
-<p>Libxml2 is made of multiple components; some of them are optional, and
-most of the block interfaces are public. The main components are:</p>
+<p>Libxml2 is made of multiple components; some of them are optional, andmost
+of the block interfaces are public. The main components are:</p>
<ul>
<li>an Input/Output layer</li>
<li>FTP and HTTP client layers (optional)</li>
@@ -2861,8 +2878,7 @@ most of the block interfaces are public. The main components are:</p>
<li>a SAX tree module to build an in-memory DOM representation</li>
<li>a tree module to manipulate the DOM representation</li>
<li>a validation module using the DOM representation (optional)</li>
- <li>an XPath module for global lookup in a DOM representation
- (optional)</li>
+ <li>an XPath module for global lookup in a DOM representation(optional)</li>
<li>a debug module (optional)</li>
</ul>
@@ -2874,28 +2890,29 @@ most of the block interfaces are public. The main components are:</p>
<h2><a name="tree">The tree output</a></h2>
-<p>The parser returns a tree built during the document analysis. The value
-returned is an <strong>xmlDocPtr</strong> (i.e., a pointer to an
-<strong>xmlDoc</strong> structure). This structure contains information such
-as the file name, the document type, and a <strong>children</strong> pointer
-which is the root of the document (or more exactly the first child under the
-root which is the document). The tree is made of <strong>xmlNode</strong>s,
-chained in double-linked lists of siblings and with a children&lt;-&gt;parent
-relationship. An xmlNode can also carry properties (a chain of xmlAttr
-structures). An attribute may have a value which is a list of TEXT or
-ENTITY_REF nodes.</p>
+<p>The parser returns a tree built during the document analysis. The
+valuereturned is an <strong>xmlDocPtr</strong>(i.e., a pointer to
+an<strong>xmlDoc</strong>structure). This structure contains information
+suchas the file name, the document type, and a
+<strong>children</strong>pointerwhich is the root of the document (or more
+exactly the first child under theroot which is the document). The tree is
+made of <strong>xmlNode</strong>s,chained in double-linked lists of siblings
+and with a children&lt;-&gt;parentrelationship. An xmlNode can also carry
+properties (a chain of xmlAttrstructures). An attribute may have a value
+which is a list of TEXT orENTITY_REF nodes.</p>
-<p>Here is an example (erroneous with respect to the XML spec since there
-should be only one ELEMENT under the root):</p>
+<p>Here is an example (erroneous with respect to the XML spec since
+thereshould be only one ELEMENT under the root):</p>
<p><img src="structure.gif" alt=" structure.gif "></p>
-<p>In the source package there is a small program (not installed by default)
-called <strong>xmllint</strong> which parses XML files given as argument and
-prints them back as parsed. This is useful for detecting errors both in XML
-code and in the XML parser itself. It has an option <strong>--debug</strong>
-which prints the actual in-memory structure of the document; here is the
-result with the <a href="#example">example</a> given before:</p>
+<p>In the source package there is a small program (not installed by
+default)called <strong>xmllint</strong>which parses XML files given as
+argument andprints them back as parsed. This is useful for detecting errors
+both in XMLcode and in the XML parser itself. It has an option
+<strong>--debug</strong>which prints the actual in-memory structure of the
+document; here is theresult with the <a href="#example">example</a>given
+before:</p>
<pre>DOCUMENT
version=1.0
standalone=true
@@ -2930,24 +2947,23 @@ standalone=true
<h2><a name="interface">The SAX interface</a></h2>
-<p>Sometimes the DOM tree output is just too large to fit reasonably into
-memory. In that case (and if you don't expect to save back the XML document
-loaded using libxml), it's better to use the SAX interface of libxml. SAX is
-a <strong>callback-based interface</strong> to the parser. Before parsing,
-the application layer registers a customized set of callbacks which are
-called by the library as it progresses through the XML input.</p>
-
-<p>To get more detailed step-by-step guidance on using the SAX interface of
-libxml, see the <a
-href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">nice
-documentation</a>.written by <a href="mailto:james@daa.com.au">James
-Henstridge</a>.</p>
-
-<p>You can debug the SAX behaviour by using the <strong>testSAX</strong>
-program located in the gnome-xml module (it's usually not shipped in the
-binary packages of libxml, but you can find it in the tar source
-distribution). Here is the sequence of callbacks that would be reported by
-testSAX when parsing the example XML document shown earlier:</p>
+<p>Sometimes the DOM tree output is just too large to fit reasonably
+intomemory. In that case (and if you don't expect to save back the XML
+documentloaded using libxml), it's better to use the SAX interface of libxml.
+SAX isa <strong>callback-based interface</strong>to the parser. Before
+parsing,the application layer registers a customized set of callbacks which
+arecalled by the library as it progresses through the XML input.</p>
+
+<p>To get more detailed step-by-step guidance on using the SAX interface
+oflibxml, see the <a
+href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">nicedocumentation</a>.written
+by <a href="mailto:james@daa.com.au">JamesHenstridge</a>.</p>
+
+<p>You can debug the SAX behaviour by using the
+<strong>testSAX</strong>program located in the gnome-xml module (it's usually
+not shipped in thebinary packages of libxml, but you can find it in the tar
+sourcedistribution). Here is the sequence of callbacks that would be reported
+bytestSAX when parsing the example XML document shown earlier:</p>
<pre>SAX.setDocumentLocator()
SAX.startDocument()
SAX.getEntity(amp)
@@ -2983,11 +2999,11 @@ SAX.characters( , 1)
SAX.endElement(EXAMPLE)
SAX.endDocument()</pre>
-<p>Most of the other interfaces of libxml2 are based on the DOM tree-building
-facility, so nearly everything up to the end of this document presupposes the
-use of the standard DOM tree build. Note that the DOM tree itself is built by
-a set of registered default callbacks, without internal specific
-interface.</p>
+<p>Most of the other interfaces of libxml2 are based on the DOM
+tree-buildingfacility, so nearly everything up to the end of this document
+presupposes theuse of the standard DOM tree build. Note that the DOM tree
+itself is built bya set of registered default callbacks, without internal
+specificinterface.</p>
<h2><a name="Validation">Validation &amp; DTDs</a></h2>
@@ -3011,67 +3027,69 @@ interface.</p>
<p>Well what is validation and what is a DTD ?</p>
-<p>DTD is the acronym for Document Type Definition. This is a description of
-the content for a family of XML files. This is part of the XML 1.0
-specification, and allows one to describe and verify that a given document
-instance conforms to the set of rules detailing its structure and content.</p>
+<p>DTD is the acronym for Document Type Definition. This is a description
+ofthe content for a family of XML files. This is part of the XML
+1.0specification, and allows one to describe and verify that a given
+documentinstance conforms to the set of rules detailing its structure and
+content.</p>
-<p>Validation is the process of checking a document against a DTD (more
-generally against a set of construction rules).</p>
+<p>Validation is the process of checking a document against a DTD
+(moregenerally against a set of construction rules).</p>
-<p>The validation process and building DTDs are the two most difficult parts
-of the XML life cycle. Briefly a DTD defines all the possible elements to be
-found within your document, what is the formal shape of your document tree
-(by defining the allowed content of an element; either text, a regular
-expression for the allowed list of children, or mixed content i.e. both text
-and children). The DTD also defines the valid attributes for all elements and
-the types of those attributes.</p>
+<p>The validation process and building DTDs are the two most difficult
+partsof the XML life cycle. Briefly a DTD defines all the possible elements
+to befound within your document, what is the formal shape of your document
+tree(by defining the allowed content of an element; either text, a
+regularexpression for the allowed list of children, or mixed content i.e.
+both textand children). The DTD also defines the valid attributes for all
+elements andthe types of those attributes.</p>
<h3><a name="definition1">The definition</a></h3>
-<p>The <a href="http://www.w3.org/TR/REC-xml">W3C XML Recommendation</a> (<a
-href="http://www.xml.com/axml/axml.html">Tim Bray's annotated version of
-Rev1</a>):</p>
+<p>The <a href="http://www.w3.org/TR/REC-xml">W3C XML Recommendation</a>(<a
+href="http://www.xml.com/axml/axml.html">Tim Bray's annotated version
+ofRev1</a>):</p>
<ul>
- <li><a href="http://www.w3.org/TR/REC-xml#elemdecls">Declaring
- elements</a></li>
- <li><a href="http://www.w3.org/TR/REC-xml#attdecls">Declaring
- attributes</a></li>
+ <li><a
+ href="http://www.w3.org/TR/REC-xml#elemdecls">Declaringelements</a></li>
+ <li><a
+ href="http://www.w3.org/TR/REC-xml#attdecls">Declaringattributes</a></li>
</ul>
-<p>(unfortunately) all this is inherited from the SGML world, the syntax is
-ancient...</p>
+<p>(unfortunately) all this is inherited from the SGML world, the syntax
+isancient...</p>
<h3><a name="Simple1">Simple rules</a></h3>
-<p>Writing DTDs can be done in many ways. The rules to build them if you need
-something permanent or something which can evolve over time can be radically
-different. Really complex DTDs like DocBook ones are flexible but quite
-harder to design. I will just focus on DTDs for a formats with a fixed simple
-structure. It is just a set of basic rules, and definitely not exhaustive nor
-usable for complex DTD design.</p>
+<p>Writing DTDs can be done in many ways. The rules to build them if you
+needsomething permanent or something which can evolve over time can be
+radicallydifferent. Really complex DTDs like DocBook ones are flexible but
+quiteharder to design. I will just focus on DTDs for a formats with a fixed
+simplestructure. It is just a set of basic rules, and definitely not
+exhaustive norusable for complex DTD design.</p>
<h4><a name="reference1">How to reference a DTD from a document</a>:</h4>
-<p>Assuming the top element of the document is <code>spec</code> and the dtd
-is placed in the file <code>mydtd</code> in the subdirectory
-<code>dtds</code> of the directory from where the document were loaded:</p>
+<p>Assuming the top element of the document is <code>spec</code>and the dtdis
+placed in the file <code>mydtd</code>in the subdirectory<code>dtds</code>of
+the directory from where the document were loaded:</p>
<p><code>&lt;!DOCTYPE spec SYSTEM "dtds/mydtd"&gt;</code></p>
<p>Notes:</p>
<ul>
<li>The system string is actually an URI-Reference (as defined in <a
- href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>) so you can use a
- full URL string indicating the location of your DTD on the Web. This is a
- really good thing to do if you want others to validate your document.</li>
- <li>It is also possible to associate a <code>PUBLIC</code> identifier (a
- magic string) so that the DTD is looked up in catalogs on the client side
- without having to locate it on the web.</li>
- <li>A DTD contains a set of element and attribute declarations, but they
- don't define what the root of the document should be. This is explicitly
- told to the parser/validator as the first element of the
- <code>DOCTYPE</code> declaration.</li>
+ href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>) so you can use
+ afull URL string indicating the location of your DTD on the Web. This is
+ areally good thing to do if you want others to validate your
+ document.</li>
+ <li>It is also possible to associate a <code>PUBLIC</code>identifier
+ (amagic string) so that the DTD is looked up in catalogs on the client
+ sidewithout having to locate it on the web.</li>
+ <li>A DTD contains a set of element and attribute declarations, but
+ theydon't define what the root of the document should be. This is
+ explicitlytold to the parser/validator as the first element of
+ the<code>DOCTYPE</code>declaration.</li>
</ul>
<h4><a name="Declaring2">Declaring elements</a>:</h4>
@@ -3080,29 +3098,29 @@ is placed in the file <code>mydtd</code> in the subdirectory
<p><code>&lt;!ELEMENT spec (front, body, back?)&gt;</code></p>
-<p>It also expresses that the spec element contains one <code>front</code>,
-one <code>body</code> and one optional <code>back</code> children elements in
-this order. The declaration of one element of the structure and its content
-are done in a single declaration. Similarly the following declares
-<code>div1</code> elements:</p>
+<p>It also expresses that the spec element contains one
+<code>front</code>,one <code>body</code>and one optional
+<code>back</code>children elements inthis order. The declaration of one
+element of the structure and its contentare done in a single declaration.
+Similarly the following declares<code>div1</code>elements:</p>
<p><code>&lt;!ELEMENT div1 (head, (p | list | note)*, div2?)&gt;</code></p>
-<p>which means div1 contains one <code>head</code> then a series of optional
-<code>p</code>, <code>list</code>s and <code>note</code>s and then an
-optional <code>div2</code>. And last but not least an element can contain
-text:</p>
+<p>which means div1 contains one <code>head</code>then a series of
+optional<code>p</code>, <code>list</code>s and <code>note</code>s and then
+anoptional <code>div2</code>. And last but not least an element can
+containtext:</p>
<p><code>&lt;!ELEMENT b (#PCDATA)&gt;</code></p>
-<p><code>b</code> contains text or being of mixed content (text and elements
-in no particular order):</p>
+<p><code>b</code>contains text or being of mixed content (text and elementsin
+no particular order):</p>
<p><code>&lt;!ELEMENT p (#PCDATA|a|ul|b|i|em)*&gt;</code></p>
-<p><code>p </code>can contain text or <code>a</code>, <code>ul</code>,
-<code>b</code>, <code>i </code>or <code>em</code> elements in no particular
-order.</p>
+<p><code>p </code>can contain text or <code>a</code>,
+<code>ul</code>,<code>b</code>, <code>i </code>or <code>em</code>elements in
+no particularorder.</p>
<h4><a name="Declaring1">Declaring attributes</a>:</h4>
@@ -3110,83 +3128,82 @@ order.</p>
<p><code>&lt;!ATTLIST termdef name CDATA #IMPLIED&gt;</code></p>
-<p>means that the element <code>termdef</code> can have a <code>name</code>
-attribute containing text (<code>CDATA</code>) and which is optional
-(<code>#IMPLIED</code>). The attribute value can also be defined within a
-set:</p>
+<p>means that the element <code>termdef</code>can have a
+<code>name</code>attribute containing text (<code>CDATA</code>) and which is
+optional(<code>#IMPLIED</code>). The attribute value can also be defined
+within aset:</p>
-<p><code>&lt;!ATTLIST list type (bullets|ordered|glossary)
-"ordered"&gt;</code></p>
+<p><code>&lt;!ATTLIST list type
+(bullets|ordered|glossary)"ordered"&gt;</code></p>
-<p>means <code>list</code> element have a <code>type</code> attribute with 3
-allowed values "bullets", "ordered" or "glossary" and which default to
-"ordered" if the attribute is not explicitly specified.</p>
+<p>means <code>list</code>element have a <code>type</code>attribute with
+3allowed values "bullets", "ordered" or "glossary" and which default
+to"ordered" if the attribute is not explicitly specified.</p>
-<p>The content type of an attribute can be text (<code>CDATA</code>),
-anchor/reference/references
-(<code>ID</code>/<code>IDREF</code>/<code>IDREFS</code>), entity(ies)
-(<code>ENTITY</code>/<code>ENTITIES</code>) or name(s)
-(<code>NMTOKEN</code>/<code>NMTOKENS</code>). The following defines that a
-<code>chapter</code> element can have an optional <code>id</code> attribute
-of type <code>ID</code>, usable for reference from attribute of type
-IDREF:</p>
+<p>The content type of an attribute can be text
+(<code>CDATA</code>),anchor/reference/references(<code>ID</code>/<code>IDREF</code>/<code>IDREFS</code>),
+entity(ies)(<code>ENTITY</code>/<code>ENTITIES</code>) or
+name(s)(<code>NMTOKEN</code>/<code>NMTOKENS</code>). The following defines
+that a<code>chapter</code>element can have an optional
+<code>id</code>attributeof type <code>ID</code>, usable for reference from
+attribute of typeIDREF:</p>
<p><code>&lt;!ATTLIST chapter id ID #IMPLIED&gt;</code></p>
-<p>The last value of an attribute definition can be <code>#REQUIRED
-</code>meaning that the attribute has to be given, <code>#IMPLIED</code>
-meaning that it is optional, or the default value (possibly prefixed by
-<code>#FIXED</code> if it is the only allowed).</p>
+<p>The last value of an attribute definition can be
+<code>#REQUIRED</code>meaning that the attribute has to be given,
+<code>#IMPLIED</code>meaning that it is optional, or the default value
+(possibly prefixed by<code>#FIXED</code>if it is the only allowed).</p>
<p>Notes:</p>
<ul>
- <li>Usually the attributes pertaining to a given element are declared in a
- single expression, but it is just a convention adopted by a lot of DTD
- writers:
+ <li>Usually the attributes pertaining to a given element are declared in
+ asingle expression, but it is just a convention adopted by a lot of
+ DTDwriters:
<pre>&lt;!ATTLIST termdef
id ID #REQUIRED
name CDATA #IMPLIED&gt;</pre>
- <p>The previous construct defines both <code>id</code> and
- <code>name</code> attributes for the element <code>termdef</code>.</p>
+ <p>The previous construct defines both
+ <code>id</code>and<code>name</code>attributes for the element
+ <code>termdef</code>.</p>
</li>
</ul>
<h3><a name="Some1">Some examples</a></h3>
-<p>The directory <code>test/valid/dtds/</code> in the libxml2 distribution
-contains some complex DTD examples. The example in the file
-<code>test/valid/dia.xml</code> shows an XML file where the simple DTD is
-directly included within the document.</p>
+<p>The directory <code>test/valid/dtds/</code>in the libxml2
+distributioncontains some complex DTD examples. The example in the
+file<code>test/valid/dia.xml</code>shows an XML file where the simple DTD
+isdirectly included within the document.</p>
<h3><a name="validate1">How to validate</a></h3>
-<p>The simplest way is to use the xmllint program included with libxml. The
-<code>--valid</code> option turns-on validation of the files given as input.
-For example the following validates a copy of the first revision of the XML
-1.0 specification:</p>
+<p>The simplest way is to use the xmllint program included with libxml.
+The<code>--valid</code>option turns-on validation of the files given as
+input.For example the following validates a copy of the first revision of the
+XML1.0 specification:</p>
<p><code>xmllint --valid --noout test/valid/REC-xml-19980210.xml</code></p>
<p>the -- noout is used to disable output of the resulting tree.</p>
-<p>The <code>--dtdvalid dtd</code> allows validation of the document(s)
-against a given DTD.</p>
+<p>The <code>--dtdvalid dtd</code>allows validation of the document(s)against
+a given DTD.</p>
<p>Libxml2 exports an API to handle DTDs and validation, check the <a
-href="http://xmlsoft.org/html/libxml-valid.html">associated
-description</a>.</p>
+href="http://xmlsoft.org/html/libxml-valid.html">associateddescription</a>.</p>
<h3><a name="Other1">Other resources</a></h3>
-<p>DTDs are as old as SGML. So there may be a number of examples on-line, I
-will just list one for now, others pointers welcome:</p>
+<p>DTDs are as old as SGML. So there may be a number of examples on-line,
+Iwill just list one for now, others pointers welcome:</p>
<ul>
<li><a href="http://www.xml101.com:8081/dtd/">XML-101 DTD</a></li>
</ul>
-<p>I suggest looking at the examples found under test/valid/dtd and any of
-the large number of books available on XML. The dia example in test/valid
-should be both simple and complete enough to allow you to build your own.</p>
+<p>I suggest looking at the examples found under test/valid/dtd and any ofthe
+large number of books available on XML. The dia example in test/validshould
+be both simple and complete enough to allow you to build your own.</p>
<p></p>
@@ -3204,180 +3221,186 @@ should be both simple and complete enough to allow you to build your own.</p>
<h3><a name="General3">General overview</a></h3>
<p>The module <code><a
-href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlmemory.h</a></code>
-provides the interfaces to the libxml2 memory system:</p>
+href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlmemory.h</a></code>provides
+the interfaces to the libxml2 memory system:</p>
<ul>
- <li>libxml2 does not use the libc memory allocator directly but xmlFree(),
- xmlMalloc() and xmlRealloc()</li>
- <li>those routines can be reallocated to a specific set of routine, by
- default the libc ones i.e. free(), malloc() and realloc()</li>
+ <li>libxml2 does not use the libc memory allocator directly but
+ xmlFree(),xmlMalloc() and xmlRealloc()</li>
+ <li>those routines can be reallocated to a specific set of routine,
+ bydefault the libc ones i.e. free(), malloc() and realloc()</li>
<li>the xmlmemory.c module includes a set of debugging routine</li>
</ul>
<h3><a name="setting">Setting libxml2 set of memory routines</a></h3>
-<p>It is sometimes useful to not use the default memory allocator, either for
-debugging, analysis or to implement a specific behaviour on memory management
-(like on embedded systems). Two function calls are available to do so:</p>
+<p>It is sometimes useful to not use the default memory allocator, either
+fordebugging, analysis or to implement a specific behaviour on memory
+management(like on embedded systems). Two function calls are available to do
+so:</p>
<ul>
- <li><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemGet
- ()</a> which return the current set of functions in use by the parser</li>
<li><a
- href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemSetup()</a>
- which allow to set up a new set of memory allocation functions</li>
+ href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemGet()</a>which
+ return the current set of functions in use by the parser</li>
+ <li><a
+ href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemSetup()</a>which
+ allow to set up a new set of memory allocation functions</li>
</ul>
-<p>Of course a call to xmlMemSetup() should probably be done before calling
-any other libxml2 routines (unless you are sure your allocations routines are
-compatibles).</p>
+<p>Of course a call to xmlMemSetup() should probably be done before
+callingany other libxml2 routines (unless you are sure your allocations
+routines arecompatibles).</p>
<h3><a name="cleanup">Cleaning up after parsing</a></h3>
-<p>Libxml2 is not stateless, there is a few set of memory structures needing
-allocation before the parser is fully functional (some encoding structures
-for example). This also mean that once parsing is finished there is a tiny
-amount of memory (a few hundred bytes) which can be recollected if you don't
-reuse the parser immediately:</p>
+<p>Libxml2 is not stateless, there is a few set of memory structures
+needingallocation before the parser is fully functional (some encoding
+structuresfor example). This also mean that once parsing is finished there is
+a tinyamount of memory (a few hundred bytes) which can be recollected if you
+don'treuse the parser immediately:</p>
<ul>
- <li><a href="http://xmlsoft.org/html/libxml-parser.html">xmlCleanupParser
- ()</a> is a centralized routine to free the parsing states. Note that it
- won't deallocate any produced tree if any (use the xmlFreeDoc() and
- related routines for this).</li>
- <li><a href="http://xmlsoft.org/html/libxml-parser.html">xmlInitParser
- ()</a> is the dual routine allowing to preallocate the parsing state
- which can be useful for example to avoid initialization reentrancy
- problems when using libxml2 in multithreaded applications</li>
+ <li><a
+ href="http://xmlsoft.org/html/libxml-parser.html">xmlCleanupParser()</a>is
+ a centralized routine to free the parsing states. Note that itwon't
+ deallocate any produced tree if any (use the xmlFreeDoc() andrelated
+ routines for this).</li>
+ <li><a
+ href="http://xmlsoft.org/html/libxml-parser.html">xmlInitParser()</a>is
+ the dual routine allowing to preallocate the parsing statewhich can be
+ useful for example to avoid initialization reentrancyproblems when using
+ libxml2 in multithreaded applications</li>
</ul>
-<p>Generally xmlCleanupParser() is safe, if needed the state will be rebuild
-at the next invocation of parser routines, but be careful of the consequences
-in multithreaded applications.</p>
+<p>Generally xmlCleanupParser() is safe, if needed the state will be
+rebuildat the next invocation of parser routines, but be careful of the
+consequencesin multithreaded applications.</p>
<h3><a name="Debugging">Debugging routines</a></h3>
-<p>When configured using --with-mem-debug flag (off by default), libxml2 uses
-a set of memory allocation debugging routines keeping track of all allocated
-blocks and the location in the code where the routine was called. A couple of
-other debugging routines allow to dump the memory allocated infos to a file
-or call a specific routine when a given block number is allocated:</p>
+<p>When configured using --with-mem-debug flag (off by default), libxml2
+usesa set of memory allocation debugging routines keeping track of all
+allocatedblocks and the location in the code where the routine was called. A
+couple ofother debugging routines allow to dump the memory allocated infos to
+a fileor call a specific routine when a given block number is allocated:</p>
<ul>
<li><a
- href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMallocLoc()</a>
+ href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMallocLoc()</a><a
+ href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlReallocLoc()</a>and
<a
- href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlReallocLoc()</a>
- and <a
- href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemStrdupLoc()</a>
- are the memory debugging replacement allocation routines</li>
- <li><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemoryDump
- ()</a> dumps all the informations about the allocated memory block lefts
- in the <code>.memdump</code> file</li>
-</ul>
-
-<p>When developing libxml2 memory debug is enabled, the tests programs call
-xmlMemoryDump () and the "make test" regression tests will check for any
-memory leak during the full regression test sequence, this helps a lot
-ensuring that libxml2 does not leak memory and bullet proof memory
-allocations use (some libc implementations are known to be far too permissive
-resulting in major portability problems!).</p>
-
-<p>If the .memdump reports a leak, it displays the allocation function and
-also tries to give some informations about the content and structure of the
-allocated blocks left. This is sufficient in most cases to find the culprit,
-but not always. Assuming the allocation problem is reproducible, it is
-possible to find more easily:</p>
+ href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemStrdupLoc()</a>are
+ the memory debugging replacement allocation routines</li>
+ <li><a
+ href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemoryDump()</a>dumps
+ all the informations about the allocated memory block leftsin the
+ <code>.memdump</code>file</li>
+</ul>
+
+<p>When developing libxml2 memory debug is enabled, the tests programs
+callxmlMemoryDump () and the "make test" regression tests will check for
+anymemory leak during the full regression test sequence, this helps a
+lotensuring that libxml2 does not leak memory and bullet proof
+memoryallocations use (some libc implementations are known to be far too
+permissiveresulting in major portability problems!).</p>
+
+<p>If the .memdump reports a leak, it displays the allocation function
+andalso tries to give some informations about the content and structure of
+theallocated blocks left. This is sufficient in most cases to find the
+culprit,but not always. Assuming the allocation problem is reproducible, it
+ispossible to find more easily:</p>
<ol>
<li>write down the block number xxxx not allocated</li>
- <li>export the environment variable XML_MEM_BREAKPOINT=xxxx , the easiest
- when using GDB is to simply give the command
+ <li>export the environment variable XML_MEM_BREAKPOINT=xxxx , the
+ easiestwhen using GDB is to simply give the command
<p><code>set environment XML_MEM_BREAKPOINT xxxx</code></p>
<p>before running the program.</p>
</li>
- <li>run the program under a debugger and set a breakpoint on
- xmlMallocBreakpoint() a specific function called when this precise block
- is allocated</li>
- <li>when the breakpoint is reached you can then do a fine analysis of the
- allocation an step to see the condition resulting in the missing
- deallocation.</li>
+ <li>run the program under a debugger and set a breakpoint
+ onxmlMallocBreakpoint() a specific function called when this precise
+ blockis allocated</li>
+ <li>when the breakpoint is reached you can then do a fine analysis of
+ theallocation an step to see the condition resulting in the
+ missingdeallocation.</li>
</ol>
-<p>I used to use a commercial tool to debug libxml2 memory problems but after
-noticing that it was not detecting memory leaks that simple mechanism was
-used and proved extremely efficient until now. Lately I have also used <a
-href="http://developer.kde.org/~sewardj/">valgrind</a> with quite some
-success, it is tied to the i386 architecture since it works by emulating the
-processor and instruction set, it is slow but extremely efficient, i.e. it
-spot memory usage errors in a very precise way.</p>
+<p>I used to use a commercial tool to debug libxml2 memory problems but
+afternoticing that it was not detecting memory leaks that simple mechanism
+wasused and proved extremely efficient until now. Lately I have also used <a
+href="http://developer.kde.org/~sewardj/">valgrind</a>with quite somesuccess,
+it is tied to the i386 architecture since it works by emulating theprocessor
+and instruction set, it is slow but extremely efficient, i.e. itspot memory
+usage errors in a very precise way.</p>
<h3><a name="General4">General memory requirements</a></h3>
-<p>How much libxml2 memory require ? It's hard to tell in average it depends
-of a number of things:</p>
-<ul>
- <li>the parser itself should work in a fixed amount of memory, except for
- information maintained about the stacks of names and entities locations.
- The I/O and encoding handlers will probably account for a few KBytes.
- This is true for both the XML and HTML parser (though the HTML parser
- need more state).</li>
- <li>If you are generating the DOM tree then memory requirements will grow
- nearly linear with the size of the data. In general for a balanced
- textual document the internal memory requirement is about 4 times the
- size of the UTF8 serialization of this document (example the XML-1.0
- recommendation is a bit more of 150KBytes and takes 650KBytes of main
- memory when parsed). Validation will add a amount of memory required for
- maintaining the external Dtd state which should be linear with the
- complexity of the content model defined by the Dtd</li>
- <li>If you need to work with fixed memory requirements or don't need the
- full DOM tree then using the <a href="xmlreader.html">xmlReader
- interface</a> is probably the best way to proceed, it still allows to
- validate or operate on subset of the tree if needed.</li>
- <li>If you don't care about the advanced features of libxml2 like
- validation, DOM, XPath or XPointer, don't use entities, need to work with
- fixed memory requirements, and try to get the fastest parsing possible
- then the SAX interface should be used, but it has known restrictions.</li>
+<p>How much libxml2 memory require ? It's hard to tell in average it
+dependsof a number of things:</p>
+<ul>
+ <li>the parser itself should work in a fixed amount of memory, except
+ forinformation maintained about the stacks of names and entities
+ locations.The I/O and encoding handlers will probably account for a few
+ KBytes.This is true for both the XML and HTML parser (though the HTML
+ parserneed more state).</li>
+ <li>If you are generating the DOM tree then memory requirements will
+ grownearly linear with the size of the data. In general for a
+ balancedtextual document the internal memory requirement is about 4 times
+ thesize of the UTF8 serialization of this document (example the
+ XML-1.0recommendation is a bit more of 150KBytes and takes 650KBytes of
+ mainmemory when parsed). Validation will add a amount of memory required
+ formaintaining the external Dtd state which should be linear with
+ thecomplexity of the content model defined by the Dtd</li>
+ <li>If you need to work with fixed memory requirements or don't need
+ thefull DOM tree then using the <a
+ href="xmlreader.html">xmlReaderinterface</a>is probably the best way to
+ proceed, it still allows tovalidate or operate on subset of the tree if
+ needed.</li>
+ <li>If you don't care about the advanced features of libxml2
+ likevalidation, DOM, XPath or XPointer, don't use entities, need to work
+ withfixed memory requirements, and try to get the fastest parsing
+ possiblethen the SAX interface should be used, but it has known
+ restrictions.</li>
</ul>
<p></p>
<h2><a name="Encodings">Encodings support</a></h2>
-<p>If you are not really familiar with Internationalization (usual shortcut
-is I18N) , Unicode, characters and glyphs, I suggest you read a <a
-href="http://www.tbray.org/ongoing/When/200x/2003/04/06/Unicode">presentation</a>
-by Tim Bray on Unicode and why you should care about it.</p>
+<p>If you are not really familiar with Internationalization (usual shortcutis
+I18N) , Unicode, characters and glyphs, I suggest you read a <a
+href="http://www.tbray.org/ongoing/When/200x/2003/04/06/Unicode">presentation</a>by
+Tim Bray on Unicode and why you should care about it.</p>
-<p>If you don't understand why <b>it does not make sense to have a string
-without knowing what encoding it uses</b>, then as Joel Spolsky said <a
-href="http://www.joelonsoftware.com/articles/Unicode.html">please do not
-write another line of code until you finish reading that article.</a>. It is
-a prerequisite to understand this page, and avoid a lot of problems with
-libxml2, XML or text processing in general.</p>
+<p>If you don't understand why <b>it does not make sense to have a
+stringwithout knowing what encoding it uses</b>, then as Joel Spolsky said <a
+href="http://www.joelonsoftware.com/articles/Unicode.html">please do notwrite
+another line of code until you finish reading that article.</a>. It isa
+prerequisite to understand this page, and avoid a lot of problems
+withlibxml2, XML or text processing in general.</p>
<p>Table of Content:</p>
<ol>
- <li><a href="encoding.html#What">What does internationalization support
- mean ?</a></li>
- <li><a href="encoding.html#internal">The internal encoding, how and
- why</a></li>
+ <li><a href="encoding.html#What">What does internationalization supportmean
+ ?</a></li>
+ <li><a href="encoding.html#internal">The internal encoding, how
+ andwhy</a></li>
<li><a href="encoding.html#implemente">How is it implemented ?</a></li>
<li><a href="encoding.html#Default">Default supported encodings</a></li>
- <li><a href="encoding.html#extend">How to extend the existing
- support</a></li>
+ <li><a href="encoding.html#extend">How to extend the
+ existingsupport</a></li>
</ol>
<h3><a name="What">What does internationalization support mean ?</a></h3>
-<p>XML was designed from the start to allow the support of any character set
-by using Unicode. Any conformant XML parser has to support the UTF-8 and
-UTF-16 default encodings which can both express the full unicode ranges. UTF8
-is a variable length encoding whose greatest points are to reuse the same
-encoding for ASCII and to save space for Western encodings, but it is a bit
-more complex to handle in practice. UTF-16 use 2 bytes per character (and
-sometimes combines two pairs), it makes implementation easier, but looks a
-bit overkill for Western languages encoding. Moreover the XML specification
-allows the document to be encoded in other encodings at the condition that
-they are clearly labeled as such. For example the following is a wellformed
-XML document encoded in ISO-8859-1 and using accentuated letters that we
-French like for both markup and content:</p>
+<p>XML was designed from the start to allow the support of any character
+setby using Unicode. Any conformant XML parser has to support the UTF-8
+andUTF-16 default encodings which can both express the full unicode ranges.
+UTF8is a variable length encoding whose greatest points are to reuse the
+sameencoding for ASCII and to save space for Western encodings, but it is a
+bitmore complex to handle in practice. UTF-16 use 2 bytes per character
+(andsometimes combines two pairs), it makes implementation easier, but looks
+abit overkill for Western languages encoding. Moreover the XML
+specificationallows the document to be encoded in other encodings at the
+condition thatthey are clearly labeled as such. For example the following is
+a wellformedXML document encoded in ISO-8859-1 and using accentuated letters
+that weFrench like for both markup and content:</p>
<pre>&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;
&lt;très&gt;là&lt;/très&gt;</pre>
@@ -3387,18 +3410,18 @@ French like for both markup and content:</p>
<li>informations about it's encoding are saved</li>
<li>it can be modified</li>
<li>it can be saved in its original encoding</li>
- <li>it can also be saved in another encoding supported by libxml2 (for
- example straight UTF8 or even an ASCII form)</li>
+ <li>it can also be saved in another encoding supported by libxml2
+ (forexample straight UTF8 or even an ASCII form)</li>
</ul>
-<p>Another very important point is that the whole libxml2 API, with the
-exception of a few routines to read with a specific encoding or save to a
-specific encoding, is completely agnostic about the original encoding of the
-document.</p>
+<p>Another very important point is that the whole libxml2 API, with
+theexception of a few routines to read with a specific encoding or save to
+aspecific encoding, is completely agnostic about the original encoding of
+thedocument.</p>
-<p>It should be noted too that the HTML parser embedded in libxml2 now obey
-the same rules too, the following document will be (as of 2.2.2) handled in
-an internationalized fashion by libxml2 too:</p>
+<p>It should be noted too that the HTML parser embedded in libxml2 now
+obeythe same rules too, the following document will be (as of 2.2.2) handled
+inan internationalized fashion by libxml2 too:</p>
<pre>&lt;!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd"&gt;
&lt;html lang="fr"&gt;
@@ -3411,73 +3434,75 @@ an internationalized fashion by libxml2 too:</p>
<h3><a name="internal">The internal encoding, how and why</a></h3>
-<p>One of the core decisions was to force all documents to be converted to a
-default internal encoding, and that encoding to be UTF-8, here are the
-rationales for those choices:</p>
-<ul>
- <li>keeping the native encoding in the internal form would force the libxml
- users (or the code associated) to be fully aware of the encoding of the
- original document, for examples when adding a text node to a document,
- the content would have to be provided in the document encoding, i.e. the
- client code would have to check it before hand, make sure it's conformant
- to the encoding, etc ... Very hard in practice, though in some specific
- cases this may make sense.</li>
- <li>the second decision was which encoding. From the XML spec only UTF8 and
- UTF16 really makes sense as being the two only encodings for which there
- is mandatory support. UCS-4 (32 bits fixed size encoding) could be
- considered an intelligent choice too since it's a direct Unicode mapping
- support. I selected UTF-8 on the basis of efficiency and compatibility
- with surrounding software:
+<p>One of the core decisions was to force all documents to be converted to
+adefault internal encoding, and that encoding to be UTF-8, here are
+therationales for those choices:</p>
+<ul>
+ <li>keeping the native encoding in the internal form would force the
+ libxmlusers (or the code associated) to be fully aware of the encoding of
+ theoriginal document, for examples when adding a text node to a
+ document,the content would have to be provided in the document encoding,
+ i.e. theclient code would have to check it before hand, make sure it's
+ conformantto the encoding, etc ... Very hard in practice, though in some
+ specificcases this may make sense.</li>
+ <li>the second decision was which encoding. From the XML spec only UTF8
+ andUTF16 really makes sense as being the two only encodings for which
+ thereis mandatory support. UCS-4 (32 bits fixed size encoding) could
+ beconsidered an intelligent choice too since it's a direct Unicode
+ mappingsupport. I selected UTF-8 on the basis of efficiency and
+ compatibilitywith surrounding software:
<ul>
- <li>UTF-8 while a bit more complex to convert from/to (i.e. slightly
- more costly to import and export CPU wise) is also far more compact
- than UTF-16 (and UCS-4) for a majority of the documents I see it used
- for right now (RPM RDF catalogs, advogato data, various configuration
- file formats, etc.) and the key point for today's computer
- architecture is efficient uses of caches. If one nearly double the
- memory requirement to store the same amount of data, this will trash
- caches (main memory/external caches/internal caches) and my take is
- that this harms the system far more than the CPU requirements needed
- for the conversion to UTF-8</li>
- <li>Most of libxml2 version 1 users were using it with straight ASCII
- most of the time, doing the conversion with an internal encoding
- requiring all their code to be rewritten was a serious show-stopper
- for using UTF-16 or UCS-4.</li>
- <li>UTF-8 is being used as the de-facto internal encoding standard for
- related code like the <a href="http://www.pango.org/">pango</a>
- upcoming Gnome text widget, and a lot of Unix code (yet another place
- where Unix programmer base takes a different approach from Microsoft
- - they are using UTF-16)</li>
+ <li>UTF-8 while a bit more complex to convert from/to (i.e.
+ slightlymore costly to import and export CPU wise) is also far more
+ compactthan UTF-16 (and UCS-4) for a majority of the documents I see
+ it usedfor right now (RPM RDF catalogs, advogato data, various
+ configurationfile formats, etc.) and the key point for today's
+ computerarchitecture is efficient uses of caches. If one nearly
+ double thememory requirement to store the same amount of data, this
+ will trashcaches (main memory/external caches/internal caches) and my
+ take isthat this harms the system far more than the CPU requirements
+ neededfor the conversion to UTF-8</li>
+ <li>Most of libxml2 version 1 users were using it with straight
+ ASCIImost of the time, doing the conversion with an internal
+ encodingrequiring all their code to be rewritten was a serious
+ show-stopperfor using UTF-16 or UCS-4.</li>
+ <li>UTF-8 is being used as the de-facto internal encoding standard
+ forrelated code like the <a
+ href="http://www.pango.org/">pango</a>upcoming Gnome text widget, and
+ a lot of Unix code (yet another placewhere Unix programmer base takes
+ a different approach from Microsoft- they are using UTF-16)</li>
</ul>
</li>
</ul>
<p>What does this mean in practice for the libxml2 user:</p>
<ul>
- <li>xmlChar, the libxml2 data type is a byte, those bytes must be assembled
- as UTF-8 valid strings. The proper way to terminate an xmlChar * string
- is simply to append 0 byte, as usual.</li>
- <li>One just need to make sure that when using chars outside the ASCII set,
- the values has been properly converted to UTF-8</li>
+ <li>xmlChar, the libxml2 data type is a byte, those bytes must be
+ assembledas UTF-8 valid strings. The proper way to terminate an xmlChar *
+ stringis simply to append 0 byte, as usual.</li>
+ <li>One just need to make sure that when using chars outside the ASCII
+ set,the values has been properly converted to UTF-8</li>
</ul>
<h3><a name="implemente">How is it implemented ?</a></h3>
-<p>Let's describe how all this works within libxml, basically the I18N
-(internationalization) support get triggered only during I/O operation, i.e.
-when reading a document or saving one. Let's look first at the reading
-sequence:</p>
+<p>Let's describe how all this works within libxml, basically the
+I18N(internationalization) support get triggered only during I/O operation,
+i.e.when reading a document or saving one. Let's look first at the
+readingsequence:</p>
<ol>
- <li>when a document is processed, we usually don't know the encoding, a
- simple heuristic allows to detect UTF-16 and UCS-4 from encodings where
- the ASCII range (0-0x7F) maps with ASCII</li>
- <li>the xml declaration if available is parsed, including the encoding
- declaration. At that point, if the autodetected encoding is different
- from the one declared a call to xmlSwitchEncoding() is issued.</li>
- <li>If there is no encoding declaration, then the input has to be in either
- UTF-8 or UTF-16, if it is not then at some point when processing the
- input, the converter/checker of UTF-8 form will raise an encoding error.
- You may end-up with a garbled document, or no document at all ! Example:
+ <li>when a document is processed, we usually don't know the encoding,
+ asimple heuristic allows to detect UTF-16 and UCS-4 from encodings
+ wherethe ASCII range (0-0x7F) maps with ASCII</li>
+ <li>the xml declaration if available is parsed, including the
+ encodingdeclaration. At that point, if the autodetected encoding is
+ differentfrom the one declared a call to xmlSwitchEncoding() is
+ issued.</li>
+ <li>If there is no encoding declaration, then the input has to be in
+ eitherUTF-8 or UTF-16, if it is not then at some point when processing
+ theinput, the converter/checker of UTF-8 form will raise an encoding
+ error.You may end-up with a garbled document, or no document at all !
+ Example:
<pre>~/XML -&gt; ./xmllint err.xml
err.xml:1: error: Input is not proper UTF-8, indicate encoding !
&lt;très&gt;là&lt;/très&gt;
@@ -3486,58 +3511,58 @@ err.xml:1: error: Bytes: 0xE8 0x73 0x3E 0x6C
&lt;très&gt;là&lt;/très&gt;
^</pre>
</li>
- <li>xmlSwitchEncoding() does an encoding name lookup, canonicalize it, and
- then search the default registered encoding converters for that encoding.
- If it's not within the default set and iconv() support has been compiled
- it, it will ask iconv for such an encoder. If this fails then the parser
- will report an error and stops processing:
+ <li>xmlSwitchEncoding() does an encoding name lookup, canonicalize it,
+ andthen search the default registered encoding converters for that
+ encoding.If it's not within the default set and iconv() support has been
+ compiledit, it will ask iconv for such an encoder. If this fails then the
+ parserwill report an error and stops processing:
<pre>~/XML -&gt; ./xmllint err2.xml
err2.xml:1: error: Unsupported encoding UnsupportedEnc
&lt;?xml version="1.0" encoding="UnsupportedEnc"?&gt;
^</pre>
</li>
- <li>From that point the encoder processes progressively the input (it is
- plugged as a front-end to the I/O module) for that entity. It captures
- and converts on-the-fly the document to be parsed to UTF-8. The parser
- itself just does UTF-8 checking of this input and process it
- transparently. The only difference is that the encoding information has
- been added to the parsing context (more precisely to the input
- corresponding to this entity).</li>
- <li>The result (when using DOM) is an internal form completely in UTF-8
- with just an encoding information on the document node.</li>
+ <li>From that point the encoder processes progressively the input (it
+ isplugged as a front-end to the I/O module) for that entity. It
+ capturesand converts on-the-fly the document to be parsed to UTF-8. The
+ parseritself just does UTF-8 checking of this input and process
+ ittransparently. The only difference is that the encoding information
+ hasbeen added to the parsing context (more precisely to the
+ inputcorresponding to this entity).</li>
+ <li>The result (when using DOM) is an internal form completely in UTF-8with
+ just an encoding information on the document node.</li>
</ol>
-<p>Ok then what happens when saving the document (assuming you
-collected/built an xmlDoc DOM like structure) ? It depends on the function
-called, xmlSaveFile() will just try to save in the original encoding, while
-xmlSaveFileTo() and xmlSaveFileEnc() can optionally save to a given
-encoding:</p>
+<p>Ok then what happens when saving the document (assuming youcollected/built
+an xmlDoc DOM like structure) ? It depends on the functioncalled,
+xmlSaveFile() will just try to save in the original encoding,
+whilexmlSaveFileTo() and xmlSaveFileEnc() can optionally save to a
+givenencoding:</p>
<ol>
- <li>if no encoding is given, libxml2 will look for an encoding value
- associated to the document and if it exists will try to save to that
- encoding,
+ <li>if no encoding is given, libxml2 will look for an encoding
+ valueassociated to the document and if it exists will try to save to
+ thatencoding,
<p>otherwise everything is written in the internal form, i.e. UTF-8</p>
</li>
- <li>so if an encoding was specified, either at the API level or on the
- document, libxml2 will again canonicalize the encoding name, lookup for a
- converter in the registered set or through iconv. If not found the
- function will return an error code</li>
- <li>the converter is placed before the I/O buffer layer, as another kind of
- buffer, then libxml2 will simply push the UTF-8 serialization to through
- that buffer, which will then progressively be converted and pushed onto
- the I/O layer.</li>
- <li>It is possible that the converter code fails on some input, for example
- trying to push an UTF-8 encoded Chinese character through the UTF-8 to
- ISO-8859-1 converter won't work. Since the encoders are progressive they
- will just report the error and the number of bytes converted, at that
- point libxml2 will decode the offending character, remove it from the
- buffer and replace it with the associated charRef encoding &amp;#123; and
- resume the conversion. This guarantees that any document will be saved
- without losses (except for markup names where this is not legal, this is
- a problem in the current version, in practice avoid using non-ascii
- characters for tag or attribute names). A special "ascii" encoding name
- is used to save documents to a pure ascii form can be used when
- portability is really crucial</li>
+ <li>so if an encoding was specified, either at the API level or on
+ thedocument, libxml2 will again canonicalize the encoding name, lookup
+ for aconverter in the registered set or through iconv. If not found
+ thefunction will return an error code</li>
+ <li>the converter is placed before the I/O buffer layer, as another kind
+ ofbuffer, then libxml2 will simply push the UTF-8 serialization to
+ throughthat buffer, which will then progressively be converted and pushed
+ ontothe I/O layer.</li>
+ <li>It is possible that the converter code fails on some input, for
+ exampletrying to push an UTF-8 encoded Chinese character through the
+ UTF-8 toISO-8859-1 converter won't work. Since the encoders are
+ progressive theywill just report the error and the number of bytes
+ converted, at thatpoint libxml2 will decode the offending character,
+ remove it from thebuffer and replace it with the associated charRef
+ encoding &amp;#123; andresume the conversion. This guarantees that any
+ document will be savedwithout losses (except for markup names where this
+ is not legal, this isa problem in the current version, in practice avoid
+ using non-asciicharacters for tag or attribute names). A special "ascii"
+ encoding nameis used to save documents to a pure ascii form can be used
+ whenportability is really crucial</li>
</ol>
<p>Here are a few examples based on the same test document:</p>
@@ -3546,52 +3571,52 @@ encoding:</p>
&lt;très&gt;là&lt;/très&gt;
~/XML -&gt; ./xmllint --encode UTF-8 isolat1
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
-&lt;très&gt;là &nbsp;&lt;/très&gt;
+&lt;très&gt;là  &lt;/très&gt;
~/XML -&gt; </pre>
-<p>The same processing is applied (and reuse most of the code) for HTML I18N
-processing. Looking up and modifying the content encoding is a bit more
-difficult since it is located in a &lt;meta&gt; tag under the &lt;head&gt;,
-so a couple of functions htmlGetMetaEncoding() and htmlSetMetaEncoding() have
-been provided. The parser also attempts to switch encoding on the fly when
-detecting such a tag on input. Except for that the processing is the same
-(and again reuses the same code).</p>
+<p>The same processing is applied (and reuse most of the code) for HTML
+I18Nprocessing. Looking up and modifying the content encoding is a bit
+moredifficult since it is located in a &lt;meta&gt; tag under the
+&lt;head&gt;,so a couple of functions htmlGetMetaEncoding() and
+htmlSetMetaEncoding() havebeen provided. The parser also attempts to switch
+encoding on the fly whendetecting such a tag on input. Except for that the
+processing is the same(and again reuses the same code).</p>
<h3><a name="Default">Default supported encodings</a></h3>
-<p>libxml2 has a set of default converters for the following encodings
-(located in encoding.c):</p>
+<p>libxml2 has a set of default converters for the following
+encodings(located in encoding.c):</p>
<ol>
<li>UTF-8 is supported by default (null handlers)</li>
<li>UTF-16, both little and big endian</li>
<li>ISO-Latin-1 (ISO-8859-1) covering most western languages</li>
<li>ASCII, useful mostly for saving</li>
- <li>HTML, a specific handler for the conversion of UTF-8 to ASCII with HTML
- predefined entities like &amp;copy; for the Copyright sign.</li>
+ <li>HTML, a specific handler for the conversion of UTF-8 to ASCII with
+ HTMLpredefined entities like &amp;copy; for the Copyright sign.</li>
</ol>
-<p>More over when compiled on an Unix platform with iconv support the full
-set of encodings supported by iconv can be instantly be used by libxml. On a
-linux machine with glibc-2.1 the list of supported encodings and aliases fill
-3 full pages, and include UCS-4, the full set of ISO-Latin encodings, and the
-various Japanese ones.</p>
+<p>More over when compiled on an Unix platform with iconv support the fullset
+of encodings supported by iconv can be instantly be used by libxml. On alinux
+machine with glibc-2.1 the list of supported encodings and aliases fill3 full
+pages, and include UCS-4, the full set of ISO-Latin encodings, and thevarious
+Japanese ones.</p>
-<p>To convert from the UTF-8 values returned from the API to another encoding
-then it is possible to use the function provided from <a
-href="html/libxml-encoding.html">the encoding module</a> like <a
-href="html/libxml-encoding.html#UTF8Toisolat1">UTF8Toisolat1</a>, or use the
-POSIX <a
-href="http://www.opengroup.org/onlinepubs/009695399/functions/iconv.html">iconv()</a>
-API directly.</p>
+<p>To convert from the UTF-8 values returned from the API to another
+encodingthen it is possible to use the function provided from <a
+href="html/libxml-encoding.html">the encoding module</a>like <a
+href="html/libxml-encoding.html#UTF8Toisolat1">UTF8Toisolat1</a>, or use
+thePOSIX <a
+href="http://www.opengroup.org/onlinepubs/009695399/functions/iconv.html">iconv()</a>API
+directly.</p>
<h4>Encoding aliases</h4>
-<p>From 2.2.3, libxml2 has support to register encoding names aliases. The
-goal is to be able to parse document whose encoding is supported but where
-the name differs (for example from the default set of names accepted by
-iconv). The following functions allow to register and handle new aliases for
-existing encodings. Once registered libxml2 will automatically lookup the
-aliases when handling a document:</p>
+<p>From 2.2.3, libxml2 has support to register encoding names aliases.
+Thegoal is to be able to parse document whose encoding is supported but
+wherethe name differs (for example from the default set of names accepted
+byiconv). The following functions allow to register and handle new aliases
+forexisting encodings. Once registered libxml2 will automatically lookup
+thealiases when handling a document:</p>
<ul>
<li>int xmlAddEncodingAlias(const char *name, const char *alias);</li>
<li>int xmlDelEncodingAlias(const char *alias);</li>
@@ -3601,14 +3626,14 @@ aliases when handling a document:</p>
<h3><a name="extend">How to extend the existing support</a></h3>
-<p>Well adding support for new encoding, or overriding one of the encoders
-(assuming it is buggy) should not be hard, just write input and output
-conversion routines to/from UTF-8, and register them using
-xmlNewCharEncodingHandler(name, xxxToUTF8, UTF8Toxxx), and they will be
-called automatically if the parser(s) encounter such an encoding name
-(register it uppercase, this will help). The description of the encoders,
-their arguments and expected return values are described in the encoding.h
-header.</p>
+<p>Well adding support for new encoding, or overriding one of the
+encoders(assuming it is buggy) should not be hard, just write input and
+outputconversion routines to/from UTF-8, and register them
+usingxmlNewCharEncodingHandler(name, xxxToUTF8, UTF8Toxxx), and they will
+becalled automatically if the parser(s) encounter such an encoding
+name(register it uppercase, this will help). The description of the
+encoders,their arguments and expected return values are described in the
+encoding.hheader.</p>
<h2><a name="IO">I/O Interfaces</a></h2>
@@ -3625,91 +3650,92 @@ header.</p>
<h3><a name="General1">General overview</a></h3>
<p>The module <code><a
-href="http://xmlsoft.org/html/libxml-xmlio.html">xmlIO.h</a></code> provides
-the interfaces to the libxml2 I/O system. This consists of 4 main parts:</p>
-<ul>
- <li>Entities loader, this is a routine which tries to fetch the entities
- (files) based on their PUBLIC and SYSTEM identifiers. The default loader
- don't look at the public identifier since libxml2 do not maintain a
- catalog. You can redefine you own entity loader by using
- <code>xmlGetExternalEntityLoader()</code> and
- <code>xmlSetExternalEntityLoader()</code>. <a href="#entities">Check the
- example</a>.</li>
- <li>Input I/O buffers which are a commodity structure used by the parser(s)
- input layer to handle fetching the informations to feed the parser. This
- provides buffering and is also a placeholder where the encoding
- converters to UTF8 are piggy-backed.</li>
- <li>Output I/O buffers are similar to the Input ones and fulfill similar
- task but when generating a serialization from a tree.</li>
- <li>A mechanism to register sets of I/O callbacks and associate them with
- specific naming schemes like the protocol part of the URIs.
- <p>This affect the default I/O operations and allows to use specific I/O
- handlers for certain names.</p>
+href="http://xmlsoft.org/html/libxml-xmlio.html">xmlIO.h</a></code>providesthe
+interfaces to the libxml2 I/O system. This consists of 4 main parts:</p>
+<ul>
+ <li>Entities loader, this is a routine which tries to fetch the
+ entities(files) based on their PUBLIC and SYSTEM identifiers. The default
+ loaderdon't look at the public identifier since libxml2 do not maintain
+ acatalog. You can redefine you own entity loader by
+ using<code>xmlGetExternalEntityLoader()</code>and<code>xmlSetExternalEntityLoader()</code>.
+ <a href="#entities">Check theexample</a>.</li>
+ <li>Input I/O buffers which are a commodity structure used by the
+ parser(s)input layer to handle fetching the informations to feed the
+ parser. Thisprovides buffering and is also a placeholder where the
+ encodingconverters to UTF8 are piggy-backed.</li>
+ <li>Output I/O buffers are similar to the Input ones and fulfill
+ similartask but when generating a serialization from a tree.</li>
+ <li>A mechanism to register sets of I/O callbacks and associate them
+ withspecific naming schemes like the protocol part of the URIs.
+ <p>This affect the default I/O operations and allows to use specific
+ I/Ohandlers for certain names.</p>
</li>
</ul>
-<p>The general mechanism used when loading http://rpmfind.net/xml.html for
-example in the HTML parser is the following:</p>
+<p>The general mechanism used when loading http://rpmfind.net/xml.html
+forexample in the HTML parser is the following:</p>
<ol>
- <li>The default entity loader calls <code>xmlNewInputFromFile()</code> with
- the parsing context and the URI string.</li>
- <li>the URI string is checked against the existing registered handlers
- using their match() callback function, if the HTTP module was compiled
- in, it is registered and its match() function will succeeds</li>
- <li>the open() function of the handler is called and if successful will
- return an I/O Input buffer</li>
- <li>the parser will the start reading from this buffer and progressively
- fetch information from the resource, calling the read() function of the
- handler until the resource is exhausted</li>
- <li>if an encoding change is detected it will be installed on the input
- buffer, providing buffering and efficient use of the conversion
- routines</li>
- <li>once the parser has finished, the close() function of the handler is
- called once and the Input buffer and associated resources are
- deallocated.</li>
+ <li>The default entity loader calls
+ <code>xmlNewInputFromFile()</code>withthe parsing context and the URI
+ string.</li>
+ <li>the URI string is checked against the existing registered handlersusing
+ their match() callback function, if the HTTP module was compiledin, it is
+ registered and its match() function will succeeds</li>
+ <li>the open() function of the handler is called and if successful
+ willreturn an I/O Input buffer</li>
+ <li>the parser will the start reading from this buffer and
+ progressivelyfetch information from the resource, calling the read()
+ function of thehandler until the resource is exhausted</li>
+ <li>if an encoding change is detected it will be installed on the
+ inputbuffer, providing buffering and efficient use of the
+ conversionroutines</li>
+ <li>once the parser has finished, the close() function of the handler
+ iscalled once and the Input buffer and associated resources
+ aredeallocated.</li>
</ol>
-<p>The user defined callbacks are checked first to allow overriding of the
-default libxml2 I/O routines.</p>
+<p>The user defined callbacks are checked first to allow overriding of
+thedefault libxml2 I/O routines.</p>
<h3><a name="basic">The basic buffer type</a></h3>
-<p>All the buffer manipulation handling is done using the
-<code>xmlBuffer</code> type define in <code><a
-href="http://xmlsoft.org/html/libxml-tree.html">tree.h</a> </code>which is a
-resizable memory buffer. The buffer allocation strategy can be selected to be
-either best-fit or use an exponential doubling one (CPU vs. memory use
-trade-off). The values are <code>XML_BUFFER_ALLOC_EXACT</code> and
-<code>XML_BUFFER_ALLOC_DOUBLEIT</code>, and can be set individually or on a
-system wide basis using <code>xmlBufferSetAllocationScheme()</code>. A number
-of functions allows to manipulate buffers with names starting with the
-<code>xmlBuffer...</code> prefix.</p>
+<p>All the buffer manipulation handling is done using
+the<code>xmlBuffer</code>type define in <code><a
+href="http://xmlsoft.org/html/libxml-tree.html">tree.h</a></code>which is
+aresizable memory buffer. The buffer allocation strategy can be selected to
+beeither best-fit or use an exponential doubling one (CPU vs. memory
+usetrade-off). The values are
+<code>XML_BUFFER_ALLOC_EXACT</code>and<code>XML_BUFFER_ALLOC_DOUBLEIT</code>,
+and can be set individually or on asystem wide basis using
+<code>xmlBufferSetAllocationScheme()</code>. A numberof functions allows to
+manipulate buffers with names starting with
+the<code>xmlBuffer...</code>prefix.</p>
<h3><a name="Input">Input I/O handlers</a></h3>
-<p>An Input I/O handler is a simple structure
-<code>xmlParserInputBuffer</code> containing a context associated to the
-resource (file descriptor, or pointer to a protocol handler), the read() and
-close() callbacks to use and an xmlBuffer. And extra xmlBuffer and a charset
-encoding handler are also present to support charset conversion when
-needed.</p>
+<p>An Input I/O handler is a simple
+structure<code>xmlParserInputBuffer</code>containing a context associated to
+theresource (file descriptor, or pointer to a protocol handler), the read()
+andclose() callbacks to use and an xmlBuffer. And extra xmlBuffer and a
+charsetencoding handler are also present to support charset conversion
+whenneeded.</p>
<h3><a name="Output">Output I/O handlers</a></h3>
-<p>An Output handler <code>xmlOutputBuffer</code> is completely similar to an
-Input one except the callbacks are write() and close().</p>
+<p>An Output handler <code>xmlOutputBuffer</code>is completely similar to
+anInput one except the callbacks are write() and close().</p>
<h3><a name="entities">The entities loader</a></h3>
-<p>The entity loader resolves requests for new entities and create inputs for
-the parser. Creating an input from a filename or an URI string is done
-through the xmlNewInputFromFile() routine. The default entity loader do not
-handle the PUBLIC identifier associated with an entity (if any). So it just
-calls xmlNewInputFromFile() with the SYSTEM identifier (which is mandatory in
-XML).</p>
+<p>The entity loader resolves requests for new entities and create inputs
+forthe parser. Creating an input from a filename or an URI string is
+donethrough the xmlNewInputFromFile() routine. The default entity loader do
+nothandle the PUBLIC identifier associated with an entity (if any). So it
+justcalls xmlNewInputFromFile() with the SYSTEM identifier (which is
+mandatory inXML).</p>
-<p>If you want to hook up a catalog mechanism then you simply need to
-override the default entity loader, here is an example:</p>
+<p>If you want to hook up a catalog mechanism then you simply need tooverride
+the default entity loader, here is an example:</p>
<pre>#include &lt;libxml/xmlIO.h&gt;
xmlExternalEntityLoader defaultLoader = NULL;
@@ -3743,29 +3769,29 @@ int main(..) {
<h3><a name="Example2">Example of customized I/O</a></h3>
-<p>This example come from <a href="http://xmlsoft.org/messages/0708.html">a
-real use case</a>, xmlDocDump() closes the FILE * passed by the application
-and this was a problem. The <a
-href="http://xmlsoft.org/messages/0711.html">solution</a> was to redefine a
-new output handler with the closing call deactivated:</p>
+<p>This example come from <a
+href="http://xmlsoft.org/messages/0708.html">areal use case</a>,
+xmlDocDump() closes the FILE * passed by the applicationand this was a
+problem. The <a href="http://xmlsoft.org/messages/0711.html">solution</a>was
+to redefine anew output handler with the closing call deactivated:</p>
<ol>
- <li>First define a new I/O output allocator where the output don't close
- the file:
+ <li>First define a new I/O output allocator where the output don't closethe
+ file:
<pre>xmlOutputBufferPtr
xmlOutputBufferCreateOwn(FILE *file, xmlCharEncodingHandlerPtr encoder) {
-&nbsp;&nbsp;&nbsp;&nbsp;xmlOutputBufferPtr ret;
-&nbsp;&nbsp;&nbsp;&nbsp;
-&nbsp;&nbsp;&nbsp;&nbsp;if (xmlOutputCallbackInitialized == 0)
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;xmlRegisterDefaultOutputCallbacks();
-
-&nbsp;&nbsp;&nbsp;&nbsp;if (file == NULL) return(NULL);
-&nbsp;&nbsp;&nbsp;&nbsp;ret = xmlAllocOutputBuffer(encoder);
-&nbsp;&nbsp;&nbsp;&nbsp;if (ret != NULL) {
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ret-&gt;context = file;
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ret-&gt;writecallback = xmlFileWrite;
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ret-&gt;closecallback = NULL; /* No close callback */
-&nbsp;&nbsp;&nbsp;&nbsp;}
-&nbsp;&nbsp;&nbsp;&nbsp;return(ret);
+    xmlOutputBufferPtr ret;
+    
+    if (xmlOutputCallbackInitialized == 0)
+        xmlRegisterDefaultOutputCallbacks();
+
+    if (file == NULL) return(NULL);
+    ret = xmlAllocOutputBuffer(encoder);
+    if (ret != NULL) {
+        ret-&gt;context = file;
+        ret-&gt;writecallback = xmlFileWrite;
+        ret-&gt;closecallback = NULL; /* No close callback */
+    }
+    return(ret);
} </pre>
</li>
<li>And then use it to save the document:
@@ -3794,90 +3820,91 @@ res = xmlSaveFileTo(output, doc, NULL);
<li><a href="#reference">How to tune catalog usage</a></li>
<li><a href="#validate">How to debug catalog processing</a></li>
<li><a href="#Declaring">How to create and maintain catalogs</a></li>
- <li><a href="#implemento">The implementor corner quick review of the
- API</a></li>
+ <li><a href="#implemento">The implementor corner quick review of
+ theAPI</a></li>
<li><a href="#Other">Other resources</a></li>
</ol>
<h3><a name="General2">General overview</a></h3>
-<p>What is a catalog? Basically it's a lookup mechanism used when an entity
-(a file or a remote resource) references another entity. The catalog lookup
-is inserted between the moment the reference is recognized by the software
-(XML parser, stylesheet processing, or even images referenced for inclusion
-in a rendering) and the time where loading that resource is actually
-started.</p>
+<p>What is a catalog? Basically it's a lookup mechanism used when an entity(a
+file or a remote resource) references another entity. The catalog lookupis
+inserted between the moment the reference is recognized by the software(XML
+parser, stylesheet processing, or even images referenced for inclusionin a
+rendering) and the time where loading that resource is actuallystarted.</p>
<p>It is basically used for 3 things:</p>
<ul>
- <li>mapping from "logical" names, the public identifiers and a more
- concrete name usable for download (and URI). For example it can associate
- the logical name
+ <li>mapping from "logical" names, the public identifiers and a moreconcrete
+ name usable for download (and URI). For example it can associatethe
+ logical name
<p>"-//OASIS//DTD DocBook XML V4.1.2//EN"</p>
- <p>of the DocBook 4.1.2 XML DTD with the actual URL where it can be
- downloaded</p>
+ <p>of the DocBook 4.1.2 XML DTD with the actual URL where it can
+ bedownloaded</p>
<p>http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd</p>
</li>
- <li>remapping from a given URL to another one, like an HTTP indirection
- saying that
+ <li>remapping from a given URL to another one, like an HTTP
+ indirectionsaying that
<p>"http://www.oasis-open.org/committes/tr.xsl"</p>
<p>should really be looked at</p>
<p>"http://www.oasis-open.org/committes/entity/stylesheets/base/tr.xsl"</p>
</li>
- <li>providing a local cache mechanism allowing to load the entities
- associated to public identifiers or remote resources, this is a really
- important feature for any significant deployment of XML or SGML since it
- allows to avoid the aleas and delays associated to fetching remote
- resources.</li>
+ <li>providing a local cache mechanism allowing to load the
+ entitiesassociated to public identifiers or remote resources, this is a
+ reallyimportant feature for any significant deployment of XML or SGML
+ since itallows to avoid the aleas and delays associated to fetching
+ remoteresources.</li>
</ul>
<h3><a name="definition">The definitions</a></h3>
<p>Libxml, as of 2.4.3 implements 2 kind of catalogs:</p>
<ul>
- <li>the older SGML catalogs, the official spec is SGML Open Technical
- Resolution TR9401:1997, but is better understood by reading <a
- href="http://www.jclark.com/sp/catalog.htm">the SP Catalog page</a> from
- James Clark. This is relatively old and not the preferred mode of
- operation of libxml.</li>
- <li><a href="http://www.oasis-open.org/committees/entity/spec.html">XML
- Catalogs</a> is far more flexible, more recent, uses an XML syntax and
- should scale quite better. This is the default option of libxml.</li>
+ <li>the older SGML catalogs, the official spec is SGML Open
+ TechnicalResolution TR9401:1997, but is better understood by reading <a
+ href="http://www.jclark.com/sp/catalog.htm">the SP Catalog
+ page</a>fromJames Clark. This is relatively old and not the preferred
+ mode ofoperation of libxml.</li>
+ <li><a
+ href="http://www.oasis-open.org/committees/entity/spec.html">XMLCatalogs</a>is
+ far more flexible, more recent, uses an XML syntax andshould scale quite
+ better. This is the default option of libxml.</li>
</ul>
<p></p>
<h3><a name="Simple">Using catalog</a></h3>
-<p>In a normal environment libxml2 will by default check the presence of a
-catalog in /etc/xml/catalog, and assuming it has been correctly populated,
-the processing is completely transparent to the document user. To take a
-concrete example, suppose you are authoring a DocBook document, this one
-starts with the following DOCTYPE definition:</p>
+<p>In a normal environment libxml2 will by default check the presence of
+acatalog in /etc/xml/catalog, and assuming it has been correctly
+populated,the processing is completely transparent to the document user. To
+take aconcrete example, suppose you are authoring a DocBook document, this
+onestarts with the following DOCTYPE definition:</p>
<pre>&lt;?xml version='1.0'?&gt;
&lt;!DOCTYPE book PUBLIC "-//Norman Walsh//DTD DocBk XML V3.1.4//EN"
"http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd"&gt;</pre>
-<p>When validating the document with libxml, the catalog will be
-automatically consulted to lookup the public identifier "-//Norman Walsh//DTD
-DocBk XML V3.1.4//EN" and the system identifier
-"http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd", and if these entities have
-been installed on your system and the catalogs actually point to them, libxml
-will fetch them from the local disk.</p>
-
-<p style="font-size: 10pt"><strong>Note</strong>: Really don't use this
-DOCTYPE example it's a really old version, but is fine as an example.</p>
-
-<p>Libxml2 will check the catalog each time that it is requested to load an
-entity, this includes DTD, external parsed entities, stylesheets, etc ... If
-your system is correctly configured all the authoring phase and processing
-should use only local files, even if your document stays portable because it
-uses the canonical public and system ID, referencing the remote document.</p>
+<p>When validating the document with libxml, the catalog will beautomatically
+consulted to lookup the public identifier "-//Norman Walsh//DTDDocBk XML
+V3.1.4//EN" and the system
+identifier"http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd", and if these
+entities havebeen installed on your system and the catalogs actually point to
+them, libxmlwill fetch them from the local disk.</p>
+
+<p style="font-size: 10pt"><strong>Note</strong>: Really don't use
+thisDOCTYPE example it's a really old version, but is fine as an example.</p>
+
+<p>Libxml2 will check the catalog each time that it is requested to load
+anentity, this includes DTD, external parsed entities, stylesheets, etc ...
+Ifyour system is correctly configured all the authoring phase and
+processingshould use only local files, even if your document stays portable
+because ituses the canonical public and system ID, referencing the remote
+document.</p>
<h3><a name="Some">Some examples:</a></h3>
-<p>Here is a couple of fragments from XML Catalogs used in libxml2 early
-regression tests in <code>test/catalogs</code> :</p>
+<p>Here is a couple of fragments from XML Catalogs used in libxml2
+earlyregression tests in <code>test/catalogs</code>:</p>
<pre>&lt;?xml version="1.0"?&gt;
&lt;!DOCTYPE catalog PUBLIC
"-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
@@ -3887,22 +3914,22 @@ regression tests in <code>test/catalogs</code> :</p>
uri="http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"/&gt;
...</pre>
-<p>This is the beginning of a catalog for DocBook 4.1.2, XML Catalogs are
-written in XML, there is a specific namespace for catalog elements
-"urn:oasis:names:tc:entity:xmlns:xml:catalog". The first entry in this
-catalog is a <code>public</code> mapping it allows to associate a Public
-Identifier with an URI.</p>
+<p>This is the beginning of a catalog for DocBook 4.1.2, XML Catalogs
+arewritten in XML, there is a specific namespace for catalog
+elements"urn:oasis:names:tc:entity:xmlns:xml:catalog". The first entry in
+thiscatalog is a <code>public</code>mapping it allows to associate a
+PublicIdentifier with an URI.</p>
<pre>...
&lt;rewriteSystem systemIdStartString="http://www.oasis-open.org/docbook/"
rewritePrefix="file:///usr/share/xml/docbook/"/&gt;
...</pre>
-<p>A <code>rewriteSystem</code> is a very powerful instruction, it says that
-any URI starting with a given prefix should be looked at another URI
-constructed by replacing the prefix with an new one. In effect this acts like
-a cache system for a full area of the Web. In practice it is extremely useful
-with a file prefix if you have installed a copy of those resources on your
-local system.</p>
+<p>A <code>rewriteSystem</code>is a very powerful instruction, it says
+thatany URI starting with a given prefix should be looked at another
+URIconstructed by replacing the prefix with an new one. In effect this acts
+likea cache system for a full area of the Web. In practice it is extremely
+usefulwith a file prefix if you have installed a copy of those resources on
+yourlocal system.</p>
<pre>...
&lt;delegatePublic publicIdStartString="-//OASIS//DTD XML Catalog //"
catalog="file:///usr/share/xml/docbook.xml"/&gt;
@@ -3916,29 +3943,29 @@ local system.</p>
catalog="file:///usr/share/xml/docbook.xml"/&gt;
...</pre>
-<p>Delegation is the core features which allows to build a tree of catalogs,
-easier to maintain than a single catalog, based on Public Identifier, System
-Identifier or URI prefixes it instructs the catalog software to look up
-entries in another resource. This feature allow to build hierarchies of
-catalogs, the set of entries presented should be sufficient to redirect the
-resolution of all DocBook references to the specific catalog in
-<code>/usr/share/xml/docbook.xml</code> this one in turn could delegate all
-references for DocBook 4.2.1 to a specific catalog installed at the same time
-as the DocBook resources on the local machine.</p>
+<p>Delegation is the core features which allows to build a tree of
+catalogs,easier to maintain than a single catalog, based on Public
+Identifier, SystemIdentifier or URI prefixes it instructs the catalog
+software to look upentries in another resource. This feature allow to build
+hierarchies ofcatalogs, the set of entries presented should be sufficient to
+redirect theresolution of all DocBook references to the specific catalog
+in<code>/usr/share/xml/docbook.xml</code>this one in turn could delegate
+allreferences for DocBook 4.2.1 to a specific catalog installed at the same
+timeas the DocBook resources on the local machine.</p>
<h3><a name="reference">How to tune catalog usage:</a></h3>
-<p>The user can change the default catalog behaviour by redirecting queries
-to its own set of catalogs, this can be done by setting the
-<code>XML_CATALOG_FILES</code> environment variable to a list of catalogs, an
-empty one should deactivate loading the default <code>/etc/xml/catalog</code>
-default catalog</p>
+<p>The user can change the default catalog behaviour by redirecting queriesto
+its own set of catalogs, this can be done by setting
+the<code>XML_CATALOG_FILES</code>environment variable to a list of catalogs,
+anempty one should deactivate loading the default
+<code>/etc/xml/catalog</code>default catalog</p>
<h3><a name="validate">How to debug catalog processing:</a></h3>
-<p>Setting up the <code>XML_DEBUG_CATALOG</code> environment variable will
-make libxml2 output debugging informations for each catalog operations, for
-example:</p>
+<p>Setting up the <code>XML_DEBUG_CATALOG</code>environment variable willmake
+libxml2 output debugging informations for each catalog operations,
+forexample:</p>
<pre>orchis:~/XML -&gt; xmllint --memory --noout test/ent2
warning: failed to load external entity "title.xml"
orchis:~/XML -&gt; export XML_DEBUG_CATALOG=
@@ -3949,24 +3976,24 @@ warning: failed to load external entity "title.xml"
Catalogs cleanup
orchis:~/XML -&gt; </pre>
-<p>The test/ent2 references an entity, running the parser from memory makes
-the base URI unavailable and the the "title.xml" entity cannot be loaded.
-Setting up the debug environment variable allows to detect that an attempt is
-made to load the <code>/etc/xml/catalog</code> but since it's not present the
-resolution fails.</p>
+<p>The test/ent2 references an entity, running the parser from memory
+makesthe base URI unavailable and the the "title.xml" entity cannot be
+loaded.Setting up the debug environment variable allows to detect that an
+attempt ismade to load the <code>/etc/xml/catalog</code>but since it's not
+present theresolution fails.</p>
-<p>But the most advanced way to debug XML catalog processing is to use the
-<strong>xmlcatalog</strong> command shipped with libxml2, it allows to load
-catalogs and make resolution queries to see what is going on. This is also
-used for the regression tests:</p>
+<p>But the most advanced way to debug XML catalog processing is to use
+the<strong>xmlcatalog</strong>command shipped with libxml2, it allows to
+loadcatalogs and make resolution queries to see what is going on. This is
+alsoused for the regression tests:</p>
<pre>orchis:~/XML -&gt; ./xmlcatalog test/catalogs/docbook.xml \
"-//OASIS//DTD DocBook XML V4.1.2//EN"
http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
orchis:~/XML -&gt; </pre>
-<p>For debugging what is going on, adding one -v flags increase the verbosity
-level to indicate the processing done (adding a second flag also indicate
-what elements are recognized at parsing):</p>
+<p>For debugging what is going on, adding one -v flags increase the
+verbositylevel to indicate the processing done (adding a second flag also
+indicatewhat elements are recognized at parsing):</p>
<pre>orchis:~/XML -&gt; ./xmlcatalog -v test/catalogs/docbook.xml \
"-//OASIS//DTD DocBook XML V4.1.2//EN"
Parsing catalog test/catalogs/docbook.xml's content
@@ -3975,8 +4002,8 @@ http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
Catalogs cleanup
orchis:~/XML -&gt; </pre>
-<p>A shell interface is also available to debug and process multiple queries
-(and for regression tests):</p>
+<p>A shell interface is also available to debug and process multiple
+queries(and for regression tests):</p>
<pre>orchis:~/XML -&gt; ./xmlcatalog -shell test/catalogs/docbook.xml \
"-//OASIS//DTD DocBook XML V4.1.2//EN"
&gt; help
@@ -3995,14 +4022,14 @@ http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
&gt; quit
orchis:~/XML -&gt; </pre>
-<p>This should be sufficient for most debugging purpose, this was actually
-used heavily to debug the XML Catalog implementation itself.</p>
+<p>This should be sufficient for most debugging purpose, this was
+actuallyused heavily to debug the XML Catalog implementation itself.</p>
-<h3><a name="Declaring">How to create and maintain</a> catalogs:</h3>
+<h3><a name="Declaring">How to create and maintain</a>catalogs:</h3>
-<p>Basically XML Catalogs are XML files, you can either use XML tools to
-manage them or use <strong>xmlcatalog</strong> for this. The basic step is
-to create a catalog the -create option provide this facility:</p>
+<p>Basically XML Catalogs are XML files, you can either use XML tools
+tomanage them or use <strong>xmlcatalog</strong>for this. The basic step
+isto create a catalog the -create option provide this facility:</p>
<pre>orchis:~/XML -&gt; ./xmlcatalog --create tst.xml
&lt;?xml version="1.0"?&gt;
&lt;!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
@@ -4010,10 +4037,10 @@ to create a catalog the -create option provide this facility:</p>
&lt;catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"/&gt;
orchis:~/XML -&gt; </pre>
-<p>By default xmlcatalog does not overwrite the original catalog and save the
-result on the standard output, this can be overridden using the -noout
-option. The <code>-add</code> command allows to add entries in the
-catalog:</p>
+<p>By default xmlcatalog does not overwrite the original catalog and save
+theresult on the standard output, this can be overridden using the
+-nooutoption. The <code>-add</code>command allows to add entries in
+thecatalog:</p>
<pre>orchis:~/XML -&gt; ./xmlcatalog --noout --create --add "public" \
"-//OASIS//DTD DocBook XML V4.1.2//EN" \
http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd tst.xml
@@ -4027,12 +4054,12 @@ orchis:~/XML -&gt; cat tst.xml
&lt;/catalog&gt;
orchis:~/XML -&gt; </pre>
-<p>The <code>-add</code> option will always take 3 parameters even if some of
-the XML Catalog constructs (like nextCatalog) will have only a single
-argument, just pass a third empty string, it will be ignored.</p>
+<p>The <code>-add</code>option will always take 3 parameters even if some
+ofthe XML Catalog constructs (like nextCatalog) will have only a
+singleargument, just pass a third empty string, it will be ignored.</p>
-<p>Similarly the <code>-del</code> option remove matching entries from the
-catalog:</p>
+<p>Similarly the <code>-del</code>option remove matching entries from
+thecatalog:</p>
<pre>orchis:~/XML -&gt; ./xmlcatalog --del \
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" tst.xml
&lt;?xml version="1.0"?&gt;
@@ -4041,156 +4068,159 @@ catalog:</p>
&lt;catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"/&gt;
orchis:~/XML -&gt; </pre>
-<p>The catalog is now empty. Note that the matching of <code>-del</code> is
-exact and would have worked in a similar fashion with the Public ID
-string.</p>
+<p>The catalog is now empty. Note that the matching of
+<code>-del</code>isexact and would have worked in a similar fashion with the
+Public IDstring.</p>
-<p>This is rudimentary but should be sufficient to manage a not too complex
-catalog tree of resources.</p>
+<p>This is rudimentary but should be sufficient to manage a not too
+complexcatalog tree of resources.</p>
-<h3><a name="implemento">The implementor corner quick review of the
-API:</a></h3>
+<h3><a name="implemento">The implementor corner quick review of
+theAPI:</a></h3>
-<p>First, and like for every other module of libxml, there is an
-automatically generated <a href="html/libxml-catalog.html">API page for
-catalog support</a>.</p>
+<p>First, and like for every other module of libxml, there is anautomatically
+generated <a href="html/libxml-catalog.html">API page forcatalog
+support</a>.</p>
<p>The header for the catalog interfaces should be included as:</p>
<pre>#include &lt;libxml/catalog.h&gt;</pre>
-<p>The API is voluntarily kept very simple. First it is not obvious that
-applications really need access to it since it is the default behaviour of
-libxml2 (Note: it is possible to completely override libxml2 default catalog
-by using <a href="html/libxml-parser.html">xmlSetExternalEntityLoader</a> to
-plug an application specific resolver).</p>
+<p>The API is voluntarily kept very simple. First it is not obvious
+thatapplications really need access to it since it is the default behaviour
+oflibxml2 (Note: it is possible to completely override libxml2 default
+catalogby using <a
+href="html/libxml-parser.html">xmlSetExternalEntityLoader</a>toplug an
+application specific resolver).</p>
<p>Basically libxml2 support 2 catalog lists:</p>
<ul>
<li>the default one, global shared by all the application</li>
- <li>a per-document catalog, this one is built if the document uses the
- <code>oasis-xml-catalog</code> PIs to specify its own catalog list, it is
- associated to the parser context and destroyed when the parsing context
- is destroyed.</li>
+ <li>a per-document catalog, this one is built if the document uses
+ the<code>oasis-xml-catalog</code>PIs to specify its own catalog list, it
+ isassociated to the parser context and destroyed when the parsing
+ contextis destroyed.</li>
</ul>
<p>the document one will be used first if it exists.</p>
<h4>Initialization routines:</h4>
-<p>xmlInitializeCatalog(), xmlLoadCatalog() and xmlLoadCatalogs() should be
-used at startup to initialize the catalog, if the catalog should be
-initialized with specific values xmlLoadCatalog() or xmlLoadCatalogs()
-should be called before xmlInitializeCatalog() which would otherwise do a
-default initialization first.</p>
+<p>xmlInitializeCatalog(), xmlLoadCatalog() and xmlLoadCatalogs() should
+beused at startup to initialize the catalog, if the catalog should
+beinitialized with specific values xmlLoadCatalog() or
+xmlLoadCatalogs()should be called before xmlInitializeCatalog() which would
+otherwise do adefault initialization first.</p>
-<p>The xmlCatalogAddLocal() call is used by the parser to grow the document
-own catalog list if needed.</p>
+<p>The xmlCatalogAddLocal() call is used by the parser to grow the
+documentown catalog list if needed.</p>
<h4>Preferences setup:</h4>
-<p>The XML Catalog spec requires the possibility to select default
-preferences between public and system delegation,
-xmlCatalogSetDefaultPrefer() allows this, xmlCatalogSetDefaults() and
-xmlCatalogGetDefaults() allow to control if XML Catalogs resolution should
-be forbidden, allowed for global catalog, for document catalog or both, the
-default is to allow both.</p>
+<p>The XML Catalog spec requires the possibility to select defaultpreferences
+between public and system delegation,xmlCatalogSetDefaultPrefer() allows
+this, xmlCatalogSetDefaults() andxmlCatalogGetDefaults() allow to control if
+XML Catalogs resolution shouldbe forbidden, allowed for global catalog, for
+document catalog or both, thedefault is to allow both.</p>
-<p>And of course xmlCatalogSetDebug() allows to generate debug messages
-(through the xmlGenericError() mechanism).</p>
+<p>And of course xmlCatalogSetDebug() allows to generate debug
+messages(through the xmlGenericError() mechanism).</p>
<h4>Querying routines:</h4>
-<p>xmlCatalogResolve(), xmlCatalogResolveSystem(), xmlCatalogResolvePublic()
-and xmlCatalogResolveURI() are relatively explicit if you read the XML
-Catalog specification they correspond to section 7 algorithms, they should
-also work if you have loaded an SGML catalog with a simplified semantic.</p>
+<p>xmlCatalogResolve(), xmlCatalogResolveSystem(),
+xmlCatalogResolvePublic()and xmlCatalogResolveURI() are relatively explicit
+if you read the XMLCatalog specification they correspond to section 7
+algorithms, they shouldalso work if you have loaded an SGML catalog with a
+simplified semantic.</p>
-<p>xmlCatalogLocalResolve() and xmlCatalogLocalResolveURI() are the same but
-operate on the document catalog list</p>
+<p>xmlCatalogLocalResolve() and xmlCatalogLocalResolveURI() are the same
+butoperate on the document catalog list</p>
<h4>Cleanup and Miscellaneous:</h4>
-<p>xmlCatalogCleanup() free-up the global catalog, xmlCatalogFreeLocal() is
-the per-document equivalent.</p>
+<p>xmlCatalogCleanup() free-up the global catalog, xmlCatalogFreeLocal()
+isthe per-document equivalent.</p>
-<p>xmlCatalogAdd() and xmlCatalogRemove() are used to dynamically modify the
-first catalog in the global list, and xmlCatalogDump() allows to dump a
-catalog state, those routines are primarily designed for xmlcatalog, I'm not
-sure that exposing more complex interfaces (like navigation ones) would be
-really useful.</p>
+<p>xmlCatalogAdd() and xmlCatalogRemove() are used to dynamically modify
+thefirst catalog in the global list, and xmlCatalogDump() allows to dump
+acatalog state, those routines are primarily designed for xmlcatalog, I'm
+notsure that exposing more complex interfaces (like navigation ones) would
+bereally useful.</p>
-<p>The xmlParseCatalogFile() is a function used to load XML Catalog files,
-it's similar as xmlParseFile() except it bypass all catalog lookups, it's
-provided because this functionality may be useful for client tools.</p>
+<p>The xmlParseCatalogFile() is a function used to load XML Catalog
+files,it's similar as xmlParseFile() except it bypass all catalog lookups,
+it'sprovided because this functionality may be useful for client tools.</p>
<h4>threaded environments:</h4>
-<p>Since the catalog tree is built progressively, some care has been taken to
-try to avoid troubles in multithreaded environments. The code is now thread
-safe assuming that the libxml2 library has been compiled with threads
-support.</p>
+<p>Since the catalog tree is built progressively, some care has been taken
+totry to avoid troubles in multithreaded environments. The code is now
+threadsafe assuming that the libxml2 library has been compiled with
+threadssupport.</p>
<p></p>
<h3><a name="Other">Other resources</a></h3>
-<p>The XML Catalog specification is relatively recent so there isn't much
-literature to point at:</p>
+<p>The XML Catalog specification is relatively recent so there isn't
+muchliterature to point at:</p>
<ul>
<li>You can find a good rant from Norm Walsh about <a
- href="http://www.arbortext.com/Think_Tank/XML_Resources/Issue_Three/issue_three.html">the
- need for catalogs</a>, it provides a lot of context informations even if
- I don't agree with everything presented. Norm also wrote a more recent
- article <a
- href="http://wwws.sun.com/software/xml/developers/resolver/article/">XML
- entities and URI resolvers</a> describing them.</li>
- <li>An <a href="http://home.ccil.org/~cowan/XML/XCatalog.html">old XML
- catalog proposal</a> from John Cowan</li>
- <li>The <a href="http://www.rddl.org/">Resource Directory Description
- Language</a> (RDDL) another catalog system but more oriented toward
- providing metadata for XML namespaces.</li>
+ href="http://www.arbortext.com/Think_Tank/XML_Resources/Issue_Three/issue_three.html">theneed
+ for catalogs</a>, it provides a lot of context informations even ifI
+ don't agree with everything presented. Norm also wrote a more
+ recentarticle <a
+ href="http://wwws.sun.com/software/xml/developers/resolver/article/">XMLentities
+ and URI resolvers</a>describing them.</li>
+ <li>An <a href="http://home.ccil.org/~cowan/XML/XCatalog.html">old
+ XMLcatalog proposal</a>from John Cowan</li>
+ <li>The <a href="http://www.rddl.org/">Resource Directory
+ DescriptionLanguage</a>(RDDL) another catalog system but more oriented
+ towardproviding metadata for XML namespaces.</li>
<li>the page from the OASIS Technical <a
- href="http://www.oasis-open.org/committees/entity/">Committee on Entity
- Resolution</a> who maintains XML Catalog, you will find pointers to the
- specification update, some background and pointers to others tools
- providing XML Catalog support</li>
- <li>There is a <a href="buildDocBookCatalog">shell script</a> to generate
- XML Catalogs for DocBook 4.1.2 . If it can write to the /etc/xml/
- directory, it will set-up /etc/xml/catalog and /etc/xml/docbook based on
- the resources found on the system. Otherwise it will just create
- ~/xmlcatalog and ~/dbkxmlcatalog and doing:
+ href="http://www.oasis-open.org/committees/entity/">Committee on
+ EntityResolution</a>who maintains XML Catalog, you will find pointers to
+ thespecification update, some background and pointers to others
+ toolsproviding XML Catalog support</li>
+ <li>There is a <a href="buildDocBookCatalog">shell script</a>to generateXML
+ Catalogs for DocBook 4.1.2 . If it can write to the /etc/xml/directory,
+ it will set-up /etc/xml/catalog and /etc/xml/docbook based onthe
+ resources found on the system. Otherwise it will just create~/xmlcatalog
+ and ~/dbkxmlcatalog and doing:
<p><code>export XML_CATALOG_FILES=$HOME/xmlcatalog</code></p>
- <p>should allow to process DocBook documentations without requiring
- network accesses for the DTD or stylesheets</p>
+ <p>should allow to process DocBook documentations without
+ requiringnetwork accesses for the DTD or stylesheets</p>
</li>
- <li>I have uploaded <a href="ftp://xmlsoft.org/libxml2/test/dbk412catalog.tar.gz">a
- small tarball</a> containing XML Catalogs for DocBook 4.1.2 which seems
- to work fine for me too</li>
- <li>The <a href="http://www.xmlsoft.org/xmlcatalog_man.html">xmlcatalog
- manual page</a></li>
+ <li>I have uploaded <a
+ href="ftp://xmlsoft.org/libxml2/test/dbk412catalog.tar.gz">asmall
+ tarball</a>containing XML Catalogs for DocBook 4.1.2 which seemsto work
+ fine for me too</li>
+ <li>The <a
+ href="http://www.xmlsoft.org/xmlcatalog_man.html">xmlcatalogmanual
+ page</a></li>
</ul>
-<p>If you have suggestions for corrections or additions, simply contact
-me:</p>
+<p>If you have suggestions for corrections or additions, simply contactme:</p>
<h2><a name="library">The parser interfaces</a></h2>
-<p>This section is directly intended to help programmers getting bootstrapped
-using the XML tollkit from the C language. It is not intended to be
-extensive. I hope the automatically generated documents will provide the
-completeness required, but as a separate set of documents. The interfaces of
-the XML parser are by principle low level, Those interested in a higher level
-API should <a href="#DOM">look at DOM</a>.</p>
+<p>This section is directly intended to help programmers getting
+bootstrappedusing the XML tollkit from the C language. It is not intended to
+beextensive. I hope the automatically generated documents will provide
+thecompleteness required, but as a separate set of documents. The interfaces
+ofthe XML parser are by principle low level, Those interested in a higher
+levelAPI should <a href="#DOM">look at DOM</a>.</p>
-<p>The <a href="html/libxml-parser.html">parser interfaces for XML</a> are
-separated from the <a href="html/libxml-htmlparser.html">HTML parser
-interfaces</a>. Let's have a look at how the XML parser can be called:</p>
+<p>The <a href="html/libxml-parser.html">parser interfaces for
+XML</a>areseparated from the <a href="html/libxml-htmlparser.html">HTML
+parserinterfaces</a>. Let's have a look at how the XML parser can be
+called:</p>
<h3><a name="Invoking">Invoking the parser : the pull method</a></h3>
-<p>Usually, the first thing to do is to read an XML input. The parser accepts
-documents either from in-memory strings or from files. The functions are
-defined in "parser.h":</p>
+<p>Usually, the first thing to do is to read an XML input. The parser
+acceptsdocuments either from in-memory strings or from files. The functions
+aredefined in "parser.h":</p>
<dl>
<dt><code>xmlDocPtr xmlParseMemory(char *buffer, int size);</code></dt>
<dd><p>Parse a null-terminated string containing the document.</p>
@@ -4198,20 +4228,18 @@ defined in "parser.h":</p>
</dl>
<dl>
<dt><code>xmlDocPtr xmlParseFile(const char *filename);</code></dt>
- <dd><p>Parse an XML document contained in a (possibly compressed)
- file.</p>
+ <dd><p>Parse an XML document contained in a (possibly compressed)file.</p>
</dd>
</dl>
-<p>The parser returns a pointer to the document structure (or NULL in case of
-failure).</p>
+<p>The parser returns a pointer to the document structure (or NULL in case
+offailure).</p>
<h3 id="Invoking1">Invoking the parser: the push method</h3>
-<p>In order for the application to keep the control when the document is
-being fetched (which is common for GUI based programs) libxml2 provides a
-push interface, too, as of version 1.8.3. Here are the interface
-functions:</p>
+<p>In order for the application to keep the control when the document isbeing
+fetched (which is common for GUI based programs) libxml2 provides apush
+interface, too, as of version 1.8.3. Here are the interfacefunctions:</p>
<pre>xmlParserCtxtPtr xmlCreatePushParserCtxt(xmlSAXHandlerPtr sax,
void *user_data,
const char *chunk,
@@ -4244,25 +4272,25 @@ int xmlParseChunk (xmlParserCtxtPtr ctxt,
}
}</pre>
-<p>The HTML parser embedded into libxml2 also has a push interface; the
-functions are just prefixed by "html" rather than "xml".</p>
+<p>The HTML parser embedded into libxml2 also has a push interface;
+thefunctions are just prefixed by "html" rather than "xml".</p>
<h3 id="Invoking2">Invoking the parser: the SAX interface</h3>
-<p>The tree-building interface makes the parser memory-hungry, first loading
-the document in memory and then building the tree itself. Reading a document
-without building the tree is possible using the SAX interfaces (see SAX.h and
-<a href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">James
-Henstridge's documentation</a>). Note also that the push interface can be
-limited to SAX: just use the two first arguments of
-<code>xmlCreatePushParserCtxt()</code>.</p>
+<p>The tree-building interface makes the parser memory-hungry, first
+loadingthe document in memory and then building the tree itself. Reading a
+documentwithout building the tree is possible using the SAX interfaces (see
+SAX.h and<a
+href="http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html">JamesHenstridge's
+documentation</a>). Note also that the push interface can belimited to SAX:
+just use the two first arguments of<code>xmlCreatePushParserCtxt()</code>.</p>
<h3><a name="Building">Building a tree from scratch</a></h3>
-<p>The other way to get an XML tree in memory is by building it. Basically
-there is a set of functions dedicated to building new elements. (These are
-also described in &lt;libxml/tree.h&gt;.) For example, here is a piece of
-code that produces the XML document used in the previous examples:</p>
+<p>The other way to get an XML tree in memory is by building it.
+Basicallythere is a set of functions dedicated to building new elements.
+(These arealso described in &lt;libxml/tree.h&gt;.) For example, here is a
+piece ofcode that produces the XML document used in the previous examples:</p>
<pre> #include &lt;libxml/tree.h&gt;
xmlDocPtr doc;
xmlNodePtr tree, subtree;
@@ -4283,66 +4311,66 @@ code that produces the XML document used in the previous examples:</p>
<h3><a name="Traversing">Traversing the tree</a></h3>
-<p>Basically by <a href="html/libxml-tree.html">including "tree.h"</a> your
-code has access to the internal structure of all the elements of the tree.
-The names should be somewhat simple like <strong>parent</strong>,
-<strong>children</strong>, <strong>next</strong>, <strong>prev</strong>,
-<strong>properties</strong>, etc... For example, still with the previous
-example:</p>
+<p>Basically by <a href="html/libxml-tree.html">including
+"tree.h"</a>yourcode has access to the internal structure of all the elements
+of the tree.The names should be somewhat simple like
+<strong>parent</strong>,<strong>children</strong>, <strong>next</strong>,
+<strong>prev</strong>,<strong>properties</strong>, etc... For example, still
+with the previousexample:</p>
<pre><code>doc-&gt;children-&gt;children-&gt;children</code></pre>
<p>points to the title element,</p>
<pre>doc-&gt;children-&gt;children-&gt;next-&gt;children-&gt;children</pre>
-<p>points to the text node containing the chapter title "The Linux
-adventure".</p>
+<p>points to the text node containing the chapter title "The
+Linuxadventure".</p>
-<p><strong>NOTE</strong>: XML allows <em>PI</em>s and <em>comments</em> to be
-present before the document root, so <code>doc-&gt;children</code> may point
-to an element which is not the document Root Element; a function
-<code>xmlDocGetRootElement()</code> was added for this purpose.</p>
+<p><strong>NOTE</strong>: XML allows <em>PI</em>s and <em>comments</em>to
+bepresent before the document root, so <code>doc-&gt;children</code>may
+pointto an element which is not the document Root Element; a
+function<code>xmlDocGetRootElement()</code>was added for this purpose.</p>
<h3><a name="Modifying">Modifying the tree</a></h3>
-<p>Functions are provided for reading and writing the document content. Here
-is an excerpt from the <a href="html/libxml-tree.html">tree API</a>:</p>
+<p>Functions are provided for reading and writing the document content.
+Hereis an excerpt from the <a href="html/libxml-tree.html">tree API</a>:</p>
<dl>
- <dt><code>xmlAttrPtr xmlSetProp(xmlNodePtr node, const xmlChar *name, const
- xmlChar *value);</code></dt>
- <dd><p>This sets (or changes) an attribute carried by an ELEMENT node.
- The value can be NULL.</p>
+ <dt><code>xmlAttrPtr xmlSetProp(xmlNodePtr node, const xmlChar *name,
+ constxmlChar *value);</code></dt>
+ <dd><p>This sets (or changes) an attribute carried by an ELEMENT node.The
+ value can be NULL.</p>
</dd>
</dl>
<dl>
- <dt><code>const xmlChar *xmlGetProp(xmlNodePtr node, const xmlChar
- *name);</code></dt>
- <dd><p>This function returns a pointer to new copy of the property
- content. Note that the user must deallocate the result.</p>
+ <dt><code>const xmlChar *xmlGetProp(xmlNodePtr node, const
+ xmlChar*name);</code></dt>
+ <dd><p>This function returns a pointer to new copy of the
+ propertycontent. Note that the user must deallocate the result.</p>
</dd>
</dl>
-<p>Two functions are provided for reading and writing the text associated
-with elements:</p>
+<p>Two functions are provided for reading and writing the text associatedwith
+elements:</p>
<dl>
- <dt><code>xmlNodePtr xmlStringGetNodeList(xmlDocPtr doc, const xmlChar
- *value);</code></dt>
- <dd><p>This function takes an "external" string and converts it to one
- text node or possibly to a list of entity and text nodes. All
- non-predefined entity references like &amp;Gnome; will be stored
- internally as entity nodes, hence the result of the function may not be
- a single node.</p>
+ <dt><code>xmlNodePtr xmlStringGetNodeList(xmlDocPtr doc, const
+ xmlChar*value);</code></dt>
+ <dd><p>This function takes an "external" string and converts it to
+ onetext node or possibly to a list of entity and text nodes.
+ Allnon-predefined entity references like &amp;Gnome; will be
+ storedinternally as entity nodes, hence the result of the function may
+ not bea single node.</p>
</dd>
</dl>
<dl>
- <dt><code>xmlChar *xmlNodeListGetString(xmlDocPtr doc, xmlNodePtr list, int
- inLine);</code></dt>
- <dd><p>This function is the inverse of
- <code>xmlStringGetNodeList()</code>. It generates a new string
- containing the content of the text and entity nodes. Note the extra
- argument inLine. If this argument is set to 1, the function will expand
- entity references. For example, instead of returning the &amp;Gnome;
- XML encoding in the string, it will substitute it with its value (say,
- "GNU Network Object Model Environment").</p>
+ <dt><code>xmlChar *xmlNodeListGetString(xmlDocPtr doc, xmlNodePtr list,
+ intinLine);</code></dt>
+ <dd><p>This function is the inverse
+ of<code>xmlStringGetNodeList()</code>. It generates a new
+ stringcontaining the content of the text and entity nodes. Note the
+ extraargument inLine. If this argument is set to 1, the function will
+ expandentity references. For example, instead of returning the
+ &amp;Gnome;XML encoding in the string, it will substitute it with its
+ value (say,"GNU Network Object Model Environment").</p>
</dd>
</dl>
@@ -4350,8 +4378,8 @@ with elements:</p>
<p>Basically 3 options are possible:</p>
<dl>
- <dt><code>void xmlDocDumpMemory(xmlDocPtr cur, xmlChar**mem, int
- *size);</code></dt>
+ <dt><code>void xmlDocDumpMemory(xmlDocPtr cur, xmlChar**mem,
+ int*size);</code></dt>
<dd><p>Returns a buffer into which the document has been saved.</p>
</dd>
</dl>
@@ -4362,16 +4390,16 @@ with elements:</p>
</dl>
<dl>
<dt><code>int xmlSaveFile(const char *filename, xmlDocPtr cur);</code></dt>
- <dd><p>Saves the document to a file. In this case, the compression
- interface is triggered if it has been turned on.</p>
+ <dd><p>Saves the document to a file. In this case, the
+ compressioninterface is triggered if it has been turned on.</p>
</dd>
</dl>
<h3><a name="Compressio">Compression</a></h3>
-<p>The library transparently handles compression when doing file-based
-accesses. The level of compression on saves can be turned on either globally
-or individually for one file:</p>
+<p>The library transparently handles compression when doing
+file-basedaccesses. The level of compression on saves can be turned on either
+globallyor individually for one file:</p>
<dl>
<dt><code>int xmlGetDocCompressMode (xmlDocPtr doc);</code></dt>
<dd><p>Gets the document compression ratio (0-9).</p>
@@ -4395,12 +4423,12 @@ or individually for one file:</p>
<h2><a name="Entities">Entities or no entities</a></h2>
-<p>Entities in principle are similar to simple C macros. An entity defines an
-abbreviation for a given string that you can reuse many times throughout the
-content of your document. Entities are especially useful when a given string
-may occur frequently within a document, or to confine the change needed to a
-document to a restricted area in the internal subset of the document (at the
-beginning). Example:</p>
+<p>Entities in principle are similar to simple C macros. An entity defines
+anabbreviation for a given string that you can reuse many times throughout
+thecontent of your document. Entities are especially useful when a given
+stringmay occur frequently within a document, or to confine the change needed
+to adocument to a restricted area in the internal subset of the document (at
+thebeginning). Example:</p>
<pre>1 &lt;?xml version="1.0"?&gt;
2 &lt;!DOCTYPE EXAMPLE SYSTEM "example.dtd" [
3 &lt;!ENTITY xml "Extensible Markup Language"&gt;
@@ -4409,28 +4437,29 @@ beginning). Example:</p>
6 &amp;xml;
7 &lt;/EXAMPLE&gt;</pre>
-<p>Line 3 declares the xml entity. Line 6 uses the xml entity, by prefixing
-its name with '&amp;' and following it by ';' without any spaces added. There
-are 5 predefined entities in libxml2 allowing you to escape characters with
-predefined meaning in some parts of the xml document content:
-<strong>&amp;lt;</strong> for the character '&lt;', <strong>&amp;gt;</strong>
-for the character '&gt;', <strong>&amp;apos;</strong> for the character ''',
-<strong>&amp;quot;</strong> for the character '"', and
-<strong>&amp;amp;</strong> for the character '&amp;'.</p>
-
-<p>One of the problems related to entities is that you may want the parser to
-substitute an entity's content so that you can see the replacement text in
-your application. Or you may prefer to keep entity references as such in the
-content to be able to save the document back without losing this usually
-precious information (if the user went through the pain of explicitly
-defining entities, he may have a a rather negative attitude if you blindly
-substitute them as saving time). The <a
-href="html/libxml-parser.html#xmlSubstituteEntitiesDefault">xmlSubstituteEntitiesDefault()</a>
-function allows you to check and change the behaviour, which is to not
-substitute entities by default.</p>
-
-<p>Here is the DOM tree built by libxml2 for the previous document in the
-default case:</p>
+<p>Line 3 declares the xml entity. Line 6 uses the xml entity, by
+prefixingits name with '&amp;' and following it by ';' without any spaces
+added. Thereare 5 predefined entities in libxml2 allowing you to escape
+characters withpredefined meaning in some parts of the xml document
+content:<strong>&amp;lt;</strong>for the character '&lt;',
+<strong>&amp;gt;</strong>for the character '&gt;',
+<strong>&amp;apos;</strong>for the character
+''',<strong>&amp;quot;</strong>for the character '"',
+and<strong>&amp;amp;</strong>for the character '&amp;'.</p>
+
+<p>One of the problems related to entities is that you may want the parser
+tosubstitute an entity's content so that you can see the replacement text
+inyour application. Or you may prefer to keep entity references as such in
+thecontent to be able to save the document back without losing this
+usuallyprecious information (if the user went through the pain of
+explicitlydefining entities, he may have a a rather negative attitude if you
+blindlysubstitute them as saving time). The <a
+href="html/libxml-parser.html#xmlSubstituteEntitiesDefault">xmlSubstituteEntitiesDefault()</a>function
+allows you to check and change the behaviour, which is to notsubstitute
+entities by default.</p>
+
+<p>Here is the DOM tree built by libxml2 for the previous document in
+thedefault case:</p>
<pre>/gnome/src/gnome-xml -&gt; ./xmllint --debug test/ent1
DOCUMENT
version=1.0
@@ -4451,62 +4480,62 @@ version=1.0
TEXT
content= Extensible Markup Language</pre>
-<p>So, entities or no entities? Basically, it depends on your use case. I
-suggest that you keep the non-substituting default behaviour and avoid using
-entities in your XML document or data if you are not willing to handle the
-entity references elements in the DOM tree.</p>
+<p>So, entities or no entities? Basically, it depends on your use case.
+Isuggest that you keep the non-substituting default behaviour and avoid
+usingentities in your XML document or data if you are not willing to handle
+theentity references elements in the DOM tree.</p>
-<p>Note that at save time libxml2 enforces the conversion of the predefined
-entities where necessary to prevent well-formedness problems, and will also
-transparently replace those with chars (i.e. it will not generate entity
-reference elements in the DOM tree or call the reference() SAX callback when
-finding them in the input).</p>
+<p>Note that at save time libxml2 enforces the conversion of the
+predefinedentities where necessary to prevent well-formedness problems, and
+will alsotransparently replace those with chars (i.e. it will not generate
+entityreference elements in the DOM tree or call the reference() SAX callback
+whenfinding them in the input).</p>
-<p><span style="background-color: #FF0000">WARNING</span>: handling entities
-on top of the libxml2 SAX interface is difficult!!! If you plan to use
-non-predefined entities in your documents, then the learning curve to handle
-then using the SAX API may be long. If you plan to use complex documents, I
-strongly suggest you consider using the DOM interface instead and let libxml
-deal with the complexity rather than trying to do it yourself.</p>
+<p><span style="background-color: #FF0000">WARNING</span>: handling
+entitieson top of the libxml2 SAX interface is difficult!!! If you plan to
+usenon-predefined entities in your documents, then the learning curve to
+handlethen using the SAX API may be long. If you plan to use complex
+documents, Istrongly suggest you consider using the DOM interface instead and
+let libxmldeal with the complexity rather than trying to do it yourself.</p>
<h2><a name="Namespaces">Namespaces</a></h2>
<p>The libxml2 library implements <a
-href="http://www.w3.org/TR/REC-xml-names/">XML namespaces</a> support by
-recognizing namespace constructs in the input, and does namespace lookup
-automatically when building the DOM tree. A namespace declaration is
-associated with an in-memory structure and all elements or attributes within
-that namespace point to it. Hence testing the namespace is a simple and fast
-equality operation at the user level.</p>
-
-<p>I suggest that people using libxml2 use a namespace, and declare it in the
-root element of their document as the default namespace. Then they don't need
-to use the prefix in the content but we will have a basis for future semantic
-refinement and merging of data from different sources. This doesn't increase
-the size of the XML output significantly, but significantly increases its
-value in the long-term. Example:</p>
+href="http://www.w3.org/TR/REC-xml-names/">XML namespaces</a>support
+byrecognizing namespace constructs in the input, and does namespace
+lookupautomatically when building the DOM tree. A namespace declaration
+isassociated with an in-memory structure and all elements or attributes
+withinthat namespace point to it. Hence testing the namespace is a simple and
+fastequality operation at the user level.</p>
+
+<p>I suggest that people using libxml2 use a namespace, and declare it in
+theroot element of their document as the default namespace. Then they don't
+needto use the prefix in the content but we will have a basis for future
+semanticrefinement and merging of data from different sources. This doesn't
+increasethe size of the XML output significantly, but significantly increases
+itsvalue in the long-term. Example:</p>
<pre>&lt;mydoc xmlns="http://mydoc.example.org/schemas/"&gt;
&lt;elem1&gt;...&lt;/elem1&gt;
&lt;elem2&gt;...&lt;/elem2&gt;
&lt;/mydoc&gt;</pre>
-<p>The namespace value has to be an absolute URL, but the URL doesn't have to
-point to any existing resource on the Web. It will bind all the element and
-attributes with that URL. I suggest to use an URL within a domain you
-control, and that the URL should contain some kind of version information if
-possible. For example, <code>"http://www.gnome.org/gnumeric/1.0/"</code> is a
-good namespace scheme.</p>
-
-<p>Then when you load a file, make sure that a namespace carrying the
-version-independent prefix is installed on the root element of your document,
-and if the version information don't match something you know, warn the user
-and be liberal in what you accept as the input. Also do *not* try to base
-namespace checking on the prefix value. &lt;foo:text&gt; may be exactly the
-same as &lt;bar:text&gt; in another document. What really matters is the URI
-associated with the element or the attribute, not the prefix string (which is
-just a shortcut for the full URI). In libxml, element and attributes have an
-<code>ns</code> field pointing to an xmlNs structure detailing the namespace
-prefix and its URI.</p>
+<p>The namespace value has to be an absolute URL, but the URL doesn't have
+topoint to any existing resource on the Web. It will bind all the element
+andattributes with that URL. I suggest to use an URL within a domain
+youcontrol, and that the URL should contain some kind of version information
+ifpossible. For example, <code>"http://www.gnome.org/gnumeric/1.0/"</code>is
+agood namespace scheme.</p>
+
+<p>Then when you load a file, make sure that a namespace carrying
+theversion-independent prefix is installed on the root element of your
+document,and if the version information don't match something you know, warn
+the userand be liberal in what you accept as the input. Also do *not* try to
+basenamespace checking on the prefix value. &lt;foo:text&gt; may be exactly
+thesame as &lt;bar:text&gt; in another document. What really matters is the
+URIassociated with the element or the attribute, not the prefix string (which
+isjust a shortcut for the full URI). In libxml, element and attributes have
+an<code>ns</code>field pointing to an xmlNs structure detailing the
+namespaceprefix and its URI.</p>
<p>@@Interfaces@@</p>
<pre>xmlNodePtr node;
@@ -4516,158 +4545,162 @@ if(!strncmp(node-&gt;name,"mytag",5)
...
}</pre>
-<p>Usually people object to using namespaces together with validity checking.
-I will try to make sure that using namespaces won't break validity checking,
-so even if you plan to use or currently are using validation I strongly
-suggest adding namespaces to your document. A default namespace scheme
-<code>xmlns="http://...."</code> should not break validity even on less
-flexible parsers. Using namespaces to mix and differentiate content coming
-from multiple DTDs will certainly break current validation schemes. To check
-such documents one needs to use schema-validation, which is supported in
-libxml2 as well. See <a href="http://www.relaxng.org/">relagx-ng</a> and <a
+<p>Usually people object to using namespaces together with validity
+checking.I will try to make sure that using namespaces won't break validity
+checking,so even if you plan to use or currently are using validation I
+stronglysuggest adding namespaces to your document. A default namespace
+scheme<code>xmlns="http://...."</code>should not break validity even on
+lessflexible parsers. Using namespaces to mix and differentiate content
+comingfrom multiple DTDs will certainly break current validation schemes. To
+checksuch documents one needs to use schema-validation, which is supported
+inlibxml2 as well. See <a href="http://www.relaxng.org/">relagx-ng</a>and <a
href="http://www.w3c.org/XML/Schema">w3c-schema</a>.</p>
<h2><a name="Upgrading">Upgrading 1.x code</a></h2>
<p>Incompatible changes:</p>
-<p>Version 2 of libxml2 is the first version introducing serious backward
-incompatible changes. The main goals were:</p>
+<p>Version 2 of libxml2 is the first version introducing serious
+backwardincompatible changes. The main goals were:</p>
<ul>
- <li>a general cleanup. A number of mistakes inherited from the very early
- versions couldn't be changed due to compatibility constraints. Example
- the "childs" element in the nodes.</li>
- <li>Uniformization of the various nodes, at least for their header and link
- parts (doc, parent, children, prev, next), the goal is a simpler
- programming model and simplifying the task of the DOM implementors.</li>
- <li>better conformances to the XML specification, for example version 1.x
- had an heuristic to try to detect ignorable white spaces. As a result the
- SAX event generated were ignorableWhitespace() while the spec requires
- character() in that case. This also mean that a number of DOM node
- containing blank text may populate the DOM tree which were not present
- before.</li>
+ <li>a general cleanup. A number of mistakes inherited from the very
+ earlyversions couldn't be changed due to compatibility constraints.
+ Examplethe "childs" element in the nodes.</li>
+ <li>Uniformization of the various nodes, at least for their header and
+ linkparts (doc, parent, children, prev, next), the goal is a
+ simplerprogramming model and simplifying the task of the DOM
+ implementors.</li>
+ <li>better conformances to the XML specification, for example version
+ 1.xhad an heuristic to try to detect ignorable white spaces. As a result
+ theSAX event generated were ignorableWhitespace() while the spec
+ requirescharacter() in that case. This also mean that a number of DOM
+ nodecontaining blank text may populate the DOM tree which were not
+ presentbefore.</li>
</ul>
<h3>How to fix libxml-1.x code:</h3>
-<p>So client code of libxml designed to run with version 1.x may have to be
-changed to compile against version 2.x of libxml. Here is a list of changes
-that I have collected, they may not be sufficient, so in case you find other
-change which are required, <a href="mailto:Daniel.Veillard@w3.org">drop me a
-mail</a>:</p>
+<p>So client code of libxml designed to run with version 1.x may have to
+bechanged to compile against version 2.x of libxml. Here is a list of
+changesthat I have collected, they may not be sufficient, so in case you find
+otherchange which are required, <a href="mailto:Daniel.Veillard@w3.org">drop
+me amail</a>:</p>
<ol>
- <li>The package name have changed from libxml to libxml2, the library name
- is now -lxml2 . There is a new xml2-config script which should be used to
- select the right parameters libxml2</li>
- <li>Node <strong>childs</strong> field has been renamed
- <strong>children</strong> so s/childs/children/g should be applied
- (probability of having "childs" anywhere else is close to 0+</li>
- <li>The document don't have anymore a <strong>root</strong> element it has
- been replaced by <strong>children</strong> and usually you will get a
- list of element here. For example a Dtd element for the internal subset
- and it's declaration may be found in that list, as well as processing
- instructions or comments found before or after the document root element.
- Use <strong>xmlDocGetRootElement(doc)</strong> to get the root element of
- a document. Alternatively if you are sure to not reference DTDs nor have
- PIs or comments before or after the root element
- s/-&gt;root/-&gt;children/g will probably do it.</li>
- <li>The white space issue, this one is more complex, unless special case of
- validating parsing, the line breaks and spaces usually used for indenting
- and formatting the document content becomes significant. So they are
- reported by SAX and if your using the DOM tree, corresponding nodes are
- generated. Too approach can be taken:
+ <li>The package name have changed from libxml to libxml2, the library
+ nameis now -lxml2 . There is a new xml2-config script which should be
+ used toselect the right parameters libxml2</li>
+ <li>Node <strong>childs</strong>field has been
+ renamed<strong>children</strong>so s/childs/children/g should be
+ applied(probability of having "childs" anywhere else is close to 0+</li>
+ <li>The document don't have anymore a <strong>root</strong>element it
+ hasbeen replaced by <strong>children</strong>and usually you will get
+ alist of element here. For example a Dtd element for the internal
+ subsetand it's declaration may be found in that list, as well as
+ processinginstructions or comments found before or after the document
+ root element.Use <strong>xmlDocGetRootElement(doc)</strong>to get the
+ root element ofa document. Alternatively if you are sure to not reference
+ DTDs nor havePIs or comments before or after the root
+ elements/-&gt;root/-&gt;children/g will probably do it.</li>
+ <li>The white space issue, this one is more complex, unless special case
+ ofvalidating parsing, the line breaks and spaces usually used for
+ indentingand formatting the document content becomes significant. So they
+ arereported by SAX and if your using the DOM tree, corresponding nodes
+ aregenerated. Too approach can be taken:
<ol>
- <li>lazy one, use the compatibility call
- <strong>xmlKeepBlanksDefault(0)</strong> but be aware that you are
- relying on a special (and possibly broken) set of heuristics of
- libxml to detect ignorable blanks. Don't complain if it breaks or
- make your application not 100% clean w.r.t. to it's input.</li>
- <li>the Right Way: change you code to accept possibly insignificant
- blanks characters, or have your tree populated with weird blank text
- nodes. You can spot them using the commodity function
- <strong>xmlIsBlankNode(node)</strong> returning 1 for such blank
- nodes.</li>
+ <li>lazy one, use the compatibility
+ call<strong>xmlKeepBlanksDefault(0)</strong>but be aware that you
+ arerelying on a special (and possibly broken) set of heuristics
+ oflibxml to detect ignorable blanks. Don't complain if it breaks
+ ormake your application not 100% clean w.r.t. to it's input.</li>
+ <li>the Right Way: change you code to accept possibly
+ insignificantblanks characters, or have your tree populated with
+ weird blank textnodes. You can spot them using the commodity
+ function<strong>xmlIsBlankNode(node)</strong>returning 1 for such
+ blanknodes.</li>
</ol>
- <p>Note also that with the new default the output functions don't add any
- extra indentation when saving a tree in order to be able to round trip
- (read and save) without inflating the document with extra formatting
- chars.</p>
+ <p>Note also that with the new default the output functions don't add
+ anyextra indentation when saving a tree in order to be able to round
+ trip(read and save) without inflating the document with extra
+ formattingchars.</p>
</li>
- <li>The include path has changed to $prefix/libxml/ and the includes
- themselves uses this new prefix in includes instructions... If you are
- using (as expected) the
+ <li>The include path has changed to $prefix/libxml/ and the
+ includesthemselves uses this new prefix in includes instructions... If
+ you areusing (as expected) the
<pre>xml2-config --cflags</pre>
- <p>output to generate you compile commands this will probably work out of
- the box</p>
+ <p>output to generate you compile commands this will probably work out
+ ofthe box</p>
</li>
- <li>xmlDetectCharEncoding takes an extra argument indicating the length in
- byte of the head of the document available for character detection.</li>
+ <li>xmlDetectCharEncoding takes an extra argument indicating the length
+ inbyte of the head of the document available for character detection.</li>
</ol>
<h3>Ensuring both libxml-1.x and libxml-2.x compatibility</h3>
-<p>Two new version of libxml (1.8.11) and libxml2 (2.3.4) have been released
-to allow smooth upgrade of existing libxml v1code while retaining
-compatibility. They offers the following:</p>
+<p>Two new version of libxml (1.8.11) and libxml2 (2.3.4) have been
+releasedto allow smooth upgrade of existing libxml v1code while
+retainingcompatibility. They offers the following:</p>
<ol>
- <li>similar include naming, one should use
- <strong>#include&lt;libxml/...&gt;</strong> in both cases.</li>
- <li>similar identifiers defined via macros for the child and root fields:
- respectively <strong>xmlChildrenNode</strong> and
- <strong>xmlRootNode</strong></li>
- <li>a new macro <strong>LIBXML_TEST_VERSION</strong> which should be
- inserted once in the client code</li>
+ <li>similar include naming, one should
+ use<strong>#include&lt;libxml/...&gt;</strong>in both cases.</li>
+ <li>similar identifiers defined via macros for the child and root
+ fields:respectively
+ <strong>xmlChildrenNode</strong>and<strong>xmlRootNode</strong></li>
+ <li>a new macro <strong>LIBXML_TEST_VERSION</strong>which should beinserted
+ once in the client code</li>
</ol>
-<p>So the roadmap to upgrade your existing libxml applications is the
-following:</p>
+<p>So the roadmap to upgrade your existing libxml applications is
+thefollowing:</p>
<ol>
<li>install the libxml-1.8.8 (and libxml-devel-1.8.8) packages</li>
- <li>find all occurrences where the xmlDoc <strong>root</strong> field is
- used and change it to <strong>xmlRootNode</strong></li>
- <li>similarly find all occurrences where the xmlNode
- <strong>childs</strong> field is used and change it to
- <strong>xmlChildrenNode</strong></li>
- <li>add a <strong>LIBXML_TEST_VERSION</strong> macro somewhere in your
- <strong>main()</strong> or in the library init entry point</li>
+ <li>find all occurrences where the xmlDoc <strong>root</strong>field isused
+ and change it to <strong>xmlRootNode</strong></li>
+ <li>similarly find all occurrences where the
+ xmlNode<strong>childs</strong>field is used and change it
+ to<strong>xmlChildrenNode</strong></li>
+ <li>add a <strong>LIBXML_TEST_VERSION</strong>macro somewhere in
+ your<strong>main()</strong>or in the library init entry point</li>
<li>Recompile, check compatibility, it should still work</li>
- <li>Change your configure script to look first for xml2-config and fall
- back using xml-config . Use the --cflags and --libs output of the command
- as the Include and Linking parameters needed to use libxml.</li>
- <li>install libxml2-2.3.x and libxml2-devel-2.3.x (libxml-1.8.y and
- libxml-devel-1.8.y can be kept simultaneously)</li>
- <li>remove your config.cache, relaunch your configuration mechanism, and
- recompile, if steps 2 and 3 were done right it should compile as-is</li>
- <li>Test that your application is still running correctly, if not this may
- be due to extra empty nodes due to formating spaces being kept in libxml2
- contrary to libxml1, in that case insert xmlKeepBlanksDefault(1) in your
- code before calling the parser (next to
- <strong>LIBXML_TEST_VERSION</strong> is a fine place).</li>
+ <li>Change your configure script to look first for xml2-config and fallback
+ using xml-config . Use the --cflags and --libs output of the commandas
+ the Include and Linking parameters needed to use libxml.</li>
+ <li>install libxml2-2.3.x and libxml2-devel-2.3.x (libxml-1.8.y
+ andlibxml-devel-1.8.y can be kept simultaneously)</li>
+ <li>remove your config.cache, relaunch your configuration mechanism,
+ andrecompile, if steps 2 and 3 were done right it should compile
+ as-is</li>
+ <li>Test that your application is still running correctly, if not this
+ maybe due to extra empty nodes due to formating spaces being kept in
+ libxml2contrary to libxml1, in that case insert xmlKeepBlanksDefault(1)
+ in yourcode before calling the parser (next
+ to<strong>LIBXML_TEST_VERSION</strong>is a fine place).</li>
</ol>
<p>Following those steps should work. It worked for some of my own code.</p>
-<p>Let me put some emphasis on the fact that there is far more changes from
-libxml 1.x to 2.x than the ones you may have to patch for. The overall code
-has been considerably cleaned up and the conformance to the XML specification
-has been drastically improved too. Don't take those changes as an excuse to
-not upgrade, it may cost a lot on the long term ...</p>
+<p>Let me put some emphasis on the fact that there is far more changes
+fromlibxml 1.x to 2.x than the ones you may have to patch for. The overall
+codehas been considerably cleaned up and the conformance to the XML
+specificationhas been drastically improved too. Don't take those changes as
+an excuse tonot upgrade, it may cost a lot on the long term ...</p>
<h2><a name="Thread">Thread safety</a></h2>
-<p>Starting with 2.4.7, libxml2 makes provisions to ensure that concurrent
-threads can safely work in parallel parsing different documents. There is
-however a couple of things to do to ensure it:</p>
+<p>Starting with 2.4.7, libxml2 makes provisions to ensure that
+concurrentthreads can safely work in parallel parsing different documents.
+There ishowever a couple of things to do to ensure it:</p>
<ul>
<li>configure the library accordingly using the --with-threads options</li>
- <li>call xmlInitParser() in the "main" thread before using any of the
- libxml2 API (except possibly selecting a different memory allocator)</li>
+ <li>call xmlInitParser() in the "main" thread before using any of
+ thelibxml2 API (except possibly selecting a different memory
+ allocator)</li>
</ul>
-<p>Note that the thread safety cannot be ensured for multiple threads sharing
-the same document, the locking must be done at the application level, libxml
-exports a basic mutex and reentrant mutexes API in &lt;libxml/threads.h&gt;.
-The parts of the library checked for thread safety are:</p>
+<p>Note that the thread safety cannot be ensured for multiple threads
+sharingthe same document, the locking must be done at the application level,
+libxmlexports a basic mutex and reentrant mutexes API in
+&lt;libxml/threads.h&gt;.The parts of the library checked for thread safety
+are:</p>
<ul>
<li>concurrent loading</li>
<li>file access resolution</li>
@@ -4679,31 +4712,30 @@ The parts of the library checked for thread safety are:</p>
<li>memory handling</li>
</ul>
-<p>XPath is supposed to be thread safe now, but this wasn't tested
-seriously.</p>
+<p>XPath is supposed to be thread safe now, but this wasn't
+testedseriously.</p>
<h2><a name="DOM"></a><a name="Principles">DOM Principles</a></h2>
-<p><a href="http://www.w3.org/DOM/">DOM</a> stands for the <em>Document
-Object Model</em>; this is an API for accessing XML or HTML structured
-documents. Native support for DOM in Gnome is on the way (module gnome-dom),
-and will be based on gnome-xml. This will be a far cleaner interface to
-manipulate XML files within Gnome since it won't expose the internal
-structure.</p>
+<p><a href="http://www.w3.org/DOM/">DOM</a>stands for the <em>DocumentObject
+Model</em>; this is an API for accessing XML or HTML structureddocuments.
+Native support for DOM in Gnome is on the way (module gnome-dom),and will be
+based on gnome-xml. This will be a far cleaner interface tomanipulate XML
+files within Gnome since it won't expose the internalstructure.</p>
<p>The current DOM implementation on top of libxml2 is the <a
-href="http://cvs.gnome.org/lxr/source/gdome2/">gdome2 Gnome module</a>, this
-is a full DOM interface, thanks to Paolo Casarini, check the <a
-href="http://www.cs.unibo.it/~casarini/gdome2/">Gdome2 homepage</a> for more
-informations.</p>
+href="http://cvs.gnome.org/lxr/source/gdome2/">gdome2 Gnome module</a>,
+thisis a full DOM interface, thanks to Paolo Casarini, check the <a
+href="http://www.cs.unibo.it/~casarini/gdome2/">Gdome2 homepage</a>for
+moreinformations.</p>
<h2><a name="Example"></a><a name="real">A real example</a></h2>
-<p>Here is a real size example, where the actual content of the application
-data is not kept in the DOM tree but uses internal structures. It is based on
-a proposal to keep a database of jobs related to Gnome, with an XML based
-storage structure. Here is an <a href="gjobs.xml">XML encoded jobs
-base</a>:</p>
+<p>Here is a real size example, where the actual content of the
+applicationdata is not kept in the DOM tree but uses internal structures. It
+is based ona proposal to keep a database of jobs related to Gnome, with an
+XML basedstorage structure. Here is an <a href="gjobs.xml">XML encoded
+jobsbase</a>:</p>
<pre>&lt;?xml version="1.0"?&gt;
&lt;gjob:Helping xmlns:gjob="http://www.gnome.org/some-location"&gt;
&lt;gjob:Jobs&gt;
@@ -4761,15 +4793,16 @@ base</a>:</p>
&lt;/gjob:Jobs&gt;
&lt;/gjob:Helping&gt;</pre>
-<p>While loading the XML file into an internal DOM tree is a matter of
-calling only a couple of functions, browsing the tree to gather the data and
-generate the internal structures is harder, and more error prone.</p>
+<p>While loading the XML file into an internal DOM tree is a matter ofcalling
+only a couple of functions, browsing the tree to gather the data andgenerate
+the internal structures is harder, and more error prone.</p>
-<p>The suggested principle is to be tolerant with respect to the input
-structure. For example, the ordering of the attributes is not significant,
-the XML specification is clear about it. It's also usually a good idea not to
-depend on the order of the children of a given node, unless it really makes
-things harder. Here is some code to parse the information for a person:</p>
+<p>The suggested principle is to be tolerant with respect to the
+inputstructure. For example, the ordering of the attributes is not
+significant,the XML specification is clear about it. It's also usually a good
+idea not todepend on the order of the children of a given node, unless it
+really makesthings harder. Here is some code to parse the information for a
+person:</p>
<pre>/*
* A person record
*/
@@ -4815,23 +4848,24 @@ DEBUG("parsePerson\n");
<p>Here are a couple of things to notice:</p>
<ul>
- <li>Usually a recursive parsing style is the more convenient one: XML data
- is by nature subject to repetitive constructs and usually exhibits highly
- structured patterns.</li>
- <li>The two arguments of type <em>xmlDocPtr</em> and <em>xmlNsPtr</em>,
- i.e. the pointer to the global XML document and the namespace reserved to
- the application. Document wide information are needed for example to
- decode entities and it's a good coding practice to define a namespace for
- your application set of data and test that the element and attributes
- you're analyzing actually pertains to your application space. This is
- done by a simple equality test (cur-&gt;ns == ns).</li>
- <li>To retrieve text and attributes value, you can use the function
- <em>xmlNodeListGetString</em> to gather all the text and entity reference
- nodes generated by the DOM output and produce an single text string.</li>
-</ul>
-
-<p>Here is another piece of code used to parse another level of the
-structure:</p>
+ <li>Usually a recursive parsing style is the more convenient one: XML
+ datais by nature subject to repetitive constructs and usually exhibits
+ highlystructured patterns.</li>
+ <li>The two arguments of type <em>xmlDocPtr</em>and <em>xmlNsPtr</em>,i.e.
+ the pointer to the global XML document and the namespace reserved tothe
+ application. Document wide information are needed for example todecode
+ entities and it's a good coding practice to define a namespace foryour
+ application set of data and test that the element and attributesyou're
+ analyzing actually pertains to your application space. This isdone by a
+ simple equality test (cur-&gt;ns == ns).</li>
+ <li>To retrieve text and attributes value, you can use the
+ function<em>xmlNodeListGetString</em>to gather all the text and entity
+ referencenodes generated by the DOM output and produce an single text
+ string.</li>
+</ul>
+
+<p>Here is another piece of code used to parse another level of
+thestructure:</p>
<pre>#include &lt;libxml/tree.h&gt;
/*
* a Description for a Job
@@ -4884,59 +4918,59 @@ DEBUG("parseJob\n");
return(ret);
}</pre>
-<p>Once you are used to it, writing this kind of code is quite simple, but
-boring. Ultimately, it could be possible to write stubbers taking either C
-data structure definitions, a set of XML examples or an XML DTD and produce
-the code needed to import and export the content between C data and XML
-storage. This is left as an exercise to the reader :-)</p>
+<p>Once you are used to it, writing this kind of code is quite simple,
+butboring. Ultimately, it could be possible to write stubbers taking either
+Cdata structure definitions, a set of XML examples or an XML DTD and
+producethe code needed to import and export the content between C data and
+XMLstorage. This is left as an exercise to the reader :-)</p>
-<p>Feel free to use <a href="example/gjobread.c">the code for the full C
-parsing example</a> as a template, it is also available with Makefile in the
-Gnome CVS base under gnome-xml/example</p>
+<p>Feel free to use <a href="example/gjobread.c">the code for the full
+Cparsing example</a>as a template, it is also available with Makefile in
+theGnome CVS base under gnome-xml/example</p>
<h2><a name="Contributi">Contributions</a></h2>
<ul>
- <li>Bjorn Reese, William Brack and Thomas Broyer have provided a number of
- patches, Gary Pennington worked on the validation API, threading support
- and Solaris port.</li>
+ <li>Bjorn Reese, William Brack and Thomas Broyer have provided a number
+ ofpatches, Gary Pennington worked on the validation API, threading
+ supportand Solaris port.</li>
<li>John Fleck helps maintaining the documentation and man pages.</li>
- <li><a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a> is now the
- maintainer of the Windows port, <a
- href="http://www.zlatkovic.com/projects/libxml/index.html">he provides
- binaries</a></li>
- <li><a href="mailto:Gary.Pennington@sun.com">Gary Pennington</a> provides
- <a href="http://garypennington.net/libxml2/">Solaris binaries</a></li>
+ <li><a href="mailto:igor@zlatkovic.com">Igor Zlatkovic</a>is now
+ themaintainer of the Windows port, <a
+ href="http://www.zlatkovic.com/projects/libxml/index.html">he
+ providesbinaries</a></li>
+ <li><a href="mailto:Gary.Pennington@sun.com">Gary Pennington</a>provides<a
+ href="http://garypennington.net/libxml2/">Solaris binaries</a></li>
<li><a
- href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">Matt
- Sergeant</a> developed <a
- href="http://axkit.org/download/">XML::LibXSLT</a>, a Perl wrapper for
- libxml2/libxslt as part of the <a href="http://axkit.com/">AxKit XML
- application server</a></li>
- <li><a href="mailto:fnatter@gmx.net">Felix Natter</a> and <a
- href="mailto:geertk@ai.rug.nl">Geert Kloosterman</a> provide <a
- href="libxml-doc.el">an emacs module</a> to lookup libxml(2) functions
- documentation</li>
- <li><a href="mailto:sherwin@nlm.nih.gov">Ziying Sherwin</a> provided <a
+ href="http://mail.gnome.org/archives/xml/2001-March/msg00014.html">MattSergeant</a>developed
+ <a href="http://axkit.org/download/">XML::LibXSLT</a>, a Perl wrapper
+ forlibxml2/libxslt as part of the <a href="http://axkit.com/">AxKit
+ XMLapplication server</a></li>
+ <li><a href="mailto:fnatter@gmx.net">Felix Natter</a>and <a
+ href="mailto:geertk@ai.rug.nl">Geert Kloosterman</a>provide <a
+ href="libxml-doc.el">an emacs module</a>to lookup libxml(2)
+ functionsdocumentation</li>
+ <li><a href="mailto:sherwin@nlm.nih.gov">Ziying Sherwin</a>provided <a
href="http://xmlsoft.org/messages/0488.html">man pages</a></li>
<li>there is a module for <a
- href="http://acs-misc.sourceforge.net/nsxml.html">libxml/libxslt support
- in OpenNSD/AOLServer</a></li>
- <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a> provided the
- first version of libxml/libxslt <a
+ href="http://acs-misc.sourceforge.net/nsxml.html">libxml/libxslt
+ supportin OpenNSD/AOLServer</a></li>
+ <li><a href="mailto:dkuhlman@cutter.rexx.com">Dave Kuhlman</a>provided
+ thefirst version of libxml/libxslt <a
href="http://www.rexx.com/~dkuhlman">wrappers for Python</a></li>
<li>Petr Kozelka provides <a
- href="http://sourceforge.net/projects/libxml2-pas">Pascal units to glue
- libxml2</a> with Kylix and Delphi and other Pascal compilers</li>
- <li><a href="mailto:aleksey@aleksey.com">Aleksey Sanin</a> implemented the
- <a href="http://www.w3.org/Signature/">XML Canonicalization and XML
- Digital Signature</a> <a
- href="http://www.aleksey.com/xmlsec/">implementations for libxml2</a></li>
- <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a> and
- contributors maintain <a href="http://tclxml.sourceforge.net/">tcl
- bindings for libxml2 and libxslt</a>, as well as <a
- href="http://tclxml.sf.net/tkxmllint.html">tkxmllint</a> a GUI for
- xmllint and <a href="http://tclxml.sf.net/tkxsltproc.html">tkxsltproc</a>
- a GUI for xsltproc.</li>
+ href="http://sourceforge.net/projects/libxml2-pas">Pascal units to
+ gluelibxml2</a>with Kylix and Delphi and other Pascal compilers</li>
+ <li><a href="mailto:aleksey@aleksey.com">Aleksey Sanin</a>implemented the<a
+ href="http://www.w3.org/Signature/">XML Canonicalization and XMLDigital
+ Signature</a><a href="http://www.aleksey.com/xmlsec/">implementations for
+ libxml2</a></li>
+ <li><a href="mailto:Steve.Ball@explain.com.au">Steve
+ Ball</a>andcontributors maintain <a
+ href="http://tclxml.sourceforge.net/">tclbindings for libxml2 and
+ libxslt</a>, as well as <a
+ href="http://tclxml.sf.net/tkxmllint.html">tkxmllint</a>a GUI forxmllint
+ and <a href="http://tclxml.sf.net/tkxsltproc.html">tkxsltproc</a>a GUI
+ for xsltproc.</li>
</ul>
<p></p>
diff --git a/doc/xmldtd.html b/doc/xmldtd.html
index c5541d6b..0e4dbccb 100644
--- a/doc/xmldtd.html
+++ b/doc/xmldtd.html
@@ -17,84 +17,83 @@ A:link, A:visited, A:active { text-decoration: underline }
<li><a href="#Some">Some examples</a></li>
<li><a href="#validate">How to validate</a></li>
<li><a href="#Other">Other resources</a></li>
-</ol><h3><a name="General5" id="General5">General overview</a></h3><p>Well what is validation and what is a DTD ?</p><p>DTD is the acronym for Document Type Definition. This is a description of
-the content for a family of XML files. This is part of the XML 1.0
-specification, and allows one to describe and verify that a given document
-instance conforms to the set of rules detailing its structure and content.</p><p>Validation is the process of checking a document against a DTD (more
-generally against a set of construction rules).</p><p>The validation process and building DTDs are the two most difficult parts
-of the XML life cycle. Briefly a DTD defines all the possible elements to be
-found within your document, what is the formal shape of your document tree
-(by defining the allowed content of an element; either text, a regular
-expression for the allowed list of children, or mixed content i.e. both text
-and children). The DTD also defines the valid attributes for all elements and
-the types of those attributes.</p><h3><a name="definition1" id="definition1">The definition</a></h3><p>The <a href="http://www.w3.org/TR/REC-xml">W3C XML Recommendation</a> (<a href="http://www.xml.com/axml/axml.html">Tim Bray's annotated version of
-Rev1</a>):</p><ul><li><a href="http://www.w3.org/TR/REC-xml#elemdecls">Declaring
- elements</a></li>
- <li><a href="http://www.w3.org/TR/REC-xml#attdecls">Declaring
- attributes</a></li>
-</ul><p>(unfortunately) all this is inherited from the SGML world, the syntax is
-ancient...</p><h3><a name="Simple1" id="Simple1">Simple rules</a></h3><p>Writing DTDs can be done in many ways. The rules to build them if you need
-something permanent or something which can evolve over time can be radically
-different. Really complex DTDs like DocBook ones are flexible but quite
-harder to design. I will just focus on DTDs for a formats with a fixed simple
-structure. It is just a set of basic rules, and definitely not exhaustive nor
-usable for complex DTD design.</p><h4><a name="reference1" id="reference1">How to reference a DTD from a document</a>:</h4><p>Assuming the top element of the document is <code>spec</code> and the dtd
-is placed in the file <code>mydtd</code> in the subdirectory
-<code>dtds</code> of the directory from where the document were loaded:</p><p><code>&lt;!DOCTYPE spec SYSTEM "dtds/mydtd"&gt;</code></p><p>Notes:</p><ul><li>The system string is actually an URI-Reference (as defined in <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>) so you can use a
- full URL string indicating the location of your DTD on the Web. This is a
- really good thing to do if you want others to validate your document.</li>
- <li>It is also possible to associate a <code>PUBLIC</code> identifier (a
- magic string) so that the DTD is looked up in catalogs on the client side
- without having to locate it on the web.</li>
- <li>A DTD contains a set of element and attribute declarations, but they
- don't define what the root of the document should be. This is explicitly
- told to the parser/validator as the first element of the
- <code>DOCTYPE</code> declaration.</li>
-</ul><h4><a name="Declaring2" id="Declaring2">Declaring elements</a>:</h4><p>The following declares an element <code>spec</code>:</p><p><code>&lt;!ELEMENT spec (front, body, back?)&gt;</code></p><p>It also expresses that the spec element contains one <code>front</code>,
-one <code>body</code> and one optional <code>back</code> children elements in
-this order. The declaration of one element of the structure and its content
-are done in a single declaration. Similarly the following declares
-<code>div1</code> elements:</p><p><code>&lt;!ELEMENT div1 (head, (p | list | note)*, div2?)&gt;</code></p><p>which means div1 contains one <code>head</code> then a series of optional
-<code>p</code>, <code>list</code>s and <code>note</code>s and then an
-optional <code>div2</code>. And last but not least an element can contain
-text:</p><p><code>&lt;!ELEMENT b (#PCDATA)&gt;</code></p><p><code>b</code> contains text or being of mixed content (text and elements
-in no particular order):</p><p><code>&lt;!ELEMENT p (#PCDATA|a|ul|b|i|em)*&gt;</code></p><p><code>p </code>can contain text or <code>a</code>, <code>ul</code>,
-<code>b</code>, <code>i </code>or <code>em</code> elements in no particular
-order.</p><h4><a name="Declaring1" id="Declaring1">Declaring attributes</a>:</h4><p>Again the attributes declaration includes their content definition:</p><p><code>&lt;!ATTLIST termdef name CDATA #IMPLIED&gt;</code></p><p>means that the element <code>termdef</code> can have a <code>name</code>
-attribute containing text (<code>CDATA</code>) and which is optional
-(<code>#IMPLIED</code>). The attribute value can also be defined within a
-set:</p><p><code>&lt;!ATTLIST list type (bullets|ordered|glossary)
-"ordered"&gt;</code></p><p>means <code>list</code> element have a <code>type</code> attribute with 3
-allowed values "bullets", "ordered" or "glossary" and which default to
-"ordered" if the attribute is not explicitly specified.</p><p>The content type of an attribute can be text (<code>CDATA</code>),
-anchor/reference/references
-(<code>ID</code>/<code>IDREF</code>/<code>IDREFS</code>), entity(ies)
-(<code>ENTITY</code>/<code>ENTITIES</code>) or name(s)
-(<code>NMTOKEN</code>/<code>NMTOKENS</code>). The following defines that a
-<code>chapter</code> element can have an optional <code>id</code> attribute
-of type <code>ID</code>, usable for reference from attribute of type
-IDREF:</p><p><code>&lt;!ATTLIST chapter id ID #IMPLIED&gt;</code></p><p>The last value of an attribute definition can be <code>#REQUIRED
-</code>meaning that the attribute has to be given, <code>#IMPLIED</code>
-meaning that it is optional, or the default value (possibly prefixed by
-<code>#FIXED</code> if it is the only allowed).</p><p>Notes:</p><ul><li>Usually the attributes pertaining to a given element are declared in a
- single expression, but it is just a convention adopted by a lot of DTD
- writers:
+</ol><h3><a name="General5" id="General5">General overview</a></h3><p>Well what is validation and what is a DTD ?</p><p>DTD is the acronym for Document Type Definition. This is a description
+ofthe content for a family of XML files. This is part of the XML
+1.0specification, and allows one to describe and verify that a given
+documentinstance conforms to the set of rules detailing its structure and
+content.</p><p>Validation is the process of checking a document against a DTD
+(moregenerally against a set of construction rules).</p><p>The validation process and building DTDs are the two most difficult
+partsof the XML life cycle. Briefly a DTD defines all the possible elements
+to befound within your document, what is the formal shape of your document
+tree(by defining the allowed content of an element; either text, a
+regularexpression for the allowed list of children, or mixed content i.e.
+both textand children). The DTD also defines the valid attributes for all
+elements andthe types of those attributes.</p><h3><a name="definition1" id="definition1">The definition</a></h3><p>The <a href="http://www.w3.org/TR/REC-xml">W3C XML Recommendation</a>(<a href="http://www.xml.com/axml/axml.html">Tim Bray's annotated version
+ofRev1</a>):</p><ul><li><a href="http://www.w3.org/TR/REC-xml#elemdecls">Declaringelements</a></li>
+ <li><a href="http://www.w3.org/TR/REC-xml#attdecls">Declaringattributes</a></li>
+</ul><p>(unfortunately) all this is inherited from the SGML world, the syntax
+isancient...</p><h3><a name="Simple1" id="Simple1">Simple rules</a></h3><p>Writing DTDs can be done in many ways. The rules to build them if you
+needsomething permanent or something which can evolve over time can be
+radicallydifferent. Really complex DTDs like DocBook ones are flexible but
+quiteharder to design. I will just focus on DTDs for a formats with a fixed
+simplestructure. It is just a set of basic rules, and definitely not
+exhaustive norusable for complex DTD design.</p><h4><a name="reference1" id="reference1">How to reference a DTD from a document</a>:</h4><p>Assuming the top element of the document is <code>spec</code>and the dtdis
+placed in the file <code>mydtd</code>in the subdirectory<code>dtds</code>of
+the directory from where the document were loaded:</p><p><code>&lt;!DOCTYPE spec SYSTEM "dtds/mydtd"&gt;</code></p><p>Notes:</p><ul><li>The system string is actually an URI-Reference (as defined in <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>) so you can use
+ afull URL string indicating the location of your DTD on the Web. This is
+ areally good thing to do if you want others to validate your
+ document.</li>
+ <li>It is also possible to associate a <code>PUBLIC</code>identifier
+ (amagic string) so that the DTD is looked up in catalogs on the client
+ sidewithout having to locate it on the web.</li>
+ <li>A DTD contains a set of element and attribute declarations, but
+ theydon't define what the root of the document should be. This is
+ explicitlytold to the parser/validator as the first element of
+ the<code>DOCTYPE</code>declaration.</li>
+</ul><h4><a name="Declaring2" id="Declaring2">Declaring elements</a>:</h4><p>The following declares an element <code>spec</code>:</p><p><code>&lt;!ELEMENT spec (front, body, back?)&gt;</code></p><p>It also expresses that the spec element contains one
+<code>front</code>,one <code>body</code>and one optional
+<code>back</code>children elements inthis order. The declaration of one
+element of the structure and its contentare done in a single declaration.
+Similarly the following declares<code>div1</code>elements:</p><p><code>&lt;!ELEMENT div1 (head, (p | list | note)*, div2?)&gt;</code></p><p>which means div1 contains one <code>head</code>then a series of
+optional<code>p</code>, <code>list</code>s and <code>note</code>s and then
+anoptional <code>div2</code>. And last but not least an element can
+containtext:</p><p><code>&lt;!ELEMENT b (#PCDATA)&gt;</code></p><p><code>b</code>contains text or being of mixed content (text and elementsin
+no particular order):</p><p><code>&lt;!ELEMENT p (#PCDATA|a|ul|b|i|em)*&gt;</code></p><p><code>p </code>can contain text or <code>a</code>,
+<code>ul</code>,<code>b</code>, <code>i </code>or <code>em</code>elements in
+no particularorder.</p><h4><a name="Declaring1" id="Declaring1">Declaring attributes</a>:</h4><p>Again the attributes declaration includes their content definition:</p><p><code>&lt;!ATTLIST termdef name CDATA #IMPLIED&gt;</code></p><p>means that the element <code>termdef</code>can have a
+<code>name</code>attribute containing text (<code>CDATA</code>) and which is
+optional(<code>#IMPLIED</code>). The attribute value can also be defined
+within aset:</p><p><code>&lt;!ATTLIST list type
+(bullets|ordered|glossary)"ordered"&gt;</code></p><p>means <code>list</code>element have a <code>type</code>attribute with
+3allowed values "bullets", "ordered" or "glossary" and which default
+to"ordered" if the attribute is not explicitly specified.</p><p>The content type of an attribute can be text
+(<code>CDATA</code>),anchor/reference/references(<code>ID</code>/<code>IDREF</code>/<code>IDREFS</code>),
+entity(ies)(<code>ENTITY</code>/<code>ENTITIES</code>) or
+name(s)(<code>NMTOKEN</code>/<code>NMTOKENS</code>). The following defines
+that a<code>chapter</code>element can have an optional
+<code>id</code>attributeof type <code>ID</code>, usable for reference from
+attribute of typeIDREF:</p><p><code>&lt;!ATTLIST chapter id ID #IMPLIED&gt;</code></p><p>The last value of an attribute definition can be
+<code>#REQUIRED</code>meaning that the attribute has to be given,
+<code>#IMPLIED</code>meaning that it is optional, or the default value
+(possibly prefixed by<code>#FIXED</code>if it is the only allowed).</p><p>Notes:</p><ul><li>Usually the attributes pertaining to a given element are declared in
+ asingle expression, but it is just a convention adopted by a lot of
+ DTDwriters:
<pre>&lt;!ATTLIST termdef
id ID #REQUIRED
name CDATA #IMPLIED&gt;</pre>
- <p>The previous construct defines both <code>id</code> and
- <code>name</code> attributes for the element <code>termdef</code>.</p>
+ <p>The previous construct defines both
+ <code>id</code>and<code>name</code>attributes for the element
+ <code>termdef</code>.</p>
</li>
-</ul><h3><a name="Some1" id="Some1">Some examples</a></h3><p>The directory <code>test/valid/dtds/</code> in the libxml2 distribution
-contains some complex DTD examples. The example in the file
-<code>test/valid/dia.xml</code> shows an XML file where the simple DTD is
-directly included within the document.</p><h3><a name="validate1" id="validate1">How to validate</a></h3><p>The simplest way is to use the xmllint program included with libxml. The
-<code>--valid</code> option turns-on validation of the files given as input.
-For example the following validates a copy of the first revision of the XML
-1.0 specification:</p><p><code>xmllint --valid --noout test/valid/REC-xml-19980210.xml</code></p><p>the -- noout is used to disable output of the resulting tree.</p><p>The <code>--dtdvalid dtd</code> allows validation of the document(s)
-against a given DTD.</p><p>Libxml2 exports an API to handle DTDs and validation, check the <a href="http://xmlsoft.org/html/libxml-valid.html">associated
-description</a>.</p><h3><a name="Other1" id="Other1">Other resources</a></h3><p>DTDs are as old as SGML. So there may be a number of examples on-line, I
-will just list one for now, others pointers welcome:</p><ul><li><a href="http://www.xml101.com:8081/dtd/">XML-101 DTD</a></li>
-</ul><p>I suggest looking at the examples found under test/valid/dtd and any of
-the large number of books available on XML. The dia example in test/valid
-should be both simple and complete enough to allow you to build your own.</p><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
+</ul><h3><a name="Some1" id="Some1">Some examples</a></h3><p>The directory <code>test/valid/dtds/</code>in the libxml2
+distributioncontains some complex DTD examples. The example in the
+file<code>test/valid/dia.xml</code>shows an XML file where the simple DTD
+isdirectly included within the document.</p><h3><a name="validate1" id="validate1">How to validate</a></h3><p>The simplest way is to use the xmllint program included with libxml.
+The<code>--valid</code>option turns-on validation of the files given as
+input.For example the following validates a copy of the first revision of the
+XML1.0 specification:</p><p><code>xmllint --valid --noout test/valid/REC-xml-19980210.xml</code></p><p>the -- noout is used to disable output of the resulting tree.</p><p>The <code>--dtdvalid dtd</code>allows validation of the document(s)against
+a given DTD.</p><p>Libxml2 exports an API to handle DTDs and validation, check the <a href="http://xmlsoft.org/html/libxml-valid.html">associateddescription</a>.</p><h3><a name="Other1" id="Other1">Other resources</a></h3><p>DTDs are as old as SGML. So there may be a number of examples on-line,
+Iwill just list one for now, others pointers welcome:</p><ul><li><a href="http://www.xml101.com:8081/dtd/">XML-101 DTD</a></li>
+</ul><p>I suggest looking at the examples found under test/valid/dtd and any ofthe
+large number of books available on XML. The dia example in test/validshould
+be both simple and complete enough to allow you to build your own.</p><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/doc/xmlio.html b/doc/xmlio.html
index 60188df4..1e3acd4a 100644
--- a/doc/xmlio.html
+++ b/doc/xmlio.html
@@ -13,64 +13,65 @@ A:link, A:visited, A:active { text-decoration: underline }
<li><a href="#Output">Output I/O handlers</a></li>
<li><a href="#entities">The entities loader</a></li>
<li><a href="#Example2">Example of customized I/O</a></li>
-</ol><h3><a name="General1" id="General1">General overview</a></h3><p>The module <code><a href="http://xmlsoft.org/html/libxml-xmlio.html">xmlIO.h</a></code> provides
-the interfaces to the libxml2 I/O system. This consists of 4 main parts:</p><ul><li>Entities loader, this is a routine which tries to fetch the entities
- (files) based on their PUBLIC and SYSTEM identifiers. The default loader
- don't look at the public identifier since libxml2 do not maintain a
- catalog. You can redefine you own entity loader by using
- <code>xmlGetExternalEntityLoader()</code> and
- <code>xmlSetExternalEntityLoader()</code>. <a href="#entities">Check the
- example</a>.</li>
- <li>Input I/O buffers which are a commodity structure used by the parser(s)
- input layer to handle fetching the informations to feed the parser. This
- provides buffering and is also a placeholder where the encoding
- converters to UTF8 are piggy-backed.</li>
- <li>Output I/O buffers are similar to the Input ones and fulfill similar
- task but when generating a serialization from a tree.</li>
- <li>A mechanism to register sets of I/O callbacks and associate them with
- specific naming schemes like the protocol part of the URIs.
- <p>This affect the default I/O operations and allows to use specific I/O
- handlers for certain names.</p>
+</ol><h3><a name="General1" id="General1">General overview</a></h3><p>The module <code><a href="http://xmlsoft.org/html/libxml-xmlio.html">xmlIO.h</a></code>providesthe
+interfaces to the libxml2 I/O system. This consists of 4 main parts:</p><ul><li>Entities loader, this is a routine which tries to fetch the
+ entities(files) based on their PUBLIC and SYSTEM identifiers. The default
+ loaderdon't look at the public identifier since libxml2 do not maintain
+ acatalog. You can redefine you own entity loader by
+ using<code>xmlGetExternalEntityLoader()</code>and<code>xmlSetExternalEntityLoader()</code>.
+ <a href="#entities">Check theexample</a>.</li>
+ <li>Input I/O buffers which are a commodity structure used by the
+ parser(s)input layer to handle fetching the informations to feed the
+ parser. Thisprovides buffering and is also a placeholder where the
+ encodingconverters to UTF8 are piggy-backed.</li>
+ <li>Output I/O buffers are similar to the Input ones and fulfill
+ similartask but when generating a serialization from a tree.</li>
+ <li>A mechanism to register sets of I/O callbacks and associate them
+ withspecific naming schemes like the protocol part of the URIs.
+ <p>This affect the default I/O operations and allows to use specific
+ I/Ohandlers for certain names.</p>
</li>
-</ul><p>The general mechanism used when loading http://rpmfind.net/xml.html for
-example in the HTML parser is the following:</p><ol><li>The default entity loader calls <code>xmlNewInputFromFile()</code> with
- the parsing context and the URI string.</li>
- <li>the URI string is checked against the existing registered handlers
- using their match() callback function, if the HTTP module was compiled
- in, it is registered and its match() function will succeeds</li>
- <li>the open() function of the handler is called and if successful will
- return an I/O Input buffer</li>
- <li>the parser will the start reading from this buffer and progressively
- fetch information from the resource, calling the read() function of the
- handler until the resource is exhausted</li>
- <li>if an encoding change is detected it will be installed on the input
- buffer, providing buffering and efficient use of the conversion
- routines</li>
- <li>once the parser has finished, the close() function of the handler is
- called once and the Input buffer and associated resources are
- deallocated.</li>
-</ol><p>The user defined callbacks are checked first to allow overriding of the
-default libxml2 I/O routines.</p><h3><a name="basic" id="basic">The basic buffer type</a></h3><p>All the buffer manipulation handling is done using the
-<code>xmlBuffer</code> type define in <code><a href="http://xmlsoft.org/html/libxml-tree.html">tree.h</a> </code>which is a
-resizable memory buffer. The buffer allocation strategy can be selected to be
-either best-fit or use an exponential doubling one (CPU vs. memory use
-trade-off). The values are <code>XML_BUFFER_ALLOC_EXACT</code> and
-<code>XML_BUFFER_ALLOC_DOUBLEIT</code>, and can be set individually or on a
-system wide basis using <code>xmlBufferSetAllocationScheme()</code>. A number
-of functions allows to manipulate buffers with names starting with the
-<code>xmlBuffer...</code> prefix.</p><h3><a name="Input" id="Input">Input I/O handlers</a></h3><p>An Input I/O handler is a simple structure
-<code>xmlParserInputBuffer</code> containing a context associated to the
-resource (file descriptor, or pointer to a protocol handler), the read() and
-close() callbacks to use and an xmlBuffer. And extra xmlBuffer and a charset
-encoding handler are also present to support charset conversion when
-needed.</p><h3><a name="Output" id="Output">Output I/O handlers</a></h3><p>An Output handler <code>xmlOutputBuffer</code> is completely similar to an
-Input one except the callbacks are write() and close().</p><h3><a name="entities" id="entities">The entities loader</a></h3><p>The entity loader resolves requests for new entities and create inputs for
-the parser. Creating an input from a filename or an URI string is done
-through the xmlNewInputFromFile() routine. The default entity loader do not
-handle the PUBLIC identifier associated with an entity (if any). So it just
-calls xmlNewInputFromFile() with the SYSTEM identifier (which is mandatory in
-XML).</p><p>If you want to hook up a catalog mechanism then you simply need to
-override the default entity loader, here is an example:</p><pre>#include &lt;libxml/xmlIO.h&gt;
+</ul><p>The general mechanism used when loading http://rpmfind.net/xml.html
+forexample in the HTML parser is the following:</p><ol><li>The default entity loader calls
+ <code>xmlNewInputFromFile()</code>withthe parsing context and the URI
+ string.</li>
+ <li>the URI string is checked against the existing registered handlersusing
+ their match() callback function, if the HTTP module was compiledin, it is
+ registered and its match() function will succeeds</li>
+ <li>the open() function of the handler is called and if successful
+ willreturn an I/O Input buffer</li>
+ <li>the parser will the start reading from this buffer and
+ progressivelyfetch information from the resource, calling the read()
+ function of thehandler until the resource is exhausted</li>
+ <li>if an encoding change is detected it will be installed on the
+ inputbuffer, providing buffering and efficient use of the
+ conversionroutines</li>
+ <li>once the parser has finished, the close() function of the handler
+ iscalled once and the Input buffer and associated resources
+ aredeallocated.</li>
+</ol><p>The user defined callbacks are checked first to allow overriding of
+thedefault libxml2 I/O routines.</p><h3><a name="basic" id="basic">The basic buffer type</a></h3><p>All the buffer manipulation handling is done using
+the<code>xmlBuffer</code>type define in <code><a href="http://xmlsoft.org/html/libxml-tree.html">tree.h</a></code>which is
+aresizable memory buffer. The buffer allocation strategy can be selected to
+beeither best-fit or use an exponential doubling one (CPU vs. memory
+usetrade-off). The values are
+<code>XML_BUFFER_ALLOC_EXACT</code>and<code>XML_BUFFER_ALLOC_DOUBLEIT</code>,
+and can be set individually or on asystem wide basis using
+<code>xmlBufferSetAllocationScheme()</code>. A numberof functions allows to
+manipulate buffers with names starting with
+the<code>xmlBuffer...</code>prefix.</p><h3><a name="Input" id="Input">Input I/O handlers</a></h3><p>An Input I/O handler is a simple
+structure<code>xmlParserInputBuffer</code>containing a context associated to
+theresource (file descriptor, or pointer to a protocol handler), the read()
+andclose() callbacks to use and an xmlBuffer. And extra xmlBuffer and a
+charsetencoding handler are also present to support charset conversion
+whenneeded.</p><h3><a name="Output" id="Output">Output I/O handlers</a></h3><p>An Output handler <code>xmlOutputBuffer</code>is completely similar to
+anInput one except the callbacks are write() and close().</p><h3><a name="entities" id="entities">The entities loader</a></h3><p>The entity loader resolves requests for new entities and create inputs
+forthe parser. Creating an input from a filename or an URI string is
+donethrough the xmlNewInputFromFile() routine. The default entity loader do
+nothandle the PUBLIC identifier associated with an entity (if any). So it
+justcalls xmlNewInputFromFile() with the SYSTEM identifier (which is
+mandatory inXML).</p><p>If you want to hook up a catalog mechanism then you simply need tooverride
+the default entity loader, here is an example:</p><pre>#include &lt;libxml/xmlIO.h&gt;
xmlExternalEntityLoader defaultLoader = NULL;
@@ -99,11 +100,11 @@ int main(..) {
xmlSetExternalEntityLoader(xmlMyExternalEntityLoader);
...
-}</pre><h3><a name="Example2" id="Example2">Example of customized I/O</a></h3><p>This example come from <a href="http://xmlsoft.org/messages/0708.html">a
-real use case</a>, xmlDocDump() closes the FILE * passed by the application
-and this was a problem. The <a href="http://xmlsoft.org/messages/0711.html">solution</a> was to redefine a
-new output handler with the closing call deactivated:</p><ol><li>First define a new I/O output allocator where the output don't close
- the file:
+}</pre><h3><a name="Example2" id="Example2">Example of customized I/O</a></h3><p>This example come from <a href="http://xmlsoft.org/messages/0708.html">areal use case</a>,
+xmlDocDump() closes the FILE * passed by the applicationand this was a
+problem. The <a href="http://xmlsoft.org/messages/0711.html">solution</a>was
+to redefine anew output handler with the closing call deactivated:</p><ol><li>First define a new I/O output allocator where the output don't closethe
+ file:
<pre>xmlOutputBufferPtr
xmlOutputBufferCreateOwn(FILE *file, xmlCharEncodingHandlerPtr encoder) {
    xmlOutputBufferPtr ret;
diff --git a/doc/xmlmem.html b/doc/xmlmem.html
index 58c29875..547a7edf 100644
--- a/doc/xmlmem.html
+++ b/doc/xmlmem.html
@@ -12,91 +12,92 @@ A:link, A:visited, A:active { text-decoration: underline }
<li><a href="#cleanup">Cleaning up after parsing</a></li>
<li><a href="#Debugging">Debugging routines</a></li>
<li><a href="#General4">General memory requirements</a></li>
-</ol><h3><a name="General3" id="General3">General overview</a></h3><p>The module <code><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlmemory.h</a></code>
-provides the interfaces to the libxml2 memory system:</p><ul><li>libxml2 does not use the libc memory allocator directly but xmlFree(),
- xmlMalloc() and xmlRealloc()</li>
- <li>those routines can be reallocated to a specific set of routine, by
- default the libc ones i.e. free(), malloc() and realloc()</li>
+</ol><h3><a name="General3" id="General3">General overview</a></h3><p>The module <code><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlmemory.h</a></code>provides
+the interfaces to the libxml2 memory system:</p><ul><li>libxml2 does not use the libc memory allocator directly but
+ xmlFree(),xmlMalloc() and xmlRealloc()</li>
+ <li>those routines can be reallocated to a specific set of routine,
+ bydefault the libc ones i.e. free(), malloc() and realloc()</li>
<li>the xmlmemory.c module includes a set of debugging routine</li>
-</ul><h3><a name="setting" id="setting">Setting libxml2 set of memory routines</a></h3><p>It is sometimes useful to not use the default memory allocator, either for
-debugging, analysis or to implement a specific behaviour on memory management
-(like on embedded systems). Two function calls are available to do so:</p><ul><li><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemGet
- ()</a> which return the current set of functions in use by the parser</li>
- <li><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemSetup()</a>
- which allow to set up a new set of memory allocation functions</li>
-</ul><p>Of course a call to xmlMemSetup() should probably be done before calling
-any other libxml2 routines (unless you are sure your allocations routines are
-compatibles).</p><h3><a name="cleanup" id="cleanup">Cleaning up after parsing</a></h3><p>Libxml2 is not stateless, there is a few set of memory structures needing
-allocation before the parser is fully functional (some encoding structures
-for example). This also mean that once parsing is finished there is a tiny
-amount of memory (a few hundred bytes) which can be recollected if you don't
-reuse the parser immediately:</p><ul><li><a href="http://xmlsoft.org/html/libxml-parser.html">xmlCleanupParser
- ()</a> is a centralized routine to free the parsing states. Note that it
- won't deallocate any produced tree if any (use the xmlFreeDoc() and
- related routines for this).</li>
- <li><a href="http://xmlsoft.org/html/libxml-parser.html">xmlInitParser
- ()</a> is the dual routine allowing to preallocate the parsing state
- which can be useful for example to avoid initialization reentrancy
- problems when using libxml2 in multithreaded applications</li>
-</ul><p>Generally xmlCleanupParser() is safe, if needed the state will be rebuild
-at the next invocation of parser routines, but be careful of the consequences
-in multithreaded applications.</p><h3><a name="Debugging" id="Debugging">Debugging routines</a></h3><p>When configured using --with-mem-debug flag (off by default), libxml2 uses
-a set of memory allocation debugging routines keeping track of all allocated
-blocks and the location in the code where the routine was called. A couple of
-other debugging routines allow to dump the memory allocated infos to a file
-or call a specific routine when a given block number is allocated:</p><ul><li><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMallocLoc()</a>
- <a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlReallocLoc()</a>
- and <a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemStrdupLoc()</a>
- are the memory debugging replacement allocation routines</li>
- <li><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemoryDump
- ()</a> dumps all the informations about the allocated memory block lefts
- in the <code>.memdump</code> file</li>
-</ul><p>When developing libxml2 memory debug is enabled, the tests programs call
-xmlMemoryDump () and the "make test" regression tests will check for any
-memory leak during the full regression test sequence, this helps a lot
-ensuring that libxml2 does not leak memory and bullet proof memory
-allocations use (some libc implementations are known to be far too permissive
-resulting in major portability problems!).</p><p>If the .memdump reports a leak, it displays the allocation function and
-also tries to give some informations about the content and structure of the
-allocated blocks left. This is sufficient in most cases to find the culprit,
-but not always. Assuming the allocation problem is reproducible, it is
-possible to find more easily:</p><ol><li>write down the block number xxxx not allocated</li>
- <li>export the environment variable XML_MEM_BREAKPOINT=xxxx , the easiest
- when using GDB is to simply give the command
+</ul><h3><a name="setting" id="setting">Setting libxml2 set of memory routines</a></h3><p>It is sometimes useful to not use the default memory allocator, either
+fordebugging, analysis or to implement a specific behaviour on memory
+management(like on embedded systems). Two function calls are available to do
+so:</p><ul><li><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemGet()</a>which
+ return the current set of functions in use by the parser</li>
+ <li><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemSetup()</a>which
+ allow to set up a new set of memory allocation functions</li>
+</ul><p>Of course a call to xmlMemSetup() should probably be done before
+callingany other libxml2 routines (unless you are sure your allocations
+routines arecompatibles).</p><h3><a name="cleanup" id="cleanup">Cleaning up after parsing</a></h3><p>Libxml2 is not stateless, there is a few set of memory structures
+needingallocation before the parser is fully functional (some encoding
+structuresfor example). This also mean that once parsing is finished there is
+a tinyamount of memory (a few hundred bytes) which can be recollected if you
+don'treuse the parser immediately:</p><ul><li><a href="http://xmlsoft.org/html/libxml-parser.html">xmlCleanupParser()</a>is
+ a centralized routine to free the parsing states. Note that itwon't
+ deallocate any produced tree if any (use the xmlFreeDoc() andrelated
+ routines for this).</li>
+ <li><a href="http://xmlsoft.org/html/libxml-parser.html">xmlInitParser()</a>is
+ the dual routine allowing to preallocate the parsing statewhich can be
+ useful for example to avoid initialization reentrancyproblems when using
+ libxml2 in multithreaded applications</li>
+</ul><p>Generally xmlCleanupParser() is safe, if needed the state will be
+rebuildat the next invocation of parser routines, but be careful of the
+consequencesin multithreaded applications.</p><h3><a name="Debugging" id="Debugging">Debugging routines</a></h3><p>When configured using --with-mem-debug flag (off by default), libxml2
+usesa set of memory allocation debugging routines keeping track of all
+allocatedblocks and the location in the code where the routine was called. A
+couple ofother debugging routines allow to dump the memory allocated infos to
+a fileor call a specific routine when a given block number is allocated:</p><ul><li><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMallocLoc()</a><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlReallocLoc()</a>and
+ <a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemStrdupLoc()</a>are
+ the memory debugging replacement allocation routines</li>
+ <li><a href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemoryDump()</a>dumps
+ all the informations about the allocated memory block leftsin the
+ <code>.memdump</code>file</li>
+</ul><p>When developing libxml2 memory debug is enabled, the tests programs
+callxmlMemoryDump () and the "make test" regression tests will check for
+anymemory leak during the full regression test sequence, this helps a
+lotensuring that libxml2 does not leak memory and bullet proof
+memoryallocations use (some libc implementations are known to be far too
+permissiveresulting in major portability problems!).</p><p>If the .memdump reports a leak, it displays the allocation function
+andalso tries to give some informations about the content and structure of
+theallocated blocks left. This is sufficient in most cases to find the
+culprit,but not always. Assuming the allocation problem is reproducible, it
+ispossible to find more easily:</p><ol><li>write down the block number xxxx not allocated</li>
+ <li>export the environment variable XML_MEM_BREAKPOINT=xxxx , the
+ easiestwhen using GDB is to simply give the command
<p><code>set environment XML_MEM_BREAKPOINT xxxx</code></p>
<p>before running the program.</p>
</li>
- <li>run the program under a debugger and set a breakpoint on
- xmlMallocBreakpoint() a specific function called when this precise block
- is allocated</li>
- <li>when the breakpoint is reached you can then do a fine analysis of the
- allocation an step to see the condition resulting in the missing
- deallocation.</li>
-</ol><p>I used to use a commercial tool to debug libxml2 memory problems but after
-noticing that it was not detecting memory leaks that simple mechanism was
-used and proved extremely efficient until now. Lately I have also used <a href="http://developer.kde.org/~sewardj/">valgrind</a> with quite some
-success, it is tied to the i386 architecture since it works by emulating the
-processor and instruction set, it is slow but extremely efficient, i.e. it
-spot memory usage errors in a very precise way.</p><h3><a name="General4" id="General4">General memory requirements</a></h3><p>How much libxml2 memory require ? It's hard to tell in average it depends
-of a number of things:</p><ul><li>the parser itself should work in a fixed amount of memory, except for
- information maintained about the stacks of names and entities locations.
- The I/O and encoding handlers will probably account for a few KBytes.
- This is true for both the XML and HTML parser (though the HTML parser
- need more state).</li>
- <li>If you are generating the DOM tree then memory requirements will grow
- nearly linear with the size of the data. In general for a balanced
- textual document the internal memory requirement is about 4 times the
- size of the UTF8 serialization of this document (example the XML-1.0
- recommendation is a bit more of 150KBytes and takes 650KBytes of main
- memory when parsed). Validation will add a amount of memory required for
- maintaining the external Dtd state which should be linear with the
- complexity of the content model defined by the Dtd</li>
- <li>If you need to work with fixed memory requirements or don't need the
- full DOM tree then using the <a href="xmlreader.html">xmlReader
- interface</a> is probably the best way to proceed, it still allows to
- validate or operate on subset of the tree if needed.</li>
- <li>If you don't care about the advanced features of libxml2 like
- validation, DOM, XPath or XPointer, don't use entities, need to work with
- fixed memory requirements, and try to get the fastest parsing possible
- then the SAX interface should be used, but it has known restrictions.</li>
+ <li>run the program under a debugger and set a breakpoint
+ onxmlMallocBreakpoint() a specific function called when this precise
+ blockis allocated</li>
+ <li>when the breakpoint is reached you can then do a fine analysis of
+ theallocation an step to see the condition resulting in the
+ missingdeallocation.</li>
+</ol><p>I used to use a commercial tool to debug libxml2 memory problems but
+afternoticing that it was not detecting memory leaks that simple mechanism
+wasused and proved extremely efficient until now. Lately I have also used <a href="http://developer.kde.org/~sewardj/">valgrind</a>with quite somesuccess,
+it is tied to the i386 architecture since it works by emulating theprocessor
+and instruction set, it is slow but extremely efficient, i.e. itspot memory
+usage errors in a very precise way.</p><h3><a name="General4" id="General4">General memory requirements</a></h3><p>How much libxml2 memory require ? It's hard to tell in average it
+dependsof a number of things:</p><ul><li>the parser itself should work in a fixed amount of memory, except
+ forinformation maintained about the stacks of names and entities
+ locations.The I/O and encoding handlers will probably account for a few
+ KBytes.This is true for both the XML and HTML parser (though the HTML
+ parserneed more state).</li>
+ <li>If you are generating the DOM tree then memory requirements will
+ grownearly linear with the size of the data. In general for a
+ balancedtextual document the internal memory requirement is about 4 times
+ thesize of the UTF8 serialization of this document (example the
+ XML-1.0recommendation is a bit more of 150KBytes and takes 650KBytes of
+ mainmemory when parsed). Validation will add a amount of memory required
+ formaintaining the external Dtd state which should be linear with
+ thecomplexity of the content model defined by the Dtd</li>
+ <li>If you need to work with fixed memory requirements or don't need
+ thefull DOM tree then using the <a href="xmlreader.html">xmlReaderinterface</a>is probably the best way to
+ proceed, it still allows tovalidate or operate on subset of the tree if
+ needed.</li>
+ <li>If you don't care about the advanced features of libxml2
+ likevalidation, DOM, XPath or XPointer, don't use entities, need to work
+ withfixed memory requirements, and try to get the fastest parsing
+ possiblethen the SAX interface should be used, but it has known
+ restrictions.</li>
</ul><p></p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
diff --git a/libxml.spec.in b/libxml.spec.in
index 3898aa20..2345f3a7 100644
--- a/libxml.spec.in
+++ b/libxml.spec.in
@@ -27,6 +27,7 @@ Summary: Libraries, includes, etc. to develop XML and HTML applications
Group: Development/Libraries
Requires: libxml2 = %{version}
Requires: zlib-devel
+Requires: pkgconfig
%description devel
Libraries, include files, etc you can use to develop XML applications.
diff --git a/python/libxml2class.txt b/python/libxml2class.txt
index aea9732b..20eb5c48 100644
--- a/python/libxml2class.txt
+++ b/python/libxml2class.txt
@@ -990,6 +990,7 @@ Class xpathContext()
registerXPathFunction()
# functions from module xpath
+ xpathContextSetCache()
xpathEval()
xpathEvalExpression()
xpathFreeContext()
diff --git a/testapi.c b/testapi.c
index c7b074f5..4629bc26 100644
--- a/testapi.c
+++ b/testapi.c
@@ -45559,6 +45559,61 @@ test_xmlXPathCompiledEval(void) {
static int
+test_xmlXPathContextSetCache(void) {
+ int test_ret = 0;
+
+#if defined(LIBXML_XPATH_ENABLED)
+ int mem_base;
+ int ret_val;
+ xmlXPathContextPtr ctxt; /* the XPath context */
+ int n_ctxt;
+ int active; /* enables/disables (creates/frees) the cache */
+ int n_active;
+ int value; /* a value with semantics dependant on @options */
+ int n_value;
+ int options; /* options (currently only the value 0 is used) */
+ int n_options;
+
+ for (n_ctxt = 0;n_ctxt < gen_nb_xmlXPathContextPtr;n_ctxt++) {
+ for (n_active = 0;n_active < gen_nb_int;n_active++) {
+ for (n_value = 0;n_value < gen_nb_int;n_value++) {
+ for (n_options = 0;n_options < gen_nb_int;n_options++) {
+ mem_base = xmlMemBlocks();
+ ctxt = gen_xmlXPathContextPtr(n_ctxt, 0);
+ active = gen_int(n_active, 1);
+ value = gen_int(n_value, 2);
+ options = gen_int(n_options, 3);
+
+ ret_val = xmlXPathContextSetCache(ctxt, active, value, options);
+ desret_int(ret_val);
+ call_tests++;
+ des_xmlXPathContextPtr(n_ctxt, ctxt, 0);
+ des_int(n_active, active, 1);
+ des_int(n_value, value, 2);
+ des_int(n_options, options, 3);
+ xmlResetLastError();
+ if (mem_base != xmlMemBlocks()) {
+ printf("Leak of %d blocks found in xmlXPathContextSetCache",
+ xmlMemBlocks() - mem_base);
+ test_ret++;
+ printf(" %d", n_ctxt);
+ printf(" %d", n_active);
+ printf(" %d", n_value);
+ printf(" %d", n_options);
+ printf("\n");
+ }
+ }
+ }
+ }
+ }
+ function_tests++;
+#endif
+
+ return(test_ret);
+}
+
+
+static int
test_xmlXPathConvertBoolean(void) {
int test_ret = 0;
@@ -46004,7 +46059,7 @@ static int
test_xpath(void) {
int test_ret = 0;
- if (quiet == 0) printf("Testing xpath : 28 of 36 functions ...\n");
+ if (quiet == 0) printf("Testing xpath : 29 of 37 functions ...\n");
test_ret += test_xmlXPathCastBooleanToNumber();
test_ret += test_xmlXPathCastBooleanToString();
test_ret += test_xmlXPathCastNodeSetToBoolean();
@@ -46022,6 +46077,7 @@ test_xpath(void) {
test_ret += test_xmlXPathCmpNodes();
test_ret += test_xmlXPathCompile();
test_ret += test_xmlXPathCompiledEval();
+ test_ret += test_xmlXPathContextSetCache();
test_ret += test_xmlXPathConvertBoolean();
test_ret += test_xmlXPathConvertNumber();
test_ret += test_xmlXPathConvertString();