From a7e9d3f37d5e9fba4b9acaa43e7c12b6d9a669ae Mon Sep 17 00:00:00 2001 From: Mike Hommey Date: Thu, 8 Jun 2006 10:59:26 +0200 Subject: Load /tmp/libxml2-2.6.26 into libxml2/branches/upstream/current. --- ChangeLog | 241 ++ configure | 10 +- configure.in | 10 +- doc/APIchunk1.html | 2 + doc/APIchunk10.html | 1 + doc/APIchunk12.html | 7 +- doc/APIchunk13.html | 2 + doc/APIchunk14.html | 2 + doc/APIchunk15.html | 2 + doc/APIchunk17.html | 1 + doc/APIchunk19.html | 2 + doc/APIchunk21.html | 5 +- doc/APIchunk22.html | 1 + doc/APIchunk23.html | 2 + doc/APIchunk24.html | 5 + doc/APIchunk28.html | 1 + doc/APIchunk5.html | 1 + doc/APIchunk8.html | 2 + doc/APIfiles.html | 2 + doc/APIfunctions.html | 1 + doc/APIsymbols.html | 2 + doc/DOM.html | 16 +- doc/FAQ.html | 333 ++- doc/XMLinfo.html | 33 +- doc/XSLT.html | 9 +- doc/architecture.html | 7 +- doc/bugs.html | 118 +- doc/catalog.html | 324 ++- doc/contribs.html | 53 +- doc/devhelp/libxml2-xmlerror.html | 1 + doc/devhelp/libxml2-xpath.html | 8 +- doc/devhelp/libxml2.devhelp | 2 + doc/docs.html | 35 +- doc/downloads.html | 42 +- doc/encoding.html | 312 +-- doc/entities.html | 74 +- doc/example.html | 70 +- doc/help.html | 26 +- doc/html/libxml-xmlerror.html | 1 + doc/html/libxml-xpath.html | 8 +- doc/index.html | 109 +- doc/interface.html | 35 +- doc/intro.html | 40 +- doc/library.html | 137 +- doc/libxml2-api.xml | 15 +- doc/libxml2.xsa | 49 +- doc/namespaces.html | 70 +- doc/news.html | 1688 +++++++------ doc/python.html | 247 +- doc/threads.html | 23 +- doc/tree.html | 32 +- doc/upgrade.html | 188 +- doc/xml.html | 5011 +++++++++++++++++++------------------ doc/xmldtd.html | 154 +- doc/xmlio.html | 123 +- doc/xmlmem.html | 166 +- encoding.c | 3 +- include/libxml/xmlerror.h | 1 + include/libxml/xmlversion.h | 10 +- include/libxml/xpath.h | 13 +- libxml.h | 7 + libxml.spec.in | 51 +- libxml2.spec | 57 +- pattern.c | 210 +- python/libxml2-py.c | 21 + python/setup.py | 2 +- relaxng.c | 2 +- runsuite.c | 11 +- testapi.c | 58 +- tree.c | 7 - triodef.h | 4 +- xinclude.c | 2 +- xmlIO.c | 7 +- xmlschemas.c | 97 +- xpath.c | 3580 ++++++++++++++++++++++---- 75 files changed, 8538 insertions(+), 5466 deletions(-) diff --git a/ChangeLog b/ChangeLog index 7ef389d..f6b31ef 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,244 @@ +Tue Jun 6 17:50:43 CEST 2006 Daniel Veillard + + * configure.ini NEWS doc//* libxml.spec.in : preparing release of 2.6.26 + +Tue Jun 6 17:25:23 CEST 2006 Kasimier Buchcik + + * xpath.c: Fixed self-invented a segfault in xmlXPathCtxtCompile(), + when the expression was not valid and @comp was NULL and I + tried to do the d-o-s rewrite. + +Tue Jun 6 15:19:57 CEST 2006 Daniel Veillard + + * configure.ini NEWS doc//* libxml.spec.in : preparing release of 2.6.25 + +Tue Jun 6 11:28:15 CEST 2006 Kasimier Buchcik + + * xpath.c: Enabled the compound traversal again; I added a + check to use this only if the have an expression starting + with the document node; so in the case of "//foo", we + already know at compilation-time, that there will be only + 1 initial context node. Added the rewrite also to + xmlXPathEvalExpr(). + +Tue Jun 6 10:23:10 CEST 2006 Daniel Veillard + + * xinclude.c: fix bug #343968, include='text' can't lead to a + recursion. + +Fri Jun 2 22:47:08 CEST 2006 Kasimier Buchcik + + * xpath.c: Disabled the compound traversal for the release; + I need first to assure that this is done only if we have + 1 initial node. + +Wed May 31 13:53:41 PST 2006 Aleksey Sanin + + * xpath.c: fixed memory leak in xpath error reporting + +Wed May 31 15:30:16 CEST 2006 Daniel Veillard + + * libxml.h triodef.h: applied patch from Olli Savia for LynxOS + +Wed May 31 14:33:00 CEST 2006 Kasimier Buchcik + + * xpath.c include/libxml/xpath.h runsuite.c: + Changed the name of the recently added public function + xmlXPathContextSetObjectCache() to + xmlXPathContextSetCache(); so a more generic one, in + case we decide to cache more things than only XPath + objects. + +Tue May 30 21:36:16 CEST 2006 Kasimier Buchcik + + * xpath.c: Optimized xmlXPathNodeCollectAndTest() and + xmlXPathNodeCollectAndTestNth() to evaluate a compound + traversal of 2 axes when we have a "//foo" expression. + This is done with a rewrite of the XPath AST in + xmlXPathRewriteDOSExpression(); I added an additional field + to xmlXPathStepOp for this (but the field's name should be + changed). The mechanism: the embracing descendant-or-self + axis traversal (also optimized to return only nodes which + can hold elements), will produce context nodes for the + inner traversal of the child axis. This way we avoid a full + node-collecting traversal of the descendant-or-self axis. + Some tests indicate that this can reduce execution time of + "//foo" to 50%. Together with the XPath object cache this + all significantly speeds up libxslt. + +Tue May 30 11:38:47 CEST 2006 Kasimier Buchcik + + * xmlschemas.c: A warning will now be reported in the value of + the XSD attribute 'schemaLocation' does not consist of tuples + (namespace-name, document-URI). A warning will be reported + if a schema document could not be found at the specified + location (via 'schemaLocation' or + 'noNamespaceSchemaLocation'). + * include/libxml/xmlerror.h: Added XML_SCHEMAV_MISC to + xmlParserErrors. + +Tue May 30 11:21:34 CEST 2006 Kasimier Buchcik + + * xpath.c: Enhanced xmlXPathNodeCollectAndTest() to avoid + recreation (if possible) of the node-set which is used to + collect the nodes in the current axis for the currect context + node. Especially for "//foo" this will decrease dramatically + the number of created node-sets, since for each node in the + result node-set of the evaluation of descendant-or-self::node() + a new temporary node-set was created. Added node iterator + xmlXPathNextChildElement() as a tiny optimization for + child::foo. + +Mon May 29 18:06:17 CEST 2006 Kasimier Buchcik + + * xpath.c include/libxml/xpath.h: Added an XPath object cache. + It sits on an xmlXPathContext and need to be explicitely + activated (or deactivated again) with + xmlXPathContextSetObjectCache(). The cache consists of 5 + lists for node-set, string, number, boolean and misc XPath + objects. Internally the xpath.c module will use object- + deposition and -acquisition functions which will try to reuse + as many XPath objects as possible, and fallback to normal + free/create behaviour if no cache is available or if the cache + is full. + * runsuite.c: Adjusted to deactivate the cache for XML Schema + tests if a cache-creation is turned on by default for the whole + library, e.g. for testing purposes of the cache. It is + deactivated here in order to avoid confusion of the memory leak + detection in runsuite.c. + +Wed May 24 10:54:25 CEST 2006 Kasimier Buchcik + + * xpath.c: Removed a memcpy if xmlXPathNodeSetMerge(); it + seems we really need to walk the whole list, since those + nastly namespace nodes need to be added with + xmlXPathNodeSetDupNs(); thus a pure memcpy is not possible. + A flag on the node-set indicating if namespace nodes are in + the set would help here; this is the 3rd flag which would + be usefull with node-sets. The current flags I have in mind: + 1) Is a node-set already sorted? + This would allow for rebust and optimizable sorting + behaviour. + 2) Of what type are the nodes in the set (or of mixed type)? + This would allow for faster merging of node-sets. + 3) Are namespace nodes in the set? + This would allow to skipp all the namespace node specific + special handling. Faster node-set merging if the first + set is empty; just memcpy the set. + +Mon May 22 17:14:00 CEST 2006 Kasimier Buchcik + + * xpath.c: Optimization of count(): eliminated sorting + (see bug #165547). Optimization of XPATH_OP_FILTER if the + predicate is a [1] (disable with XP_OPTIMIZED_FILTER_FIRST if + it produces trouble). Tiny opt in xmlXPathNodeSetMerge(). + +Mon May 22 13:33:12 CEST 2006 Rob Richards + + * tree.c: Revert behavior change in xmlSetProp to handle attributes + with colons in name and no namespace. + +Fri May 19 21:56:43 CEST 2006 Kasimier Buchcik + + * xpath.c: Substituted all remaining calls to xmlXPathCmpNodes() + for xmlXPathCmpNodesExt(). Tiny further enhancement of + xmlXPathCmpNodesExt(). Added additional checks in various code + parts to avoid calling sorting or merging functions if the + node-set(s) don't need them; i.e., if they are empty or contain + just one node. + +Fri May 19 13:16:58 CEST 2006 Kasimier Buchcik + + * xpath.c: Optimized the comparison for non-element nodes + in xmlXPathCmpNodesExt(); the comparison is used for sorting + of node-sets. This enhancement is related to bug #165547. + There are other places where the old comparison function + xmlXPathCmpNodes() is still called, but I currently don't + know exactly what those calls are for; thus if they can be + substituted (if it makes sense) for the new function. + +Tue May 16 16:55:13 CEST 2006 Kasimier Buchcik + + * xpath.c: Applied patch from Rob Richards, fixing a potential + memory leak in xmlXPathTryStreamCompile(), when a list of + namespaces was assigned to the XPath compilation context; + here a new namespace list was created and passed to + xmlPatterncompile(); but this list was not freed afterwards. + Additionally we avoid now in xmlXPathTryStreamCompile() to + compile the expression, if it has a colon - indicating + prefixed name tests - and no namespace list was given. The + streaming XPath mechanism needs a namespace list at + compilation time (unlike normal XPath, where we can bind + namespace names to prefixes at execution time). + * pattern.c: Enhanced to use a string dict for local-names, + ns-prefixes and and namespace-names. + Fixed xmlStreamPushInternal() not to use string-pointer + comparison if a dict is available; this won't work, since + one does not know it the given strings originate from the + same dict - and they normally don't do, since e.g. + namespaces are hold on xmlNs->href. I think this would be + worth an investigation: if we can add a @doc field to xmlNs + and put the @href in to a additionan namespace dict hold + in xmlDoc. Daniel will surely not like this idea :-) But + evaluation of tons of elements/attributes in namespaces + with xmlStrEqual() isn't the way we should go forever. + +Thu May 11 18:03:49 CEST 2006 Kasimier Buchcik + + * xmlschemas.c: Fixed bug #341337, reported by David Grohmann. + The code expected a node (xmlNodePtr) on the info for a + non-existent default attribute, which clearly cannot be + expected, since the attribute does not exist. I can only + guess that this sneaked trying to eliminate the query + for the owner-element, which is unavoidable actually. + Note that creation of default attributes won't have an + effect if validating via SAX/XMLReader; i.e., the processor + won't fire additional start-attribute events (I'm not even + sure if Libxml2 has such a SAX-event; I think it hands them + all over in the start-element event). + +Tue May 9 21:47:58 CEST 2006 Kasimier Buchcik + + * xmlschemas.c: Fixed bug #341150, reported by Michael Romer. + In xmlSchemaBuildContentModelForSubstGroup(), + xmlAutomataNewOnceTrans2() was incorrectly used instead of + xmlAutomataNewTransition2() to mimic a xs:choice for + substitution-groups. + * test/schemas/subst-group-1_1.xsd + test/schemas/subst-group-1_0.xml + result/schemas/subst-group-1_0_1 + result/schemas/subst-group-1_0_1.err: Added regression test + supplied by Michael Romer for bug #341150. + +Sat May 6 11:05:24 HKT 2006 William M. Brack + + * relaxng.c: Fixed compilation error with patch supplied by + Graham Bennett. + +Thu May 4 19:14:03 CEST 2006 Kasimier Buchcik + + * xmlschemas.c: We'll raise an internal error and stop + validation now when an entity is found in the instance + document, since we don't support automatic entity + substitution by the schema processor (yet?) - + see bug #340316, reported by Nick Wellnhofer. + +Wed May 3 15:16:00 CEST 2006 Daniel Veillard + + * configure.in: applied another Python detection patch from Joseph Sacco + * libxml.spec.in: cleanup the changelog section, asciifies the spec file + too + +Tue May 2 22:34:54 CEST 2006 Daniel Veillard + + * xmlIO.c: fix a mix of code and declarations showing up on Windows + patch from Kjartan Maraas, fixing #340404 + +Tue May 2 14:24:40 CEST 2006 Daniel Veillard + + * encoding.c: fixing bug #340398 xmlCharEncOutFunc writing to + input buffer + Fri Apr 28 18:29:22 CEST 2006 Daniel Veillard * NEWS configure.in doc//*: preparing 2.6.24 release, fixed Python diff --git a/configure b/configure index f0dc765..5bf44bb 100755 --- a/configure +++ b/configure @@ -1618,7 +1618,7 @@ host_os=`echo $ac_cv_host | sed 's/^\([^-]*\)-\([^-]*\)-\(.*\)$/\3/'` LIBXML_MAJOR_VERSION=2 LIBXML_MINOR_VERSION=6 -LIBXML_MICRO_VERSION=24 +LIBXML_MICRO_VERSION=26 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 @@ -26935,17 +26935,17 @@ fi -d $with_python/lib/python$PYTHON_VERSION/site-packages then PYTHON_INCLUDES=$with_python/include/python$PYTHON_VERSION - PYTHON_SITE_PACKAGES='$(libdir)/lib/python$(PYTHON_VERSION)/site-packages' + PYTHON_SITE_PACKAGES=$libdir/python$PYTHON_VERSION/site-packages else if test -r $prefix/include/python$PYTHON_VERSION/Python.h then PYTHON_INCLUDES=$prefix/include/python$PYTHON_VERSION - PYTHON_SITE_PACKAGES='$(libdir)/python$(PYTHON_VERSION)/site-packages' + PYTHON_SITE_PACKAGES=$libdir/python$PYTHON_VERSION/site-packages else if test -r /usr/include/python$PYTHON_VERSION/Python.h then PYTHON_INCLUDES=/usr/include/python$PYTHON_VERSION - PYTHON_SITE_PACKAGES='$(libdir)/python$(PYTHON_VERSION)/site-packages' + PYTHON_SITE_PACKAGES=$libdir/python$PYTHON_VERSION/site-packages else echo could not find python$PYTHON_VERSION/Python.h fi @@ -26958,7 +26958,7 @@ fi fi if test "$with_python" != "" then - pythondir=$(PYTHON_SITE_PACKAGES) + pythondir='$(PYTHON_SITE_PACKAGES)' else pythondir='$(libdir)/python$(PYTHON_VERSION)/site-packages' fi diff --git a/configure.in b/configure.in index 6951b3d..e01408a 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=26 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 @@ -678,17 +678,17 @@ if test "$with_python" != "no" ; then -d $with_python/lib/python$PYTHON_VERSION/site-packages then PYTHON_INCLUDES=$with_python/include/python$PYTHON_VERSION - PYTHON_SITE_PACKAGES='$(libdir)/lib/python$(PYTHON_VERSION)/site-packages' + PYTHON_SITE_PACKAGES=$libdir/python$PYTHON_VERSION/site-packages else if test -r $prefix/include/python$PYTHON_VERSION/Python.h then PYTHON_INCLUDES=$prefix/include/python$PYTHON_VERSION - PYTHON_SITE_PACKAGES='$(libdir)/python$(PYTHON_VERSION)/site-packages' + PYTHON_SITE_PACKAGES=$libdir/python$PYTHON_VERSION/site-packages else if test -r /usr/include/python$PYTHON_VERSION/Python.h then PYTHON_INCLUDES=/usr/include/python$PYTHON_VERSION - PYTHON_SITE_PACKAGES='$(libdir)/python$(PYTHON_VERSION)/site-packages' + PYTHON_SITE_PACKAGES=$libdir/python$PYTHON_VERSION/site-packages else echo could not find python$PYTHON_VERSION/Python.h fi @@ -701,7 +701,7 @@ if test "$with_python" != "no" ; then fi if test "$with_python" != "" then - pythondir=$(PYTHON_SITE_PACKAGES) + pythondir='$(PYTHON_SITE_PACKAGES)' else pythondir='$(libdir)/python$(PYTHON_VERSION)/site-packages' fi diff --git a/doc/APIchunk1.html b/doc/APIchunk1.html index ca14e32..7c9ff72 100644 --- a/doc/APIchunk1.html +++ b/doc/APIchunk1.html @@ -81,6 +81,7 @@ A:link, A:visited, A:active { text-decoration: underline }
CJKUnifiedIdeographsExtensionB
xmlUCSIsCJKUnifiedIdeographsExtensionB
CVS
LIBXML_VERSION_EXTRA
CWD
xmlNanoFTPCwd
+
Cache
_xmlXPathContext
Call
htmlInitAutoClose
xmlInitParser
xmlXPathOrderDocElems
@@ -309,6 +310,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlExpNewCtxt
xmlNewDoc
xmlXIncludeNewContext
+xmlXPathContextSetCache
Creation
xmlNewCDataBlock
xmlNewCharRef
xmlNewChild
diff --git a/doc/APIchunk10.html b/doc/APIchunk10.html index c2e8d33..0486624 100644 --- a/doc/APIchunk10.html +++ b/doc/APIchunk10.html @@ -123,6 +123,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlTextReaderSchemaValidate
xmlTextReaderSchemaValidateCtxt
xmlTextReaderSetSchema
+
activates
xmlXPathContextSetCache
activation
xmlGetLineNo
acts
xmlGetProp
actual
xmlGetUTF8Char
diff --git a/doc/APIchunk12.html b/doc/APIchunk12.html index 8f93a9f..1c552b1 100644 --- a/doc/APIchunk12.html +++ b/doc/APIchunk12.html @@ -37,7 +37,10 @@ A:link, A:visited, A:active { text-decoration: underline } w-w x-x y-z -

Letter c:

calculated
xmlStrncatNew
+

Letter c:

cache
xmlXPathContextSetCache
+
cached
xmlXPathContextSetCache
+
caching:
xmlXPathContextSetCache
+
calculated
xmlStrncatNew
calculates
xmlUTF8Size
calling
_xmlXPathContext
xmlBuildRelativeURI
@@ -839,6 +842,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlAutomataNewTransition2
xmlCreateURI
xmlStrncatNew
+xmlXPathContextSetCache
creating
xmlDOMWrapAdoptNode
xmlDOMWrapCloneNode
xmlDOMWrapReconcileNamespaces
@@ -869,6 +873,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlMemGet
xmlMemUsed
xmlOutputBufferCreateFilename
+xmlXPathContextSetCache
custom
xmlDOMWrapAdoptNode
xmlDOMWrapCloneNode
xmlSaveSetAttrEscape
diff --git a/doc/APIchunk13.html b/doc/APIchunk13.html index 96643e3..5980cc2 100644 --- a/doc/APIchunk13.html +++ b/doc/APIchunk13.html @@ -221,6 +221,7 @@ A:link, A:visited, A:active { text-decoration: underline }
delegation
xmlCatalogSetDefaultPrefer
delete
xmlNanoFTPDele
deletion
xmlCatalogSetDefaultPrefer
+
dependant
xmlXPathContextSetCache
depending
xmlIsID
xmlIsRef
xmlListDataCompare
@@ -455,6 +456,7 @@ A:link, A:visited, A:active { text-decoration: underline }
disabled
XML_CAST_FPTR
_xmlParserCtxt
xmlParseURIRaw
+
disables
xmlXPathContextSetCache
disabling
xmlNoNetExternalEntityLoader
disallowed
XML_SCHEMAS_ELEM_BLOCK_EXTENSION
XML_SCHEMAS_ELEM_BLOCK_RESTRICTION
diff --git a/doc/APIchunk14.html b/doc/APIchunk14.html index eb1716e..f5134af 100644 --- a/doc/APIchunk14.html +++ b/doc/APIchunk14.html @@ -50,6 +50,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlXPathIdFunction
xmlXPathSubstringFunction
edition
xmlCheckLanguageID
+
effect
xmlXPathContextSetCache
effective
xmlLoadCatalog
xmlLoadCatalogs
efficiency
xmlBuildRelativeURI
@@ -118,6 +119,7 @@ A:link, A:visited, A:active { text-decoration: underline }
enable
xmlCatalogSetDebug
enabled
xmlSaveFile
xmlSaveFormatFile
+
enables
xmlXPathContextSetCache
enabling
xmlLineNumbersDefault
xmlPedanticParserDefault
enc
xmlParserInputBufferCreateFilename
diff --git a/doc/APIchunk15.html b/doc/APIchunk15.html index 8b51338..4ac0a55 100644 --- a/doc/APIchunk15.html +++ b/doc/APIchunk15.html @@ -243,6 +243,7 @@ A:link, A:visited, A:active { text-decoration: underline }
fonctionnalities
xmlInputMatchCallback
xmlOutputMatchCallback
for:
xmlSchemaGetCanonValue
+xmlXPathContextSetCache
forbid
XML_XPATH_NOVAR
force
xmlKeepBlanksDefault
xmlSetGenericErrorFunc
@@ -320,6 +321,7 @@ A:link, A:visited, A:active { text-decoration: underline }
freeing
xmlCanonicPath
xmlParserInputDeallocate
frees
xmlBufferFree
+xmlXPathContextSetCache
front
xmlValidateNCName
xmlValidateNMToken
xmlValidateName
diff --git a/doc/APIchunk17.html b/doc/APIchunk17.html index 892cf52..071403e 100644 --- a/doc/APIchunk17.html +++ b/doc/APIchunk17.html @@ -464,6 +464,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlRelaxNGNewDocParserCtxt
xmlRemoveID
xmlRemoveRef
+xmlXPathContextSetCache
interned
xmlPatterncompile
xmlTextReaderConstString
interning
xmlCopyNodeList
diff --git a/doc/APIchunk19.html b/doc/APIchunk19.html index 0cde864..8541fe1 100644 --- a/doc/APIchunk19.html +++ b/doc/APIchunk19.html @@ -148,6 +148,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlExpMaxToken
xmlExpNewCtxt
xmlPatternMaxDepth
+xmlXPathContextSetCache
maybe
_xmlSchemaElement
mean
xmlPatternMinDepth
means
xmlExpNewRange
@@ -238,6 +239,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlPatternMinDepth
minus
xmlXPathStringFunction
minute
ftpListCallback
+
misc
xmlXPathContextSetCache
misleading
xmlParsePEReference
xmlParserHandlePEReference
mixed
XML_SCHEMAS_TYPE_MIXED
diff --git a/doc/APIchunk21.html b/doc/APIchunk21.html index 8817d3c..f503ffe 100644 --- a/doc/APIchunk21.html +++ b/doc/APIchunk21.html @@ -39,7 +39,9 @@ A:link, A:visited, A:active { text-decoration: underline } y-z

Letter o:

object?
xmlXPathNumberFunction
xmlXPathStringFunction
-
objects
xmlXPathCompareValues
+
objects
_xmlXPathContext
+xmlXPathCompareValues
+xmlXPathContextSetCache
xmlXPathDivValues
xmlXPathEqualValues
xmlXPathFreeNodeSetList
@@ -236,6 +238,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSaveToFilename
xmlSaveToIO
xmlTextReaderSchemaValidateCtxt
+xmlXPathContextSetCache
ordered
xmlListAppend
xmlListInsert
xmlXPathNextAncestor
diff --git a/doc/APIchunk22.html b/doc/APIchunk22.html index dec8350..f4c8321 100644 --- a/doc/APIchunk22.html +++ b/doc/APIchunk22.html @@ -146,6 +146,7 @@ A:link, A:visited, A:active { text-decoration: underline }
per
xmlGetLastError
xmlParseAttributeType
xmlValidateElementDecl
+xmlXPathContextSetCache
performance
xmlGetBufferAllocationScheme
xmlSetBufferAllocationScheme
performed
htmlNodeStatus
diff --git a/doc/APIchunk23.html b/doc/APIchunk23.html index ebbea9a..4a78224 100644 --- a/doc/APIchunk23.html +++ b/doc/APIchunk23.html @@ -541,9 +541,11 @@ A:link, A:visited, A:active { text-decoration: underline } xmlHashUpdateEntry3
retry
xmlValidGetValidElements
returning
xmlXPathStringFunction
+
reusal
_xmlXPathContext
reuse
xmlReconciliateNs
xmlRegExecPushString
xmlRegExecPushString2
+
reused
xmlXPathContextSetCache
reuses
htmlCtxtReadDoc
htmlCtxtReadFd
htmlCtxtReadFile
diff --git a/doc/APIchunk24.html b/doc/APIchunk24.html index fa596f6..6ac493b 100644 --- a/doc/APIchunk24.html +++ b/doc/APIchunk24.html @@ -180,6 +180,7 @@ A:link, A:visited, A:active { text-decoration: underline }
self
xmlXPathNextSelf
semantic
xmlAutomataNewNegTrans
xmlXPathNodeSetFreeNs
+
semantics
xmlXPathContextSetCache
sense
xmlCreateEntitiesTable
separated
xmlLoadCatalogs
separately
xmlSetGenericErrorFunc
@@ -261,6 +262,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlXPathDifference
xmlXPathIntersection
setting
xmlSetGenericErrorFunc
+xmlXPathContextSetCache
setups
xmlParseEncodingDecl
sgmlsource
getSystemId
xmlSAX2GetSystemId
@@ -388,6 +390,8 @@ A:link, A:visited, A:active { text-decoration: underline }
skipped
xmlParseElementChildrenContentDecl
xmlParseElementMixedContentDecl
xmlSkipBlankChars
+
slot
xmlXPathContextSetCache
+
slots
xmlXPathContextSetCache
smallest
xmlXPathCeilingFunction
socket
xmlCheckFilename
xmlNanoFTPGetSocket
@@ -797,6 +801,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlHashUpdateEntry3
xmlSchemaValueAppend
xmlXPathCompareValues
+xmlXPathContextSetCache
succeeds
xmlCheckFilename
xmlNewTextWriterPushParser
successful
xmlACatalogAdd
diff --git a/doc/APIchunk28.html b/doc/APIchunk28.html index 34ddc87..b5471fb 100644 --- a/doc/APIchunk28.html +++ b/doc/APIchunk28.html @@ -457,6 +457,7 @@ A:link, A:visited, A:active { text-decoration: underline }
xmlXPathFunction
xmlXPathFunctionLookup
xmlXPathFunctionLookupNS
xmlXPathNodeTrailingSorted
xmlXPathNodeTrailing
+
xmlXPathObject
xmlXPathContextSetCache
xmlXPathObjectPtr
xmlXPathCompiledEval
xmlXPathEval
xmlXPathEvalExpression
diff --git a/doc/APIchunk5.html b/doc/APIchunk5.html index dbc12b1..3ebc5a8 100644 --- a/doc/APIchunk5.html +++ b/doc/APIchunk5.html @@ -71,6 +71,7 @@ A:link, A:visited, A:active { text-decoration: underline }
Optional
_htmlElemDesc
Oriya
xmlUCSIsOriya
Osmanya
xmlUCSIsOsmanya
+
Other
xmlXPathContextSetCache
Otherwise
xmlStreamPush
xmlStreamPushAttr
Output
xmlOutputCloseCallback
diff --git a/doc/APIchunk8.html b/doc/APIchunk8.html index 87c07a4..82de64b 100644 --- a/doc/APIchunk8.html +++ b/doc/APIchunk8.html @@ -114,6 +114,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlParseMarkupDecl
Then
xmlValidateOneElement
There
xmlExpParse
+xmlXPathContextSetCache
Those
_xmlParserCtxt
Thus:
xmlXPathSubstringFunction
Tibetan
xmlUCSIsTibetan
@@ -249,6 +250,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlTextReaderSchemaValidate
xmlTextReaderSchemaValidateCtxt
xmlTextReaderSetSchema
+xmlXPathContextSetCache
Used
XML_SCHEMAS_ANY_LAX
XML_SCHEMAS_ANY_STRICT
XML_SCHEMAS_ATTR_USE_PROHIBITED
diff --git a/doc/APIfiles.html b/doc/APIfiles.html index 2de70cc..2a5af4b 100644 --- a/doc/APIfiles.html +++ b/doc/APIfiles.html @@ -2457,6 +2457,7 @@ A:link, A:visited, A:active { text-decoration: underline } XML_SCHEMAV_INVALIDATTR
XML_SCHEMAV_INVALIDELEM
XML_SCHEMAV_ISABSTRACT
+XML_SCHEMAV_MISC
XML_SCHEMAV_MISSING
XML_SCHEMAV_NOROLLBACK
XML_SCHEMAV_NOROOT
@@ -3274,6 +3275,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlXPathCompiledEval
xmlXPathContext
xmlXPathContextPtr
+xmlXPathContextSetCache
xmlXPathConvertBoolean
xmlXPathConvertFunc
xmlXPathConvertNumber
diff --git a/doc/APIfunctions.html b/doc/APIfunctions.html index 042bc3a..92489fb 100644 --- a/doc/APIfunctions.html +++ b/doc/APIfunctions.html @@ -2164,6 +2164,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlXPathDebugDumpCompExpr
xmlXPathFreeCompExpr

Type xmlXPathContextPtr:

xmlXPathCompiledEval
+xmlXPathContextSetCache
xmlXPathCtxtCompile
xmlXPathEval
xmlXPathEvalExpression
diff --git a/doc/APIsymbols.html b/doc/APIsymbols.html index cc7019a..7e1ba3c 100644 --- a/doc/APIsymbols.html +++ b/doc/APIsymbols.html @@ -1199,6 +1199,7 @@ A:link, A:visited, A:active { text-decoration: underline } XML_SCHEMAV_INVALIDATTR
XML_SCHEMAV_INVALIDELEM
XML_SCHEMAV_ISABSTRACT
+XML_SCHEMAV_MISC
XML_SCHEMAV_MISSING
XML_SCHEMAV_NOROLLBACK
XML_SCHEMAV_NOROOT
@@ -3292,6 +3293,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlXPathContainsFunction
xmlXPathContext
xmlXPathContextPtr
+xmlXPathContextSetCache
xmlXPathConvertBoolean
xmlXPathConvertFunc
xmlXPathConvertNumber
diff --git a/doc/DOM.html b/doc/DOM.html index 52f1139..a637399 100644 --- a/doc/DOM.html +++ b/doc/DOM.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 } -DOM Principles
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

The XML C parser and toolkit of Gnome

DOM Principles

Developer Menu
API Indexes
Related links

DOM stands for the Document -Object Model; 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.

The current DOM implementation on top of libxml2 is the gdome2 Gnome module, this -is a full DOM interface, thanks to Paolo Casarini, check the Gdome2 homepage for more -informations.

Daniel Veillard

+DOM Principles
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

The XML C parser and toolkit of Gnome

DOM Principles

Developer Menu
API Indexes
Related links

DOMstands for the +DocumentObjectModel; 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 bebased on gnome-xml. This will be a far cleaner +interface tomanipulate XMLfiles within Gnome since it won't expose the +internalstructure.

The current DOM implementation on top of libxml2 is the gdome2 Gnome module,thisis +a full DOM interface, thanks to Paolo Casarini, check the Gdome2 +homepageformoreinformations.

Daniel Veillard

diff --git a/doc/FAQ.html b/doc/FAQ.html index 0d5ded6..cdc6585 100644 --- a/doc/FAQ.html +++ b/doc/FAQ.html @@ -12,53 +12,49 @@ A:link, A:visited, A:active { text-decoration: underline }

  • Compilation
  • Developer corner

    • License(s)

    1. Licensing Terms for libxml -

      libxml2 is released under the MIT - License; see the file Copyright in the distribution for the precise - wording

      +

      libxml2 is released under the MITLicense;see + the file Copyright in the distribution for the precisewording

    2. Can I embed libxml2 in a proprietary application ? -

      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.

      +

      Yes. The MIT License allows you to keep proprietary the changesyoumade + to libxml, but it would be graceful to send-back bug fixesandimprovements + as patches for possible incorporation in themaindevelopment tree.

      3. -

    Installation

    1. Do Not Use - libxml1, use libxml2
      2. -
    2. Where can I get libxml ? -

      The original distribution comes from xmlsoft.org or gnome.org

      -

      Most Linux and BSD distributions include libxml, this is probably the - safer way for end-users to use libxml.

      +

    Installation

    1. Do + NotUselibxml1, use libxml2
      2. +
    2. Where can I get libxml? +

      The original distribution comes from xmlsoft.orgor gnome.org

      +

      Most Linux and BSD distributions include libxml, this is + probablythesafer way for end-users to use libxml.

      David Doolin provides precompiled Windows versions at http://www.ce.berkeley.edu/~doolin/code/libxmlwin32/

    3. I see libxml and libxml2 releases, which one should I install ? -
      • If you are not constrained by backward compatibility issues with - existing applications, install libxml2 only
        • -
      • If you are not doing development, you can safely install both. - Usually the packages libxml and libxml2 are - compatible (this is not the case for development packages).
        • -
      • 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 libxml-devel - and libxml2-devel - too for libxml2 >= 2.3.0
        • -
      • If you are developing a new application, please develop against - libxml2(-devel)
        • +
        • If you are not constrained by backward compatibility + issueswithexisting applications, install libxml2 only
          • +
        • If you are not doing development, you can safely + installboth.Usually the packages libxmland libxml2arecompatible(this + is not the case for development packages).
          • +
        • If you are a developer and your system provides + separatepackagingfor shared libraries and the development components, + it ispossibleto install libxml and libxml2, and also libxml-develandlibxml2-develtoofor + libxml2 >= 2.3.0
          • +
        • If you are developing a new application, please + developagainstlibxml2(-devel)
      • I can't install the libxml package, it conflicts with libxml0 -

        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 xmlsoft.org provide - libxml.so.0

        +

        You probably have an old libxml0 package used to provide + thesharedlibrary for libxml.so.0, you can probably safely remove it. + Thelibxmlpackages provided on xmlsoft.orgprovidelibxml.so.0

        • -
      • I can't install the libxml(2) RPM package due to failed - dependencies -

        The most generic solution is to re-fetch the latest src.rpm , and - rebuild it locally with

        +
      • I can't install the libxml(2) RPM package due + tofaileddependencies +

        The most generic solution is to re-fetch the latest src.rpm + ,andrebuild it locally with

        rpm --rebuild libxml(2)-xxx.src.rpm.

        -

        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.

        +

        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 + tobuildapplications with libxml(2)) that you can install locally.

    Compilation

    1. What is the process to compile libxml2 ?

      As most UNIX libraries libxml2 follows the "standard":

      @@ -69,109 +65,106 @@ A:link, A:visited, A:active { text-decoration: underline }

      ./configure [possible options]

      make

      make install

      -

      At that point you may have to rerun ldconfig or a similar utility to - update your list of installed shared libs.

      +

      At that point you may have to rerun ldconfig or a similar + utilitytoupdate your list of installed shared libs.

    2. What other libraries are needed to compile/install libxml2 ? -

      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).

      -

      However if found at configuration time libxml2 will detect and use the - following libs:

      -
      • libz : a - highly portable and available widely compression library.
        • -
      • 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 part - of the official UNIX specification. Here is one implementation of the - library which source can be found here.
        • +

        Libxml2 does not require any other library, the normal C ANSIAPIshould + be sufficient (please report any violation to this rule youmayfind).

        +

        However if found at configuration time libxml2 will detect and + usethefollowing libs:

        +
        • libz:ahighly + portable and available widely compression library.
          • +
        • iconv: a powerful character encoding conversion library. + Itisincluded by default in recent glibc libraries, so it doesn't + needtobe installed specifically on Linux. It now seems a partofthe + official UNIXspecification. Here is one implementation + ofthelibrarywhich source can be found here.
      • Make check fails on some platforms -

        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.

        -

        Sometimes (especially on Solaris) make checks fail due to limitations - in make. Try using GNU-make instead.

        +

        Sometimes the regression tests' results don't completely matchthevalue + produced by the parser, and the makefile uses diff to printthedelta. On + some platforms the diff return breaks the compilationprocess;if the diff + is small this is probably not a serious problem.

        +

        Sometimes (especially on Solaris) make checks fail due tolimitationsin + make. Try using GNU-make instead.

      • I use the CVS version and there is no configure script -

        The configure script (and other Makefiles) are generated. Use the - autogen.sh script to regenerate the configure script and Makefiles, - like:

        +

        The configure script (and other Makefiles) are generated. + Usetheautogen.sh script to regenerate the configure script + andMakefiles,like:

        ./autogen.sh --prefix=/usr --disable-shared

      • I have troubles when running make tests with gcc-3.0 -

        It seems the initial release of gcc-3.0 has a problem with the - optimizer which miscompiles the URI module. Please use another - compiler.

        +

        It seems the initial release of gcc-3.0 has a problem withtheoptimizer + which miscompiles the URI module. Please useanothercompiler.

        • -

    Developer corner

    1. Troubles compiling or linking programs using libxml2 -

      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 - xml2-config which is installed as part of libxml2 usual - install process which provides those flags. Use

      +

    Developercorner

    1. Troubles compiling or linking programs using libxml2 +

      Usually the problem comes from the fact that the compiler + doesn'tgetthe right compilation or linking flags. There is a small + shellscriptxml2-configwhich is installed as part of + libxml2usualinstall process which provides those flags. Use

      xml2-config --cflags

      to get the compilation flags and

      xml2-config --libs

      -

      to get the linker flags. Usually this is done directly from the - Makefile as:

      +

      to get the linker flags. Usually this is done directly fromtheMakefile + as:

      CFLAGS=`xml2-config --cflags`

      LIBS=`xml2-config --libs`

      2. -
    2. I want to install my own copy of libxml2 in my home directory and - link my programs against it, but it doesn't work -

      There are many different ways to accomplish this. Here is one way to - do this under Linux. Suppose your home directory is /home/user. - Then:

      +
    3. I want to install my own copy of libxml2 in my home + directoryandlink my programs against it, but it doesn't work +

      There are many different ways to accomplish this. Here is one waytodo + this under Linux. Suppose your home directory + is/home/user.Then:

      • Create a subdirectory, let's call it myxml
      • unpack the libxml2 distribution into that subdirectory
        • -
      • chdir into the unpacked distribution - (/home/user/myxml/libxml2 )
        • -
      • configure the library using the "--prefix" switch, - specifying an installation subdirectory in - /home/user/myxml, e.g. -

        ./configure --prefix /home/user/myxml/xmlinst {other - configuration options}

        +
      • chdir into the unpacked + distribution(/home/user/myxml/libxml2)
        • +
      • configure the library using the + "--prefix"switch,specifying an installation + subdirectoryin/home/user/myxml, e.g. +

        ./configure + --prefix/home/user/myxml/xmlinst{otherconfiguration + options}

        • -
      • now run make followed by make install
        • -
      • At this point, the installation subdirectory contains the complete - "private" include files, library files and binary program files (e.g. - xmllint), located in -

        /home/user/myxml/xmlinst/lib, - /home/user/myxml/xmlinst/include and - /home/user/myxml/xmlinst/bin

        +
      • now run makefollowed by make install
        • +
      • At this point, the installation subdirectory contains + thecomplete"private" include files, library files and binary + programfiles (e.g.xmllint), located in +

        /home/user/myxml/xmlinst/lib,/home/user/myxml/xmlinst/includeand + /home/user/myxml/xmlinst/bin

        respectively.
        • -
      • 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 +
      • In order to use this "private" library, you should first add + ittothe beginning of your default PATH (so that your own + privateprogramfiles such as xmllint will be used instead of the + normalsystemones). To do this, the Bash command would be

        export PATH=/home/user/myxml/xmlinst/bin:$PATH

        • -
      • Now suppose you have a program test1.c that you would - like to compile with your "private" library. Simply compile it using - the command +
      • Now suppose you have a program test1.cthat + youwouldlike to compile with your "private" library. Simply compile + itusingthe command

        gcc `xml2-config --cflags --libs` -o test test.c

        - Note that, because your PATH has been set with - /home/user/myxml/xmlinst/bin at the beginning, the xml2-config - program which you just installed will be used instead of the system - default one, and this will automatically get the correct - libraries linked with your program.
        • + Note that, because your PATH has been set + with/home/user/myxml/xmlinst/binat the beginning, + thexml2-configprogram which you just installed will be used instead + ofthe systemdefault one, and this will automaticallyget + thecorrectlibraries linked with your program.

    4. xmlDocDump() generates output on one line. -

      Libxml2 will not invent spaces in the content of a - document since all spaces in the content of a document are - significant. If you build a tree from the API and want - indentation:

      +

      Libxml2 will not inventspaces in the content + ofadocument since all spaces in the content of a + documentaresignificant. If you build a tree from the API + andwantindentation:

      1. the correct way is to generate those yourself too.
        2. -
      2. the dangerous way is to ask libxml2 to add those blanks to your - content modifying the content of your document in the - process. The result may not be what you expect. There is - NO way to guarantee that such a modification won't - affect other parts of the content of your document. See xmlKeepBlanksDefault - () and xmlSaveFormatFile - ()
        3. +
      3. the dangerous way is to ask libxml2 to add those blanks + toyourcontent modifying the content of your document + intheprocess. The result may not be what you expect. + ThereisNOway to guarantee that such a + modificationwon'taffect other parts of the content of your document. + See xmlKeepBlanksDefault()andxmlSaveFormatFile()
    5. Extra nodes in the document:

      For a XML file as below:

      @@ -180,10 +173,10 @@ A:link, A:visited, A:active { text-decoration: underline } <NODE CommFlag="0"/> <NODE CommFlag="1"/> </PLAN> -

      after parsing it with the function - pxmlDoc=xmlParseFile(...);

      -

      I want to the get the content of the first node (node with the - CommFlag="0")

      +

      after parsing it with + thefunctionpxmlDoc=xmlParseFile(...);

      +

      I want to the get the content of the first node (node + withtheCommFlag="0")

      so I did it as following;

      xmlNodePtr pnode;
 pnode=pxmlDoc->children->children;
      @@ -191,63 +184,62 @@ pnode=pxmlDoc->children->children; 
      pnode=pxmlDoc->children->children->next;

      then it works. Can someone explain it to me.

      -

      In XML all characters in the content of the document are significant - including blanks and formatting line breaks.

      -

      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 xmlKeepBlanksDefault - () 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.

      +

      In XML all characters in the content of the document + aresignificantincluding blanks and formatting + linebreaks.

      +

      The extra nodes you are wondering about are just that, text + nodeswiththe formatting spaces which are part of the document but that + peopletendto forget. There is a function xmlKeepBlanksDefault()toremove + those at parse time, but that's an heuristic, and itsuse should belimited + to cases where you are certain there is nomixed-content in + thedocument.

      6. -
    6. I get compilation errors of existing code like when accessing - root or child fields of nodes. -

      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 following the instructions.

      +
    7. I get compilation errors of existing code like + whenaccessingrootor child + fieldsofnodes. +

      You are compiling code developed for libxml version 1 and + usingalibxml2 development environment. Either switch back to libxml v1 + develoreven better fix the code to compile with libxml2 (or both) by following the instructions.

      8. -
    8. I get compilation errors about non existing - xmlRootNode or xmlChildrenNode - fields. -

      The source code you are using has been upgraded to be able to compile with both libxml - and libxml2, but you need to install a more recent version: - libxml(-devel) >= 1.8.8 or libxml2(-devel) >= 2.1.0

      +
    9. I get compilation errors about + nonexistingxmlRootNodeorxmlChildrenNodefields. +

      The source code you are using has been upgradedto be able to compile with both + libxmlandlibxml2, but you need to install a more recent + version:libxml(-devel)>= 1.8.8 or libxml2(-devel) >= 2.1.0

    10. XPath implementation looks seriously broken -

      XPath implementation prior to 2.3.0 was really incomplete. Upgrade to - a recent version, there are no known bugs in the current version.

      +

      XPath implementation prior to 2.3.0 was really incomplete. Upgrade + toarecent version, there are no known bugs in the current version.

    11. The example provided in the web page does not compile. -

      It's hard to maintain the documentation in sync with the code - <grin/> ...

      -

      Check the previous points 1/ and 2/ raised before, and please send - patches.

      +

      It's hard to maintain the documentation in sync with + thecode<grin/> ...

      +

      Check the previous points 1/ and 2/ raised before, and + pleasesendpatches.

      12. -
    12. Where can I get more examples and information than provided on the - web page? -

      Ideally a libxml2 book would be nice. I have no such plan ... But you - can:

      -
      • check more deeply the existing - generated doc
        • -
      • have a look at the set of - examples.
        • -
      • 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 xmlAddChild() function: +
      • Where can I get more examples and information than provided + ontheweb page? +

        Ideally a libxml2 book would be nice. I have no such plan ... + Butyoucan:

        +
        • check more deeply the existinggenerated doc
          • +
        • have a look at the + setofexamples.
          • +
        • look for examples of use for libxml2 function using the + Gnomecode.For example the following will query the full Gnome CVS + base fortheuse of the xmlAddChild()function:

          http://cvs.gnome.org/lxr/search?string=xmlAddChild

          -

          This may be slow, a large hardware donation to the gnome project - could cure this :-)

          +

          This may be slow, a large hardware donation to the + gnomeprojectcould cure this :-)

          • -
        • Browse - the libxml2 source , 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.
          • +
        • Browsethelibxml2 + source, I try to write code as clean and documentedaspossible, so + looking at it may be helpful. In particular the codeofxmllint.c and + of the various testXXX.c test programs shouldprovidegood examples of + how to do things with the library.
      • What about C++ ? -

        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++.

        +

        libxml2 is written in pure C in order to allow easy reuse on anumberof + platforms, including embedded systems. I don't intend to converttoC++.

        There is however a C++ wrapper which may fulfill your needs:

      • How to validate a document a posteriori ? -

        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 xmlValidateDtd() - function. It is also possible to simply add a DTD to an existing - document:

        +

        It is possible to validate documents which had not been + validatedatinitial parsing time or documents which have been built + fromscratchusing the API. Use the xmlValidateDtd()function.It + is also possible to simply add a DTD to an existingdocument:

        xmlDocPtr doc; /* your existing document */
 xmlDtdPtr dtd = xmlParseDTD(NULL, filename_of_dtd); /* parse the DTD */
 
@@ -277,10 +268,10 @@ xmlDtdPtr dtd = xmlParseDTD(NULL, filename_of_dtd); /* parse the DTD */
      • So what is this funky "xmlChar" used all the time? -

        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.

        +

        It is a null terminated sequence of utf-8 characters. And + onlyutf-8!You need to convert strings encoded in different ways to + utf-8beforepassing them to the API. This can be accomplished with the + iconvlibraryfor instance.

      • etc ...

    Daniel Veillard

    diff --git a/doc/XMLinfo.html b/doc/XMLinfo.html index 474f9c1..5314fac 100644 --- a/doc/XMLinfo.html +++ b/doc/XMLinfo.html @@ -7,9 +7,9 @@ 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 } -XML
    Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
    Made with Libxml2 Logo

    The XML C parser and toolkit of Gnome

    XML

    Main Menu
    Related links

    XML is a standard for -markup-based structured documents. Here is an example XML -document:

    <?xml version="1.0"?>
+XML
    Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
    Made with Libxml2 Logo
    The XML C parser and toolkit of Gnome
    XML
    Main Menu
    Related links
    XML is astandardformarkup-based
+structured documents. Here is an example
+XMLdocument:
    <?xml version="1.0"?>
 <EXAMPLE prop1="gnome is great" prop2="&amp; linux too">
   <head>
    <title>Welcome to Gnome</title>
@@ -20,16 +20,17 @@ document:
    <?xml version="1.0"?>
    <image href="linus.gif"/>
    <p>...</p>
   </chapter>
-</EXAMPLE>
    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. Each
-tag opened has to be closed. 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 /> rather than with
->. Note that, for example, the image tag has no content (just
-an attribute) and is closed by ending the tag with />.
    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.
    Daniel Veillard
    
+</EXAMPLE>

    The first line specifies that it is an XML document and +givesusefulinformation about its encoding. Then the rest of the document is +atextformat whose structure is specified by tags between +brackets.Eachtag opened has to be closed. XML is pedantic +about this.However, ifa tag is empty (no content), a single tag can serve as +both theopening andclosing tag if it ends with />rather +thanwith>. Note that, for example, the image tag has no +content(justan attribute) and is closed by ending the tag +with/>.

    XML can be applied successfully to a wide range of tasks, ranging +fromlongterm structured document maintenance (where it follows the steps +ofSGML) tosimple data encoding mechanisms like configuration file +formatting(glade),spreadsheets (gnumeric), or even shorter lived documents +such asWebDAV whereit is used to encode remote calls between a client and +aserver.

    Daniel Veillard

    diff --git a/doc/XSLT.html b/doc/XSLT.html index 657ead3..4a8c09b 100644 --- a/doc/XSLT.html +++ b/doc/XSLT.html @@ -7,7 +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 } -XSLT
    Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
    Made with Libxml2 Logo

    The XML C parser and toolkit of Gnome

    XSLT

    Main Menu
    Related links

    Check the separate libxslt page

    XSL Transformations, is a -language for transforming XML documents into other XML documents (or -HTML/textual output).

    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.

    You can check the progresses on the libxslt Changelog.

    Daniel Veillard

    +XSLT
    Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
    Made with Libxml2 Logo

    The XML C parser and toolkit of Gnome

    XSLT

    Main Menu
    Related links

    Check the separate libxslt page

    XSL Transformations, is +alanguagefor transforming XML documents into other XML documents +(orHTML/textualoutput).

    A separate library called libxslt is available implementing +XSLT-1.0forlibxml2. This module "libxslt" too can be found in the Gnome CVS +base.

    You can check the progresses on the libxslt Changelog.

    Daniel Veillard

    diff --git a/doc/architecture.html b/doc/architecture.html index 906c5b2..7809bc6 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 } -libxml2 architecture
    Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
    Made with Libxml2 Logo

    The XML C parser and toolkit of Gnome

    libxml2 architecture

    Developer Menu
    API Indexes
    Related links

    Libxml2 is made of multiple components; some of them are optional, and -most of the block interfaces are public. The main components are:

    • an Input/Output layer
      • +libxml2 architecture
      Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
      Made with Libxml2 Logo

      The XML C parser and toolkit of Gnome

      libxml2 architecture

      Developer Menu
      API Indexes
      Related links

      Libxml2 is made of multiple components; some of them are optional, +andmostof the block interfaces are public. The main components are:

      • an Input/Output layer
      • FTP and HTTP client layers (optional)
      • an Internationalization layer managing the encodings support
      • a URI module
        • @@ -17,7 +17,6 @@ most of the block interfaces are public. The main components are:

        • an
        • a SAX tree module to build an in-memory DOM representation
        • a tree module to manipulate the DOM representation
        • a validation module using the DOM representation (optional)
          • -
        • an XPath module for global lookup in a DOM representation - (optional)
          • +
        • an XPath module for global lookup in a DOM representation(optional)
        • a debug module (optional)

        Graphically this gives the following:

        a graphical view of the various

        Daniel Veillard

      diff --git a/doc/bugs.html b/doc/bugs.html index 6415c85..c755d00 100644 --- a/doc/bugs.html +++ b/doc/bugs.html @@ -7,62 +7,62 @@ 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 } -Reporting bugs and getting help
      Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
      Made with Libxml2 Logo

      The XML C parser and toolkit of Gnome

      Reporting bugs and getting help

      Main Menu
      Related links

      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 Gnome -bug tracking database (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.

      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).

      There is also a mailing-list xml@gnome.org for libxml, with an on-line archive (old). To subscribe to this list, -please visit the associated Web page and -follow the instructions. Do not send code, I won't debug it -(but patches are really appreciated!).

      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 emails with -a legal warning asking to not copy or redistribute freely the informations -they contain are NOT 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, DO NOT -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.

      Check the following before -posting:

      • Read the FAQ and use the - search engine to get information related to your problem.
        • -
      • Make sure you are using a recent - version, and that the problem still shows up in a recent version.
        • -
      • Check the list - archives to see if the problem was reported already. In this case - there is probably a fix available, similarly check the registered - open bugs.
        • -
      • Make sure you can reproduce the bug with xmllint or one of the test - programs found in source in the distribution.
        • -
      • Please send the command showing the error as well as the input (as an - attachment)
        • -

      Then send the bug with associated information to reproduce it to the xml@gnome.org 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.

      To be really clear about support:

      • Support or help requests MUST be sent to - the list or on bugzilla 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.
        • -
      • There is no garantee of support, if - your question remains unanswered after a week, repost it, making sure you - gave all the detail needed and the information requested.
        • -
      • 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.
        • -

      Of course, bugs reported with a suggested patch for fixing them will -probably be processed faster than those without.

      If you're looking for help, a quick look at the list archive may actually -provide the answer. I usually send source samples when answering libxml2 -usage questions. The auto-generated documentation is -not as polished as I would like (i need to learn more about DocBook), but -it's a good starting point.

      Daniel Veillard

      +Reporting bugs and getting help
      Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
      Made with Libxml2 Logo

      The XML C parser and toolkit of Gnome

      Reporting bugs and getting help

      Main Menu
      Related links

      Well, bugs or missing features are always possible, and I will make +apointof fixing them in a timely fashion. The best way to report a bug is +touse theGnomebugtracking +database(make sure to use the "libxml2" module name). Ilook atreports +there regularly and it's good to have a reminder when a bugis stillopen. Be +sure to specify that the bug is for the package libxml2.

      For small problems you can try to get help on IRC, the #xml +channelonirc.gnome.org (port 6667) usually have a few person subscribed which +mayhelp(but there is no garantee and if a real issue is raised it should go +onthemailing-list for archival).

      There is also a mailing-list xml@gnome.orgfor libxml, with an on-line archive(old). To subscribe to this +list,pleasevisit the associatedWebpage +andfollow the instructions. Do not send code, I won'tdebug +it(but patches are really appreciated!).

      Please note that with the current amount of virus and SPAM, sending +mailtothe 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 isLOST ! Repost it and fix the problem triggering the error. Also +pleasenotethat emails +withalegal warning asking to not copy or redistribute freely the +informationstheycontainare NOTacceptable for the +mailing-list,suchmail will as much as possible be discarded automatically, +and are lesslikelyto be answered if they made it to the list, DO +NOTpost tothe list from an email address where such legal +requirements areautomaticallyadded, get private paying support if you can't +shareinformations.

      Check the following beforeposting:

      • Read the FAQand usethesearch engineto get information related to + your problem.
        • +
      • Make sure you are using + arecentversion, and that the problem still shows up in a + recentversion.
        • +
      • Check the listarchivesto see if + theproblem was reported already. In this casethere is probably a + fixavailable, similarly check the registeredopenbugs.
        • +
      • Make sure you can reproduce the bug with xmllint or one of + thetestprograms found in source in the distribution.
        • +
      • Please send the command showing the error as well as the input + (asanattachment)
        • +

      Then send the bug with associated information to reproduce it to the xml@gnome.orglist; if it's +reallylibxmlrelated I will approve it. Please do not send mail to me +directly, itmakesthings really hard to track and in some cases I am not the +best persontoanswer a given question, ask on the list.

      To be really clear about support:

      • Support or help requests MUST be senttothe + list or on bugzillain case of problems, so that theQuestionand + Answers can be shared publicly. Failing to do so carries + theimplicitmessage "I want free support but I don't want to share + thebenefits withothers" and is not welcome. I will automatically + Carbon-Copythexml@gnome.org mailing list for any technical reply made + about libxml2orlibxslt.
        • +
      • There is no garantee of + support,ifyour question remains unanswered after a week, repost + it, making sureyougave all the detail needed and the information + requested.
        • +
      • Failing to provide information as requested or double checking + firstforprior feedback also carries the implicit message "the time of + thelibrarymaintainers is less valuable than my time" and might not + bewelcome.
        • +

      Of course, bugs reported with a suggested patch for fixing +themwillprobably be processed faster than those without.

      If you're looking for help, a quick look at the list +archivemayactuallyprovide the answer. I usually send source samples when +answeringlibxml2usage questions. The auto-generateddocumentationisnot +as polished as I would like (i need to learn moreabout DocBook), butit's a +good starting point.

      Daniel Veillard

      diff --git a/doc/catalog.html b/doc/catalog.html index 4100fed..34f9902 100644 --- a/doc/catalog.html +++ b/doc/catalog.html @@ -14,77 +14,78 @@ A:link, A:visited, A:active { text-decoration: underline }
    • How to tune catalog usage
    • How to debug catalog processing
    • How to create and maintain catalogs
      • -
    • The implementor corner quick review of the - API
      • +
    • The implementor corner quick review + oftheAPI
    • Other resources
      • -

      General overview

      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.

      It is basically used for 3 things:

      • 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 +

        General overview

        What is a catalog? Basically it's a lookup mechanism used when an +entity(afile or a remote resource) references another entity. The catalog +lookupisinserted between the moment the reference is recognized by the +software(XMLparser, stylesheet processing, or even images referenced for +inclusionin arendering) and the time where loading that resource is +actuallystarted.

        It is basically used for 3 things:

        • mapping from "logical" names, the public identifiers and a + moreconcretename usable for download (and URI). For example it can + associatethelogical name

          "-//OASIS//DTD DocBook XML V4.1.2//EN"

          -

          of the DocBook 4.1.2 XML DTD with the actual URL where it can be - downloaded

          +

          of the DocBook 4.1.2 XML DTD with the actual URL where it + canbedownloaded

          http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd

          • -
        • remapping from a given URL to another one, like an HTTP indirection - saying that +
        • remapping from a given URL to another one, like an + HTTPindirectionsaying that

          "http://www.oasis-open.org/committes/tr.xsl"

          should really be looked at

          "http://www.oasis-open.org/committes/entity/stylesheets/base/tr.xsl"

          • -
        • 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.
          • -

        The definitions

        Libxml, as of 2.4.3 implements 2 kind of catalogs:

        • the older SGML catalogs, the official spec is SGML Open Technical - Resolution TR9401:1997, but is better understood by reading the SP Catalog page from - James Clark. This is relatively old and not the preferred mode of - operation of libxml.
          • -
        • XML - Catalogs is far more flexible, more recent, uses an XML syntax and - should scale quite better. This is the default option of libxml.
          • -

        Using catalog

        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:

        <?xml version='1.0'?>
+  
      • providing a local cache mechanism allowing to load
+    theentitiesassociated to public identifiers or remote resources, this is
+    areallyimportant feature for any significant deployment of XML or
+    SGMLsince itallows to avoid the aleas and delays associated to
+    fetchingremoteresources.
        • 
+

      The definitions

      Libxml, as of 2.4.3 implements 2 kind of catalogs:

      • the older SGML catalogs, the official spec is SGML + OpenTechnicalResolution TR9401:1997, but is better understood by reading + the SP + CatalogpagefromJames Clark. This is relatively old and not the + preferredmode ofoperation of libxml.
        • +
      • XMLCatalogsisfar + more flexible, more recent, uses an XML syntax andshould scale + quitebetter. This is the default option of libxml.
        • +

      Using catalog

      In a normal environment libxml2 will by default check the presence +ofacatalog in /etc/xml/catalog, and assuming it has been +correctlypopulated,the processing is completely transparent to the document +user. Totake aconcrete example, suppose you are authoring a DocBook document, +thisonestarts with the following DOCTYPE definition:

      <?xml version='1.0'?>
 <!DOCTYPE book PUBLIC "-//Norman Walsh//DTD DocBk XML V3.1.4//EN"
-          "http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd">

      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.

      Note: Really don't use this -DOCTYPE example it's a really old version, but is fine as an example.

      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.

      Some examples:

      Here is a couple of fragments from XML Catalogs used in libxml2 early -regression tests in test/catalogs :

      <?xml version="1.0"?>
+          "http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd">

      When validating the document with libxml, the catalog will +beautomaticallyconsulted to lookup the public identifier "-//Norman +Walsh//DTDDocBk XMLV3.1.4//EN" and the +systemidentifier"http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd", and if +theseentities havebeen installed on your system and the catalogs actually +point tothem, libxmlwill fetch them from the local disk.

      Note: Really don't usethisDOCTYPE +example it's a really old version, but is fine as an example.

      Libxml2 will check the catalog each time that it is requested to +loadanentity, this includes DTD, external parsed entities, stylesheets, etc +...Ifyour system is correctly configured all the authoring phase +andprocessingshould use only local files, even if your document stays +portablebecause ituses the canonical public and system ID, referencing the +remotedocument.

      Some examples:

      Here is a couple of fragments from XML Catalogs used in +libxml2earlyregression tests in test/catalogs:

      <?xml version="1.0"?>
 <!DOCTYPE catalog PUBLIC 
    "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
    "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
 <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
   <public publicId="-//OASIS//DTD DocBook XML V4.1.2//EN"
    uri="http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"/>
-...

      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 public mapping it allows to associate a Public -Identifier with an URI.

      ...
+...

      This is the beginning of a catalog for DocBook 4.1.2, XML +Catalogsarewritten in XML, there is a specific namespace for +catalogelements"urn:oasis:names:tc:entity:xmlns:xml:catalog". The first entry +inthiscatalog is a publicmapping it allows to associate +aPublicIdentifier with an URI.

      ...
     <rewriteSystem systemIdStartString="http://www.oasis-open.org/docbook/"
                    rewritePrefix="file:///usr/share/xml/docbook/"/>
-...

      A rewriteSystem 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.

      ...
+...

      A rewriteSystemis a very powerful instruction, it saysthatany +URI starting with a given prefix should be looked at anotherURIconstructed by +replacing the prefix with an new one. In effect this actslikea cache system +for a full area of the Web. In practice it is extremelyusefulwith a file +prefix if you have installed a copy of those resources onyourlocal system.

      ...
 <delegatePublic publicIdStartString="-//OASIS//DTD XML Catalog //"
                 catalog="file:///usr/share/xml/docbook.xml"/>
 <delegatePublic publicIdStartString="-//OASIS//ENTITIES DocBook XML"
@@ -95,21 +96,21 @@ local system.
      ...
                 catalog="file:///usr/share/xml/docbook.xml"/>
 <delegateURI uriStartString="http://www.oasis-open.org/docbook/"
                 catalog="file:///usr/share/xml/docbook.xml"/>
-...
      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
-/usr/share/xml/docbook.xml 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.
      How to tune catalog usage:
      The user can change the default catalog behaviour by redirecting queries
-to its own set of catalogs, this can be done by setting the
-XML_CATALOG_FILES environment variable to a list of catalogs, an
-empty one should deactivate loading the default /etc/xml/catalog
-default catalog
      How to debug catalog processing:
      Setting up the XML_DEBUG_CATALOG environment variable will
-make libxml2 output debugging informations for each catalog operations, for
-example:
      orchis:~/XML -> xmllint --memory --noout test/ent2
+...
      Delegation is the core features which allows to build a tree
+ofcatalogs,easier to maintain than a single catalog, based on
+PublicIdentifier, SystemIdentifier or URI prefixes it instructs the
+catalogsoftware to look upentries in another resource. This feature allow to
+buildhierarchies ofcatalogs, the set of entries presented should be
+sufficient toredirect theresolution of all DocBook references to the specific
+catalogin/usr/share/xml/docbook.xmlthis one in turn could
+delegateallreferences for DocBook 4.2.1 to a specific catalog installed at
+the sametimeas the DocBook resources on the local machine.
      How to tune catalog usage:
      The user can change the default catalog behaviour by redirecting
+queriestoits own set of catalogs, this can be done by
+settingtheXML_CATALOG_FILESenvironment variable to a list of
+catalogs,anempty one should deactivate loading the
+default/etc/xml/catalogdefault catalog
      How to debug catalog processing:
      Setting up the XML_DEBUG_CATALOGenvironment variable
+willmakelibxml2 output debugging informations for each catalog
+operations,forexample:
      orchis:~/XML -> xmllint --memory --noout test/ent2
 warning: failed to load external entity "title.xml"
 orchis:~/XML -> export XML_DEBUG_CATALOG=
 orchis:~/XML -> xmllint --memory --noout test/ent2
@@ -117,26 +118,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 -> 
      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 /etc/xml/catalog but since it's not present the
-resolution fails.
      But the most advanced way to debug XML catalog processing is to use the
-xmlcatalog 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:
      orchis:~/XML -> ./xmlcatalog test/catalogs/docbook.xml \
+orchis:~/XML -> 
      The test/ent2 references an entity, running the parser from memorymakesthe
+base URI unavailable and the the "title.xml" entity cannot beloaded.Setting
+up the debug environment variable allows to detect that anattempt ismade to
+load the /etc/xml/catalogbut since it's notpresent theresolution
+fails.
      But the most advanced way to debug XML catalog processing is to
+usethexmlcatalogcommand shipped with libxml2, it allows
+toloadcatalogs and make resolution queries to see what is going on. This
+isalsoused for the regression tests:
      orchis:~/XML -> ./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 -> 
      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):
      orchis:~/XML -> ./xmlcatalog -v test/catalogs/docbook.xml \
+orchis:~/XML -> 
      For debugging what is going on, adding one -v flags increase
+theverbositylevel to indicate the processing done (adding a second flag
+alsoindicatewhat elements are recognized at parsing):
      orchis:~/XML -> ./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 -> 
      A shell interface is also available to debug and process multiple queries
-(and for regression tests):
      orchis:~/XML -> ./xmlcatalog -shell test/catalogs/docbook.xml \
+orchis:~/XML -> 
      A shell interface is also available to debug and process
+multiplequeries(and for regression tests):
      orchis:~/XML -> ./xmlcatalog -shell test/catalogs/docbook.xml \
                    "-//OASIS//DTD DocBook XML V4.1.2//EN"
 > help   
 Commands available:
@@ -152,18 +153,18 @@ exit:  quit the shell
 > public "-//OASIS//DTD DocBook XML V4.1.2//EN"
 http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
 > quit
-orchis:~/XML -> 
      This should be sufficient for most debugging purpose, this was actually
-used heavily to debug the XML Catalog implementation itself.
      How to create and maintain catalogs:
      Basically XML Catalogs are XML files, you can either use XML tools to
-manage them or use  xmlcatalog for this. The basic step is
-to create a catalog the -create option provide this facility:
      orchis:~/XML -> ./xmlcatalog --create tst.xml
+orchis:~/XML -> 
      This should be sufficient for most debugging purpose, this wasactuallyused
+heavily to debug the XML Catalog implementation itself.
      How to create and maintaincatalogs:
      Basically XML Catalogs are XML files, you can either use XML toolstomanage
+them or use  xmlcatalogfor this. The basic stepisto create a
+catalog the -create option provide this facility:
      orchis:~/XML -> ./xmlcatalog --create tst.xml
 <?xml version="1.0"?>
 <!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
          "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
 <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"/>
-orchis:~/XML -> 
      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 -add command allows to add entries in the
-catalog:
      orchis:~/XML -> ./xmlcatalog --noout --create --add "public" \
+orchis:~/XML -> 
      By default xmlcatalog does not overwrite the original catalog and
+savetheresult on the standard output, this can be overridden using
+the-nooutoption. The -addcommand allows to add entries
+inthecatalog:
      orchis:~/XML -> ./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 -> cat tst.xml
@@ -174,83 +175,80 @@ orchis:~/XML -> cat tst.xml
 <public publicId="-//OASIS//DTD DocBook XML V4.1.2//EN"
         uri="http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"/>
 </catalog>
-orchis:~/XML -> 
      The -add 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.
      Similarly the -del option remove matching entries from the
-catalog:
      orchis:~/XML -> ./xmlcatalog --del \
+orchis:~/XML -> 
      The -addoption will always take 3 parameters even if
+someofthe XML Catalog constructs (like nextCatalog) will have only
+asingleargument, just pass a third empty string, it will be ignored.
      Similarly the -deloption remove matching entries
+fromthecatalog:
      orchis:~/XML -> ./xmlcatalog --del \
   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" tst.xml
 <?xml version="1.0"?>
 <!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
     "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
 <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"/>
-orchis:~/XML -> 
      The catalog is now empty. Note that the matching of -del is
-exact and would have worked in a similar fashion with the Public ID
-string.
      This is rudimentary but should be sufficient to manage a not too complex
-catalog tree of resources.
      The implementor corner quick review of the
-API:
      First, and like for every other module of libxml, there is an
-automatically generated API page for
-catalog support.
      The header for the catalog interfaces should be included as:
      #include <libxml/catalog.h>
      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 xmlSetExternalEntityLoader to
-plug an application specific resolver).
      Basically libxml2 support 2 catalog lists:
      • the default one, global shared by all the application
        • 
-  
      • a per-document catalog, this one is built if the document uses the
-    oasis-xml-catalog PIs to specify its own catalog list, it is
-    associated to the parser context and destroyed when the parsing context
-    is destroyed.
        • 
-
      the document one will be used first if it exists.
      Initialization routines:
      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.
      The xmlCatalogAddLocal() call is used by the parser to grow the document
-own catalog list if needed.
      Preferences setup:
      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.
      And of course xmlCatalogSetDebug() allows to generate debug messages
-(through the xmlGenericError() mechanism).
      Querying routines:
      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.
      xmlCatalogLocalResolve() and xmlCatalogLocalResolveURI() are the same but
-operate on the document catalog list
      Cleanup and Miscellaneous:
      xmlCatalogCleanup() free-up the global catalog, xmlCatalogFreeLocal() is
-the per-document equivalent.
      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.
      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.
      threaded environments:
      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.
      Other resources
      The XML Catalog specification is relatively recent so there isn't much
-literature to point at:
      • You can find a good rant from Norm Walsh about the
-    need for catalogs, it provides a lot of context informations even if
-    I don't agree with everything presented. Norm also wrote a more recent
-    article XML
-    entities and URI resolvers describing them.
        • 
-  
      • An old XML
-    catalog proposal from John Cowan
        • 
-  
      • The Resource Directory Description
-    Language (RDDL) another catalog system but more oriented toward
-    providing metadata for XML namespaces.
        • 
-  
      • the page from the OASIS Technical Committee on Entity
-    Resolution who maintains XML Catalog, you will find pointers to the
-    specification update, some background and pointers to others tools
-    providing XML Catalog support
        • 
-  
      • There is a shell script 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 ->

      The catalog is now empty. Note that the matching +of-delisexact and would have worked in a similar fashion with +thePublic IDstring.

      This is rudimentary but should be sufficient to manage a not +toocomplexcatalog tree of resources.

      The implementor corner quick review +oftheAPI:

      First, and like for every other module of libxml, there is +anautomaticallygenerated API page +forcatalogsupport.

      The header for the catalog interfaces should be included as:

      #include <libxml/catalog.h>

      The API is voluntarily kept very simple. First it is not +obviousthatapplications really need access to it since it is the default +behaviouroflibxml2 (Note: it is possible to completely override libxml2 +defaultcatalogby using xmlSetExternalEntityLoadertoplug +anapplication specific resolver).

      Basically libxml2 support 2 catalog lists:

      • the default one, global shared by all the application
        • +
      • a per-document catalog, this one is built if the document + usestheoasis-xml-catalogPIs to specify its own catalog list, + itisassociated to the parser context and destroyed when the + parsingcontextis destroyed.
        • +

      the document one will be used first if it exists.

      Initialization routines:

      xmlInitializeCatalog(), xmlLoadCatalog() and xmlLoadCatalogs() +shouldbeused at startup to initialize the catalog, if the catalog +shouldbeinitialized with specific values xmlLoadCatalog() +orxmlLoadCatalogs()should be called before xmlInitializeCatalog() which +wouldotherwise do adefault initialization first.

      The xmlCatalogAddLocal() call is used by the parser to grow thedocumentown +catalog list if needed.

      Preferences setup:

      The XML Catalog spec requires the possibility to select +defaultpreferencesbetween public and system +delegation,xmlCatalogSetDefaultPrefer() allowsthis, xmlCatalogSetDefaults() +andxmlCatalogGetDefaults() allow to control ifXML Catalogs resolution +shouldbe forbidden, allowed for global catalog, fordocument catalog or both, +thedefault is to allow both.

      And of course xmlCatalogSetDebug() allows to generate +debugmessages(through the xmlGenericError() mechanism).

      Querying routines:

      xmlCatalogResolve(), +xmlCatalogResolveSystem(),xmlCatalogResolvePublic()and xmlCatalogResolveURI() +are relatively explicitif you read the XMLCatalog specification they +correspond to section 7algorithms, they shouldalso work if you have loaded an +SGML catalog with asimplified semantic.

      xmlCatalogLocalResolve() and xmlCatalogLocalResolveURI() are the +samebutoperate on the document catalog list

      Cleanup and Miscellaneous:

      xmlCatalogCleanup() free-up the global catalog, xmlCatalogFreeLocal()isthe +per-document equivalent.

      xmlCatalogAdd() and xmlCatalogRemove() are used to dynamically +modifythefirst catalog in the global list, and xmlCatalogDump() allows to +dumpacatalog state, those routines are primarily designed for xmlcatalog, +I'mnotsure that exposing more complex interfaces (like navigation ones) +wouldbereally useful.

      The xmlParseCatalogFile() is a function used to load XML Catalogfiles,it's +similar as xmlParseFile() except it bypass all catalog lookups,it'sprovided +because this functionality may be useful for client tools.

      threaded environments:

      Since the catalog tree is built progressively, some care has been +takentotry to avoid troubles in multithreaded environments. The code is +nowthreadsafe assuming that the libxml2 library has been compiled +withthreadssupport.

      Other resources

      The XML Catalog specification is relatively recent so there +isn'tmuchliterature to point at:

      • You can find a good rant from Norm Walsh about theneedfor + catalogs, it provides a lot of context informations even ifIdon't + agree with everything presented. Norm also wrote a morerecentarticle XMLentitiesand + URI resolversdescribing them.
        • +
      • An oldXMLcatalog + proposalfrom John Cowan
        • +
      • The Resource + DirectoryDescriptionLanguage(RDDL) another catalog system but more + orientedtowardproviding metadata for XML namespaces.
        • +
      • the page from the OASIS Technical Committee + onEntityResolutionwho maintains XML Catalog, you will find pointers + tothespecification update, some background and pointers to + otherstoolsproviding XML Catalog support
        • +
      • There is a shell scriptto + generateXMLCatalogs 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 ontheresources found on the system. Otherwise it will just + create~/xmlcatalogand ~/dbkxmlcatalog and doing:

        export XML_CATALOG_FILES=$HOME/xmlcatalog

        -

        should allow to process DocBook documentations without requiring - network accesses for the DTD or stylesheets

        +

        should allow to process DocBook documentations withoutrequiringnetwork + accesses for the DTD or stylesheets

        • -
      • I have uploaded a - small tarball containing XML Catalogs for DocBook 4.1.2 which seems - to work fine for me too
        • -
      • The xmlcatalog - manual page
        • -

      If you have suggestions for corrections or additions, simply contact -me:

      Daniel Veillard

    +
  • I have uploaded asmalltarballcontaining + XML Catalogs for DocBook 4.1.2 which seemsto workfine for me too
    • +
  • The xmlcatalogmanualpage
    • +

    If you have suggestions for corrections or additions, simply contactme:

    Daniel Veillard

    diff --git a/doc/contribs.html b/doc/contribs.html index e493eb3..2163d60 100644 --- a/doc/contribs.html +++ b/doc/contribs.html @@ -7,34 +7,29 @@ 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 } -Contributions
    Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
    Made with Libxml2 Logo

    The XML C parser and toolkit of Gnome

    Contributions

    Main Menu
    Related links
    • 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.
      • +Contributions
      Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
      Made with Libxml2 Logo

      The XML C parser and toolkit of Gnome

      Contributions

      Main Menu
      Related links

      Daniel Veillard

      diff --git a/doc/devhelp/libxml2-xmlerror.html b/doc/devhelp/libxml2-xmlerror.html index d0eb477..7545da4 100644 --- a/doc/devhelp/libxml2-xmlerror.html +++ b/doc/devhelp/libxml2-xmlerror.html @@ -707,6 +707,7 @@ void xmlResetError (XML_SCHEMAV_CVC_TYPE_2 = 1876 /* 1876 */ XML_SCHEMAV_CVC_IDC = 1877 /* 1877 */ XML_SCHEMAV_CVC_WILDCARD = 1878 /* 1878 */ + XML_SCHEMAV_MISC = 1879 /* 1879 */ XML_XPTR_UNKNOWN_SCHEME = 1900 XML_XPTR_CHILDSEQ_START = 1901 /* 1901 */ XML_XPTR_EVAL_FAILED = 1902 /* 1902 */ diff --git a/doc/devhelp/libxml2-xpath.html b/doc/devhelp/libxml2-xpath.html index 4d1a4cc..f3fe7a6 100644 --- a/doc/devhelp/libxml2-xpath.html +++ b/doc/devhelp/libxml2-xpath.html @@ -72,6 +72,7 @@ int xmlXPathCastNodeSetToBoolean (xmlXPathFunction xmlXPathFuncLookupFunc (void * ctxt,
      const xmlChar * name,
      const xmlChar * ns_uri); xmlChar * xmlXPathCastNodeToString (xmlNodePtr node); int xmlXPathIsNaN (double val); +int xmlXPathContextSetCache (xmlXPathContextPtr ctxt,
      int active,
      int value,
      int options); xmlXPathObjectPtr xmlXPathConvertString (xmlXPathObjectPtr val); xmlXPathObjectPtr xmlXPathConvertBoolean (xmlXPathObjectPtr val); int xmlXPathIsInf (double val); @@ -209,7 +210,8 @@ The content of this structure is not made public by the API. xmlError lastError : the last error xmlNodePtr debugNode : the source node XSLT dictionnary xmlDictPtr 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;

      @@ -435,6 +437,10 @@ The content of this structure is not made public by the API.

      xmlXPathCompiledEval ()

      xmlXPathObjectPtr	xmlXPathCompiledEval	(xmlXPathCompExprPtr comp, 
      						 xmlXPathContextPtr ctx)

      Evaluate the Precompiled XPath expression in the given context.

      comp:the compiled XPath expression
      ctx:the XPath context
      Returns:the xmlXPathObjectPtr resulting from the evaluation or NULL. the caller has to free the object.
      +
      +

      xmlXPathContextSetCache ()

      int	xmlXPathContextSetCache		(xmlXPathContextPtr ctxt, 
      					 int active, 
      					 int value, 
      					 int options)
      
+

      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 <0 for the default number (100). Other values for @options have currently no effect.

      +
      ctxt:the XPath context
      active:enables/disables (creates/frees) the cache
      value:a value with semantics dependant on @options
      options:options (currently only the value 0 is used)
      Returns:0 if the setting succeeded, and -1 on API or internal errors.

      xmlXPathConvertBoolean ()

      xmlXPathObjectPtr	xmlXPathConvertBoolean	(xmlXPathObjectPtr val)

      Converts an existing object to its boolean() equivalent

      diff --git a/doc/devhelp/libxml2.devhelp b/doc/devhelp/libxml2.devhelp index ca79c03..e0af836 100644 --- a/doc/devhelp/libxml2.devhelp +++ b/doc/devhelp/libxml2.devhelp @@ -1297,6 +1297,7 @@ + @@ -3320,6 +3321,7 @@ + diff --git a/doc/docs.html b/doc/docs.html index 4c5fe55..fa30ac2 100644 --- a/doc/docs.html +++ b/doc/docs.html @@ -7,27 +7,22 @@ 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 } -Developer Menu
      Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
      Made with Libxml2 Logo

      The XML C parser and toolkit of Gnome

      Developer Menu

      Developer Menu
      API Indexes
      Related links

      There are several on-line resources related to using libxml:

      1. Use the search engine to look up - information.
        2. +Developer Menu
        Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
        Made with Libxml2 Logo

        The XML C parser and toolkit of Gnome

        Developer Menu

        Developer Menu
        API Indexes
        Related links

        There are several on-line resources related to using libxml:

        1. Use the search engineto lookupinformation.
        2. Check the FAQ.
          3. -
        3. Check the extensive - documentation automatically extracted from code comments.
          4. -
        4. Look at the documentation about libxml - internationalization support.
          5. -
        5. This page provides a global overview and some - examples on how to use libxml.
          6. +
        6. Check the extensivedocumentationautomaticallyextracted + from code comments.
          7. +
        7. Look at the documentation about libxmlinternationalization support.
          8. +
        8. This page provides a global overview and someexampleson how to use libxml.
        9. Code examples
          10. -
        10. John Fleck's libxml2 tutorial: html - or pdf.
          11. -
        11. If you need to parse large files, check the xmlReader API tutorial
          12. -
        12. James Henstridge wrote some nice - documentation explaining how to use the libxml SAX interface.
          13. -
        13. George Lebl wrote an article - for IBM developerWorks about using libxml.
          14. -
        14. Check the TODO - file.
          15. -
        15. Read the 1.x to 2.x upgrade path - description. If you are starting a new project using libxml you should - really use the 2.x version.
          16. +
        16. John Fleck's libxml2 tutorial: htmlorpdf.
          17. +
        17. If you need to parse large files, check the xmlReaderAPI tutorial
          18. +
        18. James Henstridgewrote somenicedocumentationexplaining + how to use the libxml SAX interface.
          19. +
        19. George Lebl wrote anarticlefor + IBM developerWorksabout using libxml.
          20. +
        20. Check theTODOfile.
          21. +
        21. Read the 1.x to 2.x upgrade + pathdescription.If you are starting a new project using libxml you + shouldreally use the2.x version.
        22. And don't forget to look at the mailing-list archive.

        Daniel Veillard

        diff --git a/doc/downloads.html b/doc/downloads.html index e49f483..71ce9a6 100644 --- a/doc/downloads.html +++ b/doc/downloads.html @@ -7,30 +7,28 @@ 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 } -Downloads
        Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
        Made with Libxml2 Logo

        The XML C parser and toolkit of Gnome

        Downloads

        Main Menu
        Related links

        The latest versions of libxml2 can be found on the xmlsoft.org server ( HTTP, FTP and rsync are available), there is also -mirrors (Australia( Web), France) or on the Gnome FTP server as source archive -, Antonin Sprinzl also provide a -mirror in Austria. (NOTE that you need both the libxml(2) and libxml(2)-devel -packages installed to compile applications using libxml.)

        You can find all the history of libxml(2) and libxslt releases in the old directory. The precompiled -Windows binaries made by Igor Zlatovic are available in the win32 directory.

        Binary ports:

        • Red Hat RPMs for i386 are available directly on xmlsoft.org, the source RPM will compile on - any architecture supported by Red Hat.
          • -
        • Igor Zlatkovic is now the - maintainer of the Windows port, he provides - binaries.
          • -
        • Blastwave provides Solaris - binaries.
          • -
        • Steve Ball provides Mac Os X - binaries.
          • +Downloads
          Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
          Made with Libxml2 Logo

          The XML C parser and toolkit of Gnome

          Downloads

          Main Menu
          Related links

          The latest versions of libxml2 can be found on the xmlsoft.orgserver ( HTTP, FTPand rsync are available), there +isalsomirrors (Australia(Web), France) or on the Gnome FTP serveras source +archive,Antonin Sprinzl also provide amirror in Austria. (NOTE +thatyou need both the libxml(2)and libxml(2)-develpackagesinstalled +to compile applications using libxml.)

          You can find all the history of libxml(2) and libxslt releases in the olddirectory. +TheprecompiledWindows binaries made by Igor Zlatovic are available in the win32directory.

          Binary ports:

          If you know other supported binary ports, please contact me.

          Snapshot:

          Contributions:

          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 bindings section

          Libxml2 is also available from CVS:

          Contributions:

          I do accept external contributions, especially if compiling +onanotherplatform, get in touch with the list to upload the package, +wrappersforvarious languages have been provided, and can be found in the bindings section

          Libxml2 is also available from CVS:

          • The GnomeCVSbase. Check the + Gnome CVS + Toolspage;the CVS module is libxml2.

            • -
          • The libxslt module is also present there
            • +
          • The libxsltmodule is also present there

          Daniel Veillard

          diff --git a/doc/encoding.html b/doc/encoding.html index 1f4558d..8db787e 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 } -Encodings support
          Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
          Made with Libxml2 Logo

          The XML C parser and toolkit of Gnome

          Encodings support

          Main Menu
          Related links

          If you are not really familiar with Internationalization (usual shortcut -is I18N) , Unicode, characters and glyphs, I suggest you read a presentation -by Tim Bray on Unicode and why you should care about it.

          If you don't understand why it does not make sense to have a string -without knowing what encoding it uses, then as Joel Spolsky said please do not -write another line of code until you finish reading that article.. It is -a prerequisite to understand this page, and avoid a lot of problems with -libxml2, XML or text processing in general.

          Table of Content:

          1. What does internationalization support - mean ?
            2. -
          2. The internal encoding, how and - why
            3. +Encodings support
            Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
            Made with Libxml2 Logo

            The XML C parser and toolkit of Gnome

            Encodings support

            Main Menu
            Related links

            If you are not really familiar with Internationalization (usual +shortcutisI18N) , Unicode, characters and glyphs, I suggest you read a presentationbyTim +Bray on Unicode and why you should care about it.

            If you don't understand why it does not make sense to have +astringwithout knowing what encoding it uses, then as Joel Spolsky said +please do +notwriteanother line of code until you finish reading that article.. It +isaprerequisite to understand this page, and avoid a lot of +problemswithlibxml2, XML or text processing in general.

            Table of Content:

            1. What does internationalization + supportmean?
              2. +
            2. The internal encoding, + howandwhy
            3. How is it implemented ?
            4. Default supported encodings
              5. -
            5. How to extend the existing - support
              6. -

            What does internationalization support mean ?

            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:

            <?xml version="1.0" encoding="ISO-8859-1"?>
+  
          3. How to extend theexistingsupport
            4. 
+
            What does internationalization support mean ?
            XML was designed from the start to allow the support of any charactersetby
+using Unicode. Any conformant XML parser has to support the UTF-8andUTF-16
+default encodings which can both express the full unicode ranges.UTF8is a
+variable length encoding whose greatest points are to reuse thesameencoding
+for ASCII and to save space for Western encodings, but it is abitmore complex
+to handle in practice. UTF-16 use 2 bytes per character(andsometimes combines
+two pairs), it makes implementation easier, but looksabit overkill for
+Western languages encoding. Moreover the XMLspecificationallows the document
+to be encoded in other encodings at thecondition thatthey are clearly labeled
+as such. For example the following isa wellformedXML document encoded in
+ISO-8859-1 and using accentuated lettersthat weFrench like for both markup
+and content:
            <?xml version="1.0" encoding="ISO-8859-1"?>
 <très>là</très>
            Having internationalization support in libxml2 means the following:
            • the document is properly parsed
              • 
   
            • informations about it's encoding are saved
              • 
   
            • it can be modified
              • 
   
            • it can be saved in its original encoding
              • 
-  
            • it can also be saved in another encoding supported by libxml2 (for
-    example straight UTF8 or even an ASCII form)
              • 
-
            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.
            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:
            <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
+  
          4. it can also be saved in another encoding supported by
+    libxml2(forexample straight UTF8 or even an ASCII form)
            5. 
+
            Another very important point is that the whole libxml2 API,
+withtheexception of a few routines to read with a specific encoding or save
+toaspecific encoding, is completely agnostic about the original encoding
+ofthedocument.
            It should be noted too that the HTML parser embedded in libxml2 nowobeythe
+same rules too, the following document will be (as of 2.2.2) handledinan
+internationalized fashion by libxml2 too:
            <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
                       "http://www.w3.org/TR/REC-html40/loose.dtd">
 <html lang="fr">
 <head>
@@ -52,59 +52,60 @@ an internationalized fashion by libxml2 too:
            <!DOCTYPE HTML PUBLIC "-
 </head>
 <body>
 <p>W3C crée des standards pour le Web.</body>
-</html>
            The internal encoding, how and why
            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:
            • 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.
              • 
-  
            • 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:
-    
              • 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
                • 
-      
              • 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.
                • 
-      
              • UTF-8 is being used as the de-facto internal encoding standard for
-        related code like the pango
-        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)
                • 
+</html>
            The internal encoding, how and why
            One of the core decisions was to force all documents to be converted
+toadefault internal encoding, and that encoding to be UTF-8, here
+aretherationales for those choices:
            • keeping the native encoding in the internal form would force
+    thelibxmlusers (or the code associated) to be fully aware of the encoding
+    oftheoriginal document, for examples when adding a text node to
+    adocument,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'sconformantto the encoding, etc ... Very hard in practice, though
+    in somespecificcases this may make sense.
              • 
+  
            • the second decision was which encoding. From the XML spec only
+    UTF8andUTF16 really makes sense as being the two only encodings for
+    whichthereis mandatory support. UCS-4 (32 bits fixed size encoding)
+    couldbeconsidered an intelligent choice too since it's a direct
+    Unicodemappingsupport. I selected UTF-8 on the basis of efficiency
+    andcompatibilitywith surrounding software:
+    
              • UTF-8 while a bit more complex to convert from/to (i.e.slightlymore
+        costly to import and export CPU wise) is also far morecompactthan
+        UTF-16 (and UCS-4) for a majority of the documents I seeit usedfor
+        right now (RPM RDF catalogs, advogato data, variousconfigurationfile
+        formats, etc.) and the key point for today'scomputerarchitecture is
+        efficient uses of caches. If one nearlydouble thememory requirement
+        to store the same amount of data, thiswill trashcaches (main
+        memory/external caches/internal caches) and mytake isthat this harms
+        the system far more than the CPU requirementsneededfor the conversion
+        to UTF-8
                • 
+      
              • Most of libxml2 version 1 users were using it with
+        straightASCIImost of the time, doing the conversion with an
+        internalencodingrequiring all their code to be rewritten was a
+        seriousshow-stopperfor using UTF-16 or UCS-4.
                • 
+      
              • UTF-8 is being used as the de-facto internal encoding
+        standardforrelated code like the pangoupcoming Gnome text widget,
+        anda lot of Unix code (yet another placewhere Unix programmer base
+        takesa different approach from Microsoft- they are using UTF-16)
                • 
     
              • 
-
            What does this mean in practice for the libxml2 user:
            • 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.
              • 
-  
            • One just need to make sure that when using chars outside the ASCII set,
-    the values has been properly converted to UTF-8
              • 
-
            How is it implemented ?
            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:
            1. 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
              2. 
-  
            2. 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.
              3. 
-  
            3. 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:
+
              What does this mean in practice for the libxml2 user:
              • xmlChar, the libxml2 data type is a byte, those bytes must
+    beassembledas UTF-8 valid strings. The proper way to terminate an xmlChar
+    *stringis simply to append 0 byte, as usual.
                • 
+  
              • One just need to make sure that when using chars outside the
+    ASCIIset,the values has been properly converted to UTF-8
                • 
+
              How is it implemented ?
              Let's describe how all this works within libxml, basically
+theI18N(internationalization) support get triggered only during I/O
+operation,i.e.when reading a document or saving one. Let's look first at
+thereadingsequence:
              1. when a document is processed, we usually don't know the
+    encoding,asimple heuristic allows to detect UTF-16 and UCS-4 from
+    encodingswherethe ASCII range (0-0x7F) maps with ASCII
                2. 
+  
              2. the xml declaration if available is parsed, including
+    theencodingdeclaration. At that point, if the autodetected encoding
+    isdifferentfrom the one declared a call to xmlSwitchEncoding()
+  isissued.
                3. 
+  
              3. If there is no encoding declaration, then the input has to be
+    ineitherUTF-8 or UTF-16, if it is not then at some point when
+    processingtheinput, the converter/checker of UTF-8 form will raise an
+    encodingerror.You may end-up with a garbled document, or no document at
+    all !Example:
     
                ~/XML -> ./xmllint err.xml 
 err.xml:1: error: Input is not proper UTF-8, indicate encoding !
 <très>là</très>
@@ -113,94 +114,93 @@ err.xml:1: error: Bytes: 0xE8 0x73 0x3E 0x6C
 <très>là</très>
    ^
                
   
                4. 
-  
              4. 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:
+  
              5. xmlSwitchEncoding() does an encoding name lookup, canonicalize
+    it,andthen search the default registered encoding converters for
+    thatencoding.If it's not within the default set and iconv() support has
+    beencompiledit, it will ask iconv for such an encoder. If this fails then
+    theparserwill report an error and stops processing:
     
                ~/XML -> ./xmllint err2.xml 
 err2.xml:1: error: Unsupported encoding UnsupportedEnc
 <?xml version="1.0" encoding="UnsupportedEnc"?>
                                              ^
                
   
                6. 
-  
              6. 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).
                7. 
-  
              7. The result (when using DOM) is an internal form completely in UTF-8
-    with just an encoding information on the document node.
                8. 
-
              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:
              1. 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,
+  
              2. From that point the encoder processes progressively the input
+    (itisplugged as a front-end to the I/O module) for that entity.
+    Itcapturesand converts on-the-fly the document to be parsed to UTF-8.
+    Theparseritself just does UTF-8 checking of this input and
+    processittransparently. The only difference is that the encoding
+    informationhasbeen added to the parsing context (more precisely to
+    theinputcorresponding to this entity).
                3. 
+  
              3. The result (when using DOM) is an internal form completely in
+    UTF-8withjust an encoding information on the document node.
                4. 
+
              Ok then what happens when saving the document (assuming
+youcollected/builtan 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
+agivenencoding:
              1. if no encoding is given, libxml2 will look for an
+    encodingvalueassociated to the document and if it exists will try to save
+    tothatencoding,
     
                otherwise everything is written in the internal form, i.e. UTF-8
                
   
                2. 
-  
              2. 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
                3. 
-  
              3. 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.
                4. 
-  
              4. 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 &#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
                5. 
+  
              5. so if an encoding was specified, either at the API level or
+    onthedocument, libxml2 will again canonicalize the encoding name,
+    lookupfor aconverter in the registered set or through iconv. If not
+    foundthefunction will return an error code
                6. 
+  
              6. the converter is placed before the I/O buffer layer, as another
+    kindofbuffer, then libxml2 will simply push the UTF-8 serialization
+    tothroughthat buffer, which will then progressively be converted and
+    pushedontothe I/O layer.
                7. 
+  
              7. It is possible that the converter code fails on some input,
+    forexampletrying to push an UTF-8 encoded Chinese character through
+    theUTF-8 toISO-8859-1 converter won't work. Since the encoders
+    areprogressive theywill just report the error and the number of
+    bytesconverted, at thatpoint libxml2 will decode the offending
+    character,remove it from thebuffer and replace it with the associated
+    charRefencoding &#123; andresume the conversion. This guarantees that
+    anydocument will be savedwithout losses (except for markup names where
+    thisis not legal, this isa problem in the current version, in practice
+    avoidusing non-asciicharacters for tag or attribute names). A special
+    "ascii"encoding nameis used to save documents to a pure ascii form can be
+    usedwhenportability is really crucial
                8. 
 
              Here are a few examples based on the same test document:
              ~/XML -> ./xmllint isolat1 
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <très>là</très>
 ~/XML -> ./xmllint --encode UTF-8 isolat1 
 <?xml version="1.0" encoding="UTF-8"?>
 <très>là  </très>
-~/XML -> 
              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 <meta> tag under the <head>,
-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).
              Default supported encodings
              libxml2 has a set of default converters for the following encodings
-(located in encoding.c):
              1. UTF-8 is supported by default (null handlers)
                2. 
+~/XML -> 
            The same processing is applied (and reuse most of the code) for
+HTMLI18Nprocessing. Looking up and modifying the content encoding is a
+bitmoredifficult since it is located in a <meta> tag under
+the<head>,so a couple of functions htmlGetMetaEncoding()
+andhtmlSetMetaEncoding() havebeen provided. The parser also attempts to
+switchencoding on the fly whendetecting such a tag on input. Except for that
+theprocessing is the same(and again reuses the same code).
            Default supported encodings
            libxml2 has a set of default converters for the followingencodings(located
+in encoding.c):
            1. UTF-8 is supported by default (null handlers)
              2. 
   
            2. UTF-16, both little and big endian
              3. 
   
            3. ISO-Latin-1 (ISO-8859-1) covering most western languages
              4. 
   
            4. ASCII, useful mostly for saving
              5. 
-  
            5. HTML, a specific handler for the conversion of UTF-8 to ASCII with HTML
-    predefined entities like &copy; for the Copyright sign.
              6. 
-
            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.
            To convert from the UTF-8 values returned from the API to another encoding
-then it is possible to use the function provided from the encoding module like UTF8Toisolat1, or use the
-POSIX iconv()
-API directly.
            Encoding aliases
            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:
            • int xmlAddEncodingAlias(const char *name, const char *alias);
              • 
+  
            • HTML, a specific handler for the conversion of UTF-8 to ASCII
+    withHTMLpredefined entities like &copy; for the Copyright sign.
              • 
+
              More over when compiled on an Unix platform with iconv support the
+fullsetof encodings supported by iconv can be instantly be used by libxml. On
+alinuxmachine with glibc-2.1 the list of supported encodings and aliases
+fill3 fullpages, and include UCS-4, the full set of ISO-Latin encodings, and
+thevariousJapanese ones.
              To convert from the UTF-8 values returned from the API to
+anotherencodingthen it is possible to use the function provided from the encoding modulelike UTF8Toisolat1, or
+usethePOSIX iconv()APIdirectly.
              Encoding aliases
              From 2.2.3, libxml2 has support to register encoding names aliases.Thegoal
+is to be able to parse document whose encoding is supported butwherethe name
+differs (for example from the default set of names acceptedbyiconv). The
+following functions allow to register and handle new aliasesforexisting
+encodings. Once registered libxml2 will automatically lookupthealiases when
+handling a document:
              • int xmlAddEncodingAlias(const char *name, const char *alias);
                • 
   
              • int xmlDelEncodingAlias(const char *alias);
                • 
   
              • const char * xmlGetEncodingAlias(const char *alias);
                • 
   
              • void xmlCleanupEncodingAliases(void);
                • 
-
              How to extend the existing support
              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.
              Daniel Veillard
            +

            How to extend the existing support

            Well adding support for new encoding, or overriding one of +theencoders(assuming it is buggy) should not be hard, just write input +andoutputconversion routines to/from UTF-8, and register +themusingxmlNewCharEncodingHandler(name, xxxToUTF8, UTF8Toxxx), and they +willbecalled automatically if the parser(s) encounter such an +encodingname(register it uppercase, this will help). The description of +theencoders,their arguments and expected return values are described in +theencoding.hheader.

            Daniel Veillard

          diff --git a/doc/entities.html b/doc/entities.html index c234b41..732562a 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 } -Entities or no entities
          Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
          Made with Libxml2 Logo

          The XML C parser and toolkit of Gnome

          Entities or no entities

          Developer Menu
          API Indexes
          Related links

          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:

          1 <?xml version="1.0"?>
+Entities or no entities
          Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
          Made with Libxml2 Logo
          The XML C parser and toolkit of Gnome
          Entities or no entities
          Developer Menu
          API Indexes
          Related links
          Entities in principle are similar to simple C macros. An entity
+definesanabbreviation for a given string that you can reuse many times
+throughoutthecontent of your document. Entities are especially useful when a
+givenstringmay occur frequently within a document, or to confine the change
+neededto adocument to a restricted area in the internal subset of the
+document (atthebeginning). Example:
          1 <?xml version="1.0"?>
 2 <!DOCTYPE EXAMPLE SYSTEM "example.dtd" [
 3 <!ENTITY xml "Extensible Markup Language">
 4 ]>
 5 <EXAMPLE>
 6    &xml;
-7 </EXAMPLE>
          Line 3 declares the xml entity. Line 6 uses the xml entity, by prefixing
-its name with '&' 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:
-&lt; for the character '<', &gt;
-for the character '>',  &apos; for the character ''',
-&quot; for the character '"', and
-&amp; for the character '&'.
          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 xmlSubstituteEntitiesDefault()
-function allows you to check and change the behaviour, which is to not
-substitute entities by default.
          Here is the DOM tree built by libxml2 for the previous document in the
-default case:
          /gnome/src/gnome-xml -> ./xmllint --debug test/ent1
+7 </EXAMPLE>
          Line 3 declares the xml entity. Line 6 uses the xml entity, byprefixingits
+name with '&' and following it by ';' without any spacesadded. Thereare 5
+predefined entities in libxml2 allowing you to escapecharacters
+withpredefined meaning in some parts of the xml
+documentcontent:&lt;for the character
+'<',&gt;for the character
+'>',&apos;for the
+character''',&quot;for the character
+'"',and&amp;for the character '&'.
          One of the problems related to entities is that you may want the
+parsertosubstitute an entity's content so that you can see the replacement
+textinyour application. Or you may prefer to keep entity references as such
+inthecontent to be able to save the document back without losing
+thisusuallyprecious information (if the user went through the pain
+ofexplicitlydefining entities, he may have a a rather negative attitude if
+youblindlysubstitute them as saving time). The xmlSubstituteEntitiesDefault()functionallows
+you to check and change the behaviour, which is to notsubstituteentities by
+default.
          Here is the DOM tree built by libxml2 for the previous document
+inthedefault case:
          /gnome/src/gnome-xml -> ./xmllint --debug test/ent1
 DOCUMENT
 version=1.0
    ELEMENT EXAMPLE
@@ -49,16 +50,17 @@ DOCUMENT
 version=1.0
    ELEMENT EXAMPLE
      TEXT
-     content=     Extensible Markup Language
          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.
          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).
          WARNING: 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.
          Daniel Veillard
          
+     content=     Extensible Markup Language

          So, entities or no entities? Basically, it depends on your use +case.Isuggest that you keep the non-substituting default behaviour and +avoidusingentities in your XML document or data if you are not willing to +handletheentity references elements in the DOM tree.

          Note that at save time libxml2 enforces the conversion of +thepredefinedentities where necessary to prevent well-formedness problems, +andwill alsotransparently replace those with chars (i.e. it will not +generateentityreference elements in the DOM tree or call the reference() SAX +callbackwhenfinding them in the input).

          WARNING: handlingentitieson +top of the libxml2 SAX interface is difficult!!! If you plan +tousenon-predefined entities in your documents, then the learning curve +tohandlethen using the SAX API may be long. If you plan to use +complexdocuments, Istrongly suggest you consider using the DOM interface +instead andlet libxmldeal with the complexity rather than trying to do it +yourself.

          Daniel Veillard

          diff --git a/doc/example.html b/doc/example.html index 894f03a..194f619 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 } -A real example
          Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
          Made with Libxml2 Logo

          The XML C parser and toolkit of Gnome

          A real example

          Developer Menu
          API Indexes
          Related links

          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 XML encoded jobs -base:

          <?xml version="1.0"?>
+A real example
          Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
          Made with Libxml2 Logo
          The XML C parser and toolkit of Gnome
          A real example
          Developer Menu
          API Indexes
          Related links
          Here is a real size example, where the actual content of
+theapplicationdata is not kept in the DOM tree but uses internal structures.
+Itis based ona proposal to keep a database of jobs related to Gnome, with
+anXML basedstorage structure. Here is an XML
+encodedjobsbase:
          <?xml version="1.0"?>
 <gjob:Helping xmlns:gjob="http://www.gnome.org/some-location">
   <gjob:Jobs>
 
@@ -66,13 +66,14 @@ base:
          <?xml version="1.0"?>
     </gjob:Job>
 
   </gjob:Jobs>
-</gjob:Helping>
          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.
          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:
          /*
+</gjob:Helping>
          While loading the XML file into an internal DOM tree is a matter
+ofcallingonly a couple of functions, browsing the tree to gather the data
+andgeneratethe internal structures is harder, and more error prone.
          The suggested principle is to be tolerant with respect to
+theinputstructure. For example, the ordering of the attributes is
+notsignificant,the XML specification is clear about it. It's also usually a
+goodidea not todepend on the order of the children of a given node, unless
+itreally makesthings harder. Here is some code to parse the information for
+aperson:
          /*
  * A person record
  */
 typedef struct person {
@@ -113,21 +114,22 @@ DEBUG("parsePerson\n");
     }
 
     return(ret);
-}
          Here are a couple of things to notice:
          • 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.
            • 
-  
          • The two arguments of type xmlDocPtr and xmlNsPtr,
-    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->ns == ns).
            • 
-  
          • To retrieve text and attributes value, you can use the function
-    xmlNodeListGetString to gather all the text and entity reference
-    nodes generated by the DOM output and produce an single text string.
            • 
-
          Here is another piece of code used to parse another level of the
-structure:
          #include <libxml/tree.h>
+}
          Here are a couple of things to notice:
          • Usually a recursive parsing style is the more convenient one: XMLdatais
+    by nature subject to repetitive constructs and usually
+    exhibitshighlystructured patterns.
            • 
+  
          • The two arguments of type xmlDocPtrand
+    xmlNsPtr,i.e.the pointer to the global XML document and the
+    namespace reserved totheapplication. Document wide information are needed
+    for example todecodeentities and it's a good coding practice to define a
+    namespace foryourapplication set of data and test that the element and
+    attributesyou'reanalyzing actually pertains to your application space.
+    This isdone by asimple equality test (cur->ns == ns).
            • 
+  
          • To retrieve text and attributes value, you can use
+    thefunctionxmlNodeListGetStringto gather all the text and
+    entityreferencenodes generated by the DOM output and produce an single
+    textstring.
            • 
+
          Here is another piece of code used to parse another level
+ofthestructure:
          #include <libxml/tree.h>
 /*
  * a Description for a Job
  */
@@ -177,10 +179,10 @@ DEBUG("parseJob\n");
     }
 
     return(ret);
-}
          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 :-)
          Feel free to use the code for the full C
-parsing example as a template, it is also available with Makefile in the
-Gnome CVS base under gnome-xml/example
          Daniel Veillard
          
+}

          Once you are used to it, writing this kind of code is quite +simple,butboring. Ultimately, it could be possible to write stubbers taking +eitherCdata structure definitions, a set of XML examples or an XML DTD +andproducethe code needed to import and export the content between C data +andXMLstorage. This is left as an exercise to the reader :-)

          Feel free to use the code for the +fullCparsing exampleas a template, it is also available with Makefile +intheGnome CVS base under gnome-xml/example

          Daniel Veillard

          diff --git a/doc/help.html b/doc/help.html index 5559007..a660a87 100644 --- a/doc/help.html +++ b/doc/help.html @@ -7,19 +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 } -How to help
          Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
          Made with Libxml2 Logo

          The XML C parser and toolkit of Gnome

          How to help

          Main Menu
          Related links

          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 archives and the Gnome bug -database:

          1. Provide patches when you find problems.
            2. -
          2. 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
            3. -
          3. Provide documentation fixes (either as patches to the code comments or - as HTML diffs).
            4. -
          4. Provide new documentations pieces (translations, examples, etc - ...).
            5. +How to help
            Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
            Made with Libxml2 Logo

            The XML C parser and toolkit of Gnome

            How to help

            Main Menu
            Related links

            You can help the project in various ways, the best thing to do first +istosubscribe to the mailing-list as explained before, check the archives and the Gnomebugdatabase:

            1. Provide patches when you find problems.
              2. +
            2. Provide the diffs when you port libxml2 to a new platform. They + maynotbe integrated in all cases but help pinpointing + portabilityproblemsand
              3. +
            3. Provide documentation fixes (either as patches to the code commentsoras + HTML diffs).
              4. +
            4. Provide new documentations pieces (translations, examples, etc...).
            5. Check the TODO file and try to close one of the items.
              6. -
            6. Take one of the points raised in the archive or the bug database and - provide a fix. Get in touch with me - before to avoid synchronization problems and check that the suggested - fix will fit in nicely :-)
              7. +
            7. Take one of the points raised in the archive or the bug + databaseandprovide a fix. Get in + touch withmebefore to avoid synchronization problems and check that + thesuggestedfix will fit in nicely :-)

            Daniel Veillard

            diff --git a/doc/html/libxml-xmlerror.html b/doc/html/libxml-xmlerror.html index f526e69..aefa967 100644 --- a/doc/html/libxml-xmlerror.html +++ b/doc/html/libxml-xmlerror.html @@ -657,6 +657,7 @@ void xmlStructuredErrorFunc (void * userD XML_SCHEMAV_CVC_TYPE_2 = 1876 : 1876 XML_SCHEMAV_CVC_IDC = 1877 : 1877 XML_SCHEMAV_CVC_WILDCARD = 1878 : 1878 + XML_SCHEMAV_MISC = 1879 : 1879 XML_XPTR_UNKNOWN_SCHEME = 1900 XML_XPTR_CHILDSEQ_START = 1901 : 1901 XML_XPTR_EVAL_FAILED = 1902 : 1902 diff --git a/doc/html/libxml-xpath.html b/doc/html/libxml-xpath.html index 4cfb2bc..a0d9ba7 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. 
            int	xmlXPathCmpNodes		(xmlNodePtr node1, 
            					 xmlNodePtr node2)
            xmlXPathCompExprPtr	xmlXPathCompile	(const xmlChar * str)
            xmlXPathObjectPtr	xmlXPathCompiledEval	(xmlXPathCompExprPtr comp, 
            						 xmlXPathContextPtr ctx)
            +
            int	xmlXPathContextSetCache		(xmlXPathContextPtr ctxt, 
            					 int active, 
            					 int value, 
            					 int options)
            xmlXPathObjectPtr	xmlXPathConvertBoolean	(xmlXPathObjectPtr val)
            Function type: xmlXPathConvertFunc
 int	xmlXPathConvertFunc		(xmlXPathObjectPtr obj, 
            					 int type)
@@ -138,7 +139,8 @@ The content of this structure is not made public by the API.
     xmlError	lastError	: the last error
     xmlNodePtr	debugNode	: the source node XSLT dictionnary
     xmlDictPtr	dict	: dictionnary if any
-    int	flags	: flags to control compilation
+    int	flags	: flags to control compilation Cache for
+    void *	cache
 }

            Enum xmlXPathError

            Enum xmlXPathError {
     XPATH_EXPRESSION_OK = 0
     XPATH_NUMBER_ERROR = 1
@@ -244,7 +246,9 @@ The content of this structure is not made public by the API.

            Compile an XPath expression

            str:the XPath expression
            Returns:the xmlXPathCompExprPtr resulting from the compilation or NULL. the caller has to free the object.

            Function: xmlXPathCompiledEval

            xmlXPathObjectPtr	xmlXPathCompiledEval	(xmlXPathCompExprPtr comp, 
            						 xmlXPathContextPtr ctx)

            Evaluate the Precompiled XPath expression in the given context.

            -
            comp:the compiled XPath expression
            ctx:the XPath context
            Returns:the xmlXPathObjectPtr resulting from the evaluation or NULL. the caller has to free the object.

            Function: xmlXPathConvertBoolean

            xmlXPathObjectPtr	xmlXPathConvertBoolean	(xmlXPathObjectPtr val)
            
+
            comp:the compiled XPath expression
            ctx:the XPath context
            Returns:the xmlXPathObjectPtr resulting from the evaluation or NULL. the caller has to free the object.
            Function: xmlXPathContextSetCache
            int	xmlXPathContextSetCache		(xmlXPathContextPtr ctxt, 
            					 int active, 
            					 int value, 
            					 int options)
            
+
            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 <0 for the default number (100). Other values for @options have currently no effect.
            
+
            ctxt:the XPath context
            active:enables/disables (creates/frees) the cache
            value:a value with semantics dependant on @options
            options:options (currently only the value 0 is used)
            Returns:0 if the setting succeeded, and -1 on API or internal errors.
            Function: xmlXPathConvertBoolean
            xmlXPathObjectPtr	xmlXPathConvertBoolean	(xmlXPathObjectPtr val)
            
 
            Converts an existing object to its boolean() equivalent
            
 
            val:an XPath object
            Returns:the new object, the old one is freed (or the operation is done directly on @val)
            Function type: xmlXPathConvertFunc
            Function type: xmlXPathConvertFunc
 int	xmlXPathConvertFunc		(xmlXPathObjectPtr obj, 
            					 int type)
diff --git a/doc/index.html b/doc/index.html
index 21d61eb..22f013b 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -216,74 +216,73 @@ A:link, A:visited, A:active { text-decoration: underline }

          -

          "Programming -with libxml2 is like the thrilling embrace of an exotic stranger." Mark -Pilgrim

          -

          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 MIT -License. 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 variety of language bindings make it available in -other environments.

          -

          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, ...)

          -

          Libxml2 implements a number of existing standards related to markup -languages:

          +

          "Programmingwithlibxml2 +is like the thrilling embrace of an exotic stranger." MarkPilgrim

          +

          Libxml2 is the XML C parser and toolkit developed for the Gnomeproject(but +usable outside of the Gnome platform), it is free softwareavailableunder the +MITLicense.XML +itself is a metalanguage to design markup languages, i.e.text languagewhere +semantic and structure are added to the content usingextra +"markup"information enclosed between angle brackets. HTML is the +mostwell-knownmarkup language. Though the library is written in C avariety of language bindingsmake it available inother +environments.

          +

          Libxml2 is known to be very portable, the library should build +andworkwithout serious troubles on a variety of systems (Linux, +Unix,Windows,CygWin, MacOS, MacOS X, RISC Os, OS/2, VMS, QNX, MVS, ...)

          +

          Libxml2 implements a number of existing standards related +tomarkuplanguages:

          -

          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 OASIS XML Tests -Suite.

          -

          To some extent libxml2 provides support for the following additional -specifications but doesn't claim to implement them completely:

          -
          • Document Object Model (DOM) http://www.w3.org/TR/DOM-Level-2-Core/ - the document model, but it doesn't implement the API itself, gdome2 does - this on top of libxml2
            • -
          • RFC 959 : - libxml2 implements a basic FTP client code
            • -
          • RFC 1945 : - HTTP/1.0, again a basic HTTP client code
            • -
          • SAX: a SAX2 like interface and a minimal SAX1 implementation compatible - with early expat versions
            • +

            In most cases libxml2 tries to implement the specifications in +arelativelystrictly compliant way. As of release 2.4.16, libxml2 passed +all1800+ testsfrom the OASIS +XMLTestsSuite.

            +

            To some extent libxml2 provides support for the +followingadditionalspecifications but doesn't claim to implement them +completely:

            +
            • Document Object Model (DOM) http://www.w3.org/TR/DOM-Level-2-Core/thedocument + model, but it doesn't implement the API itself, gdome2 doesthison top of + libxml2
              • +
            • RFC959:libxml2 + implements a basic FTP client code
              • +
            • RFC1945:HTTP/1.0, + again a basic HTTP client code
              • +
            • SAX: a SAX2 like interface and a minimal SAX1 + implementationcompatiblewith early expat versions
            -

            A partial implementation of XML Schemas Part -1: Structure is being worked on but it would be far too early to make any -conformance statement about it at the moment.

            +

            A partial implementation of XML Schemas +Part1:Structureis being worked on but it would be far too early to +makeanyconformance statement about it at the moment.

            Separate documents:

            -
            • the libxslt page providing an - implementation of XSLT 1.0 and common extensions like EXSLT for - libxml2
              • -
            • the gdome2 page - : a standard DOM2 implementation for libxml2
              • -
            • the XMLSec page: an - implementation of W3C XML - Digital Signature for libxml2
              • -
            • also check the related links section below for more related and active - projects.
              • +

              Logo designed by Marc Liyanage.

              diff --git a/doc/interface.html b/doc/interface.html index 8163c41..88ec0d8 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 } -The SAX interface
              Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
              Made with Libxml2 Logo

              The XML C parser and toolkit of Gnome

              The SAX interface

              Developer Menu
              API Indexes
              Related links

              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 callback-based interface 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.

              To get more detailed step-by-step guidance on using the SAX interface of -libxml, see the nice -documentation.written by James -Henstridge.

              You can debug the SAX behaviour by using the testSAX -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:

              SAX.setDocumentLocator()
+The SAX interface
              Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
              Made with Libxml2 Logo
              The XML C parser and toolkit of Gnome
              The SAX interface
              Developer Menu
              API Indexes
              Related links
              Sometimes the DOM tree output is just too large to fit
+reasonablyintomemory. In that case (and if you don't expect to save back the
+XMLdocumentloaded using libxml), it's better to use the SAX interface of
+libxml.SAX isa callback-based interfaceto the parser.
+Beforeparsing,the application layer registers a customized set of callbacks
+whicharecalled by the library as it progresses through the XML input.
              To get more detailed step-by-step guidance on using the SAX
+interfaceoflibxml, see the nicedocumentation.writtenby
+JamesHenstridge.
              You can debug the SAX behaviour by using
+thetestSAXprogram located in the gnome-xml module (it's
+usuallynot shipped in thebinary packages of libxml, but you can find it in
+the tarsourcedistribution). Here is the sequence of callbacks that would be
+reportedbytestSAX when parsing the example XML document shown earlier:
              SAX.setDocumentLocator()
 SAX.startDocument()
 SAX.getEntity(amp)
 SAX.startElement(EXAMPLE, prop1='gnome is great', prop2='&amp; linux too')
@@ -52,8 +51,8 @@ SAX.characters(   , 3)
 SAX.endElement(chapter)
 SAX.characters( , 1)
 SAX.endElement(EXAMPLE)
-SAX.endDocument()
              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.
              Daniel Veillard
              
+SAX.endDocument()

              Most of the other interfaces of libxml2 are based on the +DOMtree-buildingfacility, so nearly everything up to the end of this +documentpresupposes theuse of the standard DOM tree build. Note that the DOM +treeitself is built bya set of registered default callbacks, without +internalspecificinterface.

              Daniel Veillard

              diff --git a/doc/intro.html b/doc/intro.html index 650eccb..1ae322f 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 } -Introduction
              Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
              Made with Libxml2 Logo

              The XML C parser and toolkit of Gnome

              Introduction

              Main Menu
              Related links

              This document describes libxml, the XML C parser and toolkit developed for the -Gnome project. XML is a standard for building tag-based -structured documents/data.

              Here are some key points about libxml:

              Warning: unless you are forced to because your application links +withaGnome-1.X library requiring it, Do Not Use +libxml1,uselibxml2

              Daniel Veillard

              diff --git a/doc/library.html b/doc/library.html index b5faade..afe4d77 100644 --- a/doc/library.html +++ b/doc/library.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 } -The parser interfaces
              Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
              Made with Libxml2 Logo

              The XML C parser and toolkit of Gnome

              The parser interfaces

              Developer Menu
              API Indexes
              Related links

              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 look at DOM.

              The parser interfaces for XML are -separated from the HTML parser -interfaces. Let's have a look at how the XML parser can be called:

              Invoking the parser : the pull method

              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":

              xmlDocPtr xmlParseMemory(char *buffer, int size);
              +The parser interfaces
              Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
              Made with Libxml2 Logo

              The XML C parser and toolkit of Gnome

              The parser interfaces

              Developer Menu
              API Indexes
              Related links

              This section is directly intended to help programmers +gettingbootstrappedusing the XML tollkit from the C language. It is not +intended tobeextensive. I hope the automatically generated documents will +providethecompleteness required, but as a separate set of documents. The +interfacesofthe XML parser are by principle low level, Those interested in a +higherlevelAPI should look at DOM.

              The parser interfaces +forXMLareseparated from the HTMLparserinterfaces. Let's have a +look at how the XML parser can becalled:

              Invoking the parser : the pull method

              Usually, the first thing to do is to read an XML input. The +parseracceptsdocuments either from in-memory strings or from files. The +functionsaredefined in "parser.h":

              xmlDocPtr xmlParseMemory(char *buffer, int size);

              Parse a null-terminated string containing the document.

              xmlDocPtr xmlParseFile(const char *filename);
              -

              Parse an XML document contained in a (possibly compressed) - file.

              +

              Parse an XML document contained in a (possibly compressed)file.

              -

              The parser returns a pointer to the document structure (or NULL in case of -failure).

              Invoking the parser: the push method

              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:

              xmlParserCtxtPtr xmlCreatePushParserCtxt(xmlSAXHandlerPtr sax,
+
              The parser returns a pointer to the document structure (or NULL in
+caseoffailure).
              Invoking the parser: the push method
              In order for the application to keep the control when the document
+isbeingfetched (which is common for GUI based programs) libxml2 provides
+apushinterface, too, as of version 1.8.3. Here are the interfacefunctions:
              xmlParserCtxtPtr xmlCreatePushParserCtxt(xmlSAXHandlerPtr sax,
                                          void *user_data,
                                          const char *chunk,
                                          int size,
@@ -54,17 +52,17 @@ int              xmlParseChunk          (xmlParserCtxtPtr ctxt,
                     doc = ctxt->myDoc;
                     xmlFreeParserCtxt(ctxt);
                 }
-            }
              The HTML parser embedded into libxml2 also has a push interface; the
-functions are just prefixed by "html" rather than "xml".
              Invoking the parser: the SAX interface
              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
-James
-Henstridge's documentation). Note also that the push interface can be
-limited to SAX: just use the two first arguments of
-xmlCreatePushParserCtxt().
              Building a tree from scratch
              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 <libxml/tree.h>.) For example, here is a piece of
-code that produces the XML document used in the previous examples:
                  #include <libxml/tree.h>
+            }
              The HTML parser embedded into libxml2 also has a push
+interface;thefunctions are just prefixed by "html" rather than "xml".
              Invoking the parser: the SAX interface
              The tree-building interface makes the parser memory-hungry,
+firstloadingthe document in memory and then building the tree itself. Reading
+adocumentwithout building the tree is possible using the SAX interfaces
+(seeSAX.h andJamesHenstridge'sdocumentation).
+Note also that the push interface can belimited to SAX:just use the two first
+arguments ofxmlCreatePushParserCtxt().
              Building a tree from scratch
              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 <libxml/tree.h>.) For example,
+here is apiece ofcode that produces the XML document used in the previous
+examples:
                  #include <libxml/tree.h>
     xmlDocPtr doc;
     xmlNodePtr tree, subtree;
 
@@ -78,59 +76,58 @@ code that produces the XML document used in the previous examples:
                  #
     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");
              Not really rocket science ...
              Traversing the tree
              Basically by including "tree.h" your
-code has access to the internal structure of all the elements of the tree.
-The names should be somewhat simple like parent,
-children, next, prev,
-properties, etc... For example, still with the previous
-example:
              doc->children->children->children
              points to the title element,
              doc->children->children->next->children->children
              points to the text node containing the chapter title "The Linux
-adventure".
              NOTE: XML allows PIs and comments to be
-present before the document root, so doc->children may point
-to an element which is not the document Root Element; a function
-xmlDocGetRootElement() was added for this purpose.
              Modifying the tree
              Functions are provided for reading and writing the document content. Here
-is an excerpt from the tree API:
              xmlAttrPtr xmlSetProp(xmlNodePtr node, const xmlChar *name, const
-  xmlChar *value);
              
-    
              This sets (or changes) an attribute carried by an ELEMENT node.
-      The value can be NULL.
              
+    xmlSetProp(subtree, "href", "linus.gif");
              Not really rocket science ...
              Traversing the tree
              Basically by including"tree.h"yourcode
+has access to the internal structure of all the elementsof the tree.The names
+should be somewhat simple
+likeparent,children,
+next,prev,properties,
+etc... For example, stillwith the previousexample:
              doc->children->children->children
              points to the title element,
              doc->children->children->next->children->children
              points to the text node containing the chapter title
+"TheLinuxadventure".
              NOTE: XML allows PIs and
+commentstobepresent before the document root, so
+doc->childrenmaypointto an element which is not the document
+Root Element; afunctionxmlDocGetRootElement()was added for this
+purpose.
              Modifying the tree
              Functions are provided for reading and writing the document content.Hereis
+an excerpt from the tree API:
              xmlAttrPtr xmlSetProp(xmlNodePtr node, const xmlChar
+  *name,constxmlChar *value);
              
+    
              This sets (or changes) an attribute carried by an ELEMENT
+      node.Thevalue can be NULL.
              
     
              
-
              const xmlChar *xmlGetProp(xmlNodePtr node, const xmlChar
-  *name);
              
-    
              This function returns a pointer to new copy of the property
-      content. Note that the user must deallocate the result.
              
+
              const xmlChar *xmlGetProp(xmlNodePtr node,
+  constxmlChar*name);
              
+    
              This function returns a pointer to new copy of thepropertycontent.
+      Note that the user must deallocate the result.
              
     
              
-
              Two functions are provided for reading and writing the text associated
-with elements:
              xmlNodePtr xmlStringGetNodeList(xmlDocPtr doc, const xmlChar
-  *value);
              
-    
              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 &Gnome; will be stored
-      internally as entity nodes, hence the result of the function may not be
-      a single node.
              
+
              Two functions are provided for reading and writing the text
+associatedwithelements:
              xmlNodePtr xmlStringGetNodeList(xmlDocPtr doc,
+  constxmlChar*value);
              
+    
              This function takes an "external" string and converts it toonetext
+      node or possibly to a list of entity and text nodes.Allnon-predefined
+      entity references like &Gnome; will bestoredinternally as entity
+      nodes, hence the result of the function maynot bea single node.
              
     
              
-
              xmlChar *xmlNodeListGetString(xmlDocPtr doc, xmlNodePtr list, int
-  inLine);
              
-    
              This function is the inverse of
-      xmlStringGetNodeList(). 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 &Gnome;
-      XML encoding in the string, it will substitute it with its value (say,
-      "GNU Network Object Model Environment").
              
+
              xmlChar *xmlNodeListGetString(xmlDocPtr doc, xmlNodePtr
+  list,intinLine);
              
+    
              This function is the inverseofxmlStringGetNodeList().
+      It generates a newstringcontaining the content of the text and entity
+      nodes. Note theextraargument inLine. If this argument is set to 1, the
+      function willexpandentity references.  For example, instead of
+      returning the&Gnome;XML encoding in the string, it will substitute
+      it with itsvalue (say,"GNU Network Object Model Environment").
              
     
              
-
              Saving a tree
              Basically 3 options are possible:
              void xmlDocDumpMemory(xmlDocPtr cur, xmlChar**mem, int
-  *size);
              
+
              Saving a tree
              Basically 3 options are possible:
              void xmlDocDumpMemory(xmlDocPtr cur,
+  xmlChar**mem,int*size);
              
     
              Returns a buffer into which the document has been saved.
              
     
              
 
              extern void xmlDocDump(FILE *f, xmlDocPtr doc);
              
     
              Dumps a document to an open file descriptor.
              
     
              
 
              int xmlSaveFile(const char *filename, xmlDocPtr cur);
              
-    
              Saves the document to a file. In this case, the compression
-      interface is triggered if it has been turned on.
              
+    
              Saves the document to a file. In this case,
+      thecompressioninterface is triggered if it has been turned on.
              
     
              
-
              Compression
              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:
              int  xmlGetDocCompressMode (xmlDocPtr doc);
              
+
              Compression
              The library transparently handles compression when
+doingfile-basedaccesses. The level of compression on saves can be turned on
+eithergloballyor individually for one file:
              int  xmlGetDocCompressMode (xmlDocPtr doc);
              
     
              Gets the document compression ratio (0-9).
              
     
              
 
              void xmlSetDocCompressMode (xmlDocPtr doc, int mode);
              
diff --git a/doc/libxml2-api.xml b/doc/libxml2-api.xml
index 1affb28..2dbf900 100644
--- a/doc/libxml2-api.xml
+++ b/doc/libxml2-api.xml
@@ -2270,6 +2270,7 @@
      
      
      
+     
      
      
      
@@ -3498,6 +3499,7 @@
      
      
      
+     
      
      
      
@@ -5521,6 +5523,7 @@
     
     
     
+    
     
     
     
@@ -6686,7 +6689,8 @@ Could we use @subtypes for this?'/>
       
       
       
-      
+      
+      
     
     
     
@@ -16980,6 +16984,15 @@ Could we use @subtypes for this?'/>
       
       
     
+    
+      defined(LIBXML_XPATH_ENABLED)
+      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 <0 for the default number (100). Other values for @options have currently no effect.
+      
+      
+      
+      
+      
+    
     
       defined(LIBXML_XPATH_ENABLED)
       Converts an existing object to its boolean() equivalent
diff --git a/doc/libxml2.xsa b/doc/libxml2.xsa
index 65374b2..0cfdca5 100644
--- a/doc/libxml2.xsa
+++ b/doc/libxml2.xsa
@@ -8,52 +8,9 @@
   
   
     libxml2
-    2.6.23
-     Jan 5 2006
+    2.6.25
+     Jun 6 2006:
     http://xmlsoft.org/
-       - 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 & 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 <xml:foo/>, 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->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),
-
-
+    Do not use or package 2.6.25
   
 
diff --git a/doc/namespaces.html b/doc/namespaces.html
index 32c7787..a4d6ace 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 }
-Namespaces
              Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
              Made with Libxml2 Logo
              The XML C parser and toolkit of Gnome
              Namespaces
              Main Menu
              Related links
              The libxml2 library implements XML namespaces 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.
              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:
              <mydoc xmlns="http://mydoc.example.org/schemas/">
+Namespaces
              Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
              Made with Libxml2 Logo
              The XML C parser and toolkit of Gnome
              Namespaces
              Main Menu
              Related links
              The libxml2 library implements XML
+namespacessupportbyrecognizing namespace constructs in the input, and
+does namespacelookupautomatically when building the DOM tree. A namespace
+declarationisassociated with an in-memory structure and all elements or
+attributeswithinthat namespace point to it. Hence testing the namespace is a
+simple andfastequality operation at the user level.
              I suggest that people using libxml2 use a namespace, and declare it
+intheroot element of their document as the default namespace. Then they
+don'tneedto use the prefix in the content but we will have a basis for
+futuresemanticrefinement and  merging of data from different sources. This
+doesn'tincreasethe size of the XML output significantly, but significantly
+increasesitsvalue in the long-term. Example:
              <mydoc xmlns="http://mydoc.example.org/schemas/">
    <elem1>...</elem1>
    <elem2>...</elem2>
-</mydoc>
              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, "http://www.gnome.org/gnumeric/1.0/" is a
-good namespace scheme.
              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. <foo:text> may be exactly the
-same as <bar:text> 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
-ns field pointing to an xmlNs structure detailing the namespace
-prefix and its URI.
              @@Interfaces@@
              xmlNodePtr node;
+</mydoc>
              The namespace value has to be an absolute URL, but the URL doesn't
+havetopoint to any existing resource on the Web. It will bind all the
+elementandattributes with that URL. I suggest to use an URL within a
+domainyoucontrol, and that the URL should contain some kind of version
+informationifpossible. For example,
+"http://www.gnome.org/gnumeric/1.0/"isagood namespace scheme.
              Then when you load a file, make sure that a namespace
+carryingtheversion-independent prefix is installed on the root element of
+yourdocument,and if the version information don't match something you know,
+warnthe userand be liberal in what you accept as the input. Also do *not* try
+tobasenamespace checking on the prefix value. <foo:text> may be
+exactlythesame as <bar:text> in another document. What really matters
+is theURIassociated with the element or the attribute, not the prefix string
+(whichisjust a shortcut for the full URI). In libxml, element and attributes
+haveannsfield pointing to an xmlNs structure detailing
+thenamespaceprefix and its URI.
              @@Interfaces@@
              xmlNodePtr node;
 if(!strncmp(node->name,"mytag",5)
   && node->ns
   && !strcmp(node->ns->href,"http://www.mysite.com/myns/1.0")) {
   ...
-}
              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
-xmlns="http://...." 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 relagx-ng and w3c-schema.
              Daniel Veillard
              
+}
              Usually people object to using namespaces together with validitychecking.I
+will try to make sure that using namespaces won't break validitychecking,so
+even if you plan to use or currently are using validation Istronglysuggest
+adding namespaces to your document. A default
+namespaceschemexmlns="http://...."should not break validity even
+onlessflexible parsers. Using namespaces to mix and differentiate
+contentcomingfrom multiple DTDs will certainly break current validation
+schemes. Tochecksuch documents one needs to use schema-validation, which is
+supportedinlibxml2 as well. See relagx-ngand w3c-schema.
              Daniel Veillard
              
diff --git a/doc/news.html b/doc/news.html
index a75db52..b67feaa 100644
--- a/doc/news.html
+++ b/doc/news.html
@@ -7,470 +7,489 @@ 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 }
-Releases
              Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
              Made with Libxml2 Logo
              The XML C parser and toolkit of Gnome
              Releases
              Main Menu
              Related links
              Items not finished and worked on, get in touch with the list if you want
-to help those
              The change log describes the recents commits
-to the CVS code base.
              There is the list of public releases:
              2.6.24: Apr 28 2006
              • 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).
-      
                • 
-  
              • Improvements: xmlDOMWrapReconcileNamespaces xmlDOMWrapCloneNode (Kasimier
-      Buchcik), 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 streaming
-      bug, xmlParseComment (with William Brack), regexp bug fixes (DV &
-      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). 
                • 
+Releases
                Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
                Made with Libxml2 Logo
                The XML C parser and toolkit of Gnome
                Releases
                Main Menu
                Related links
                Items not finished and worked on, get in touch with the list if you
+wanttohelp those
                • More testing on RelaxNG
                  • 
+  
                • Finishing up XMLSchemas
                  • 
+
                The change logdescribes the recents
+commitstothe CVScode
+base.
                There is the list of public releases:
                2.6.26: Jun 6 2006
                • portability fixes: Python detection (Joseph Sacco), compilation
+    error(William Brack and Graham Bennett), LynxOS patch (Olli Savia)
                  • 
+  
                • bug fixes: encoding buffer problem, mix of code and data in
+    xmlIO.c(Kjartan Maraas), entities in XSD validation (Kasimier Buchcik),
+    variousXSD validation fixes (Kasimier), memory leak in pattern (Rob
+    Richards andKasimier), attribute with colon in name (Rob Richards), XPath
+    leak inerror reporting (Aleksey Sanin), XInclude text include of
+    selfdocument.
                  • 
+  
                • improvements: Xpath optimizations (Kasimier), XPath object
+    cache(Kasimier)
                  • 
+
                2.6.25: Jun 6 2006:
                Do not use or package 2.6.25
                2.6.24: Apr 28 2006
                • Portability fixes: configure on Windows, testapi compile
+    onwindows(Kasimier Buchcik, venkat naidu), Borland C++ 6 compile
+    (EricZurcher),HP-UX compiler workaround (Rick Jones), xml2-config
+    bugfix,gcc-4.1cleanups, Python detection scheme (Joseph Sacco), UTF-8
+    file pathsonWindows (Roland Schwingel).
                  • 
+  
                • Improvements: xmlDOMWrapReconcileNamespaces
+    xmlDOMWrapCloneNode(KasimierBuchcik), XML catalog debugging (Rick Jones),
+    update to Unicode4.01.
                  • 
+  
                • Bug fixes: xmlParseChunk() problem in 2.6.23,
+    xmlParseInNodeContext()onHTML docs, URI behaviour on Windows (Rob
+    Richards), comment streamingbug,xmlParseComment (with William Brack),
+    regexp bug fixes (DV &YouriGolovanov), xmlGetNodePath on text/CDATA
+    (Kasimier),one Relax-NGinterleave 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 (RobRichards), a largenumber of cleanups and small fixes based on
+    Coverityreports, bugin character ranges, Unicode tables const (Aivars
+    Kalvans),schemasfix (Stefan Kost), xmlRelaxNGParse
+    errordeallocation,xmlSchemaAddSchemaDoc error deallocation, error
+    handling onunallowedcode point, ixmllint --nonet to never reach the net
+    (GaryCoady),line break in writer after end PI (Jason Viers).
                  • 
   
                • Documentation: man pages updates and cleanups (Daniel Leidert).
                  • 
   
                • New features: Relax NG structure error handlers.
                  • 
-
                2.6.23: Jan 5 2006
                • 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 & 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 <xml:foo/>, 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->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),
                  • 
+
                2.6.23: Jan 5 2006
                • portability fixes: Windows (Rob Richards), getaddrinfo on
+    Windows(KoljaNowak, Rob Richards), icc warnings (Kjartan
+    Maraas),--with-minimumcompilation fixes (William Brack), error case
+    handling fixon Solaris(Albert Chin), don't use 'list' as parameter name
+    reported bySamuel DiazGarcia, more old Unices portability fixes (Albert
+    Chin),MinGW compilation(Mark Junker), HP-UX compiler warnings
+  (RickJones),
                  • 
+  
                • code cleanup: xmlReportError (Adrian Mouat), removexmlBufferClose(Geert
+    Jansen), unreachable code (Oleksandr Kononenko),refactoringparsing code
+    (Bjorn Reese)
                  • 
+  
                • bug fixes: xmlBuildRelativeURI and empty path
+    (WilliamBrack),combinatory explosion and performances in regexp code,
+    leakinxmlTextReaderReadString(), xmlStringLenDecodeEntities
+    problem(MassimoMorara), Identity Constraints bugs and a segfault
+    (KasimierBuchcik),XPath pattern based evaluation bugs (DV
+    &Kasimier),xmlSchemaContentModelDump() memory leak (Kasimier),
+    potentialleak inxmlSchemaCheckCSelectorXPath(), xmlTextWriterVSprintf()
+    misuseofvsnprintf (William Brack), XHTML serialization fix (Rob
+    Richards),CRLFsplit problem (William), issues with non-namespaced
+    attributesinxmlAddChild() xmlAddNextSibling() and xmlAddPrevSibling()
+    (RobRichards),HTML parsing of script, Python must not output to stdout
+    (NicFerrier),exclusive C14N namespace visibility (Aleksey Sanin),
+    XSDdataypetotalDigits bug (Kasimier Buchcik), error handling when writing
+    toanxmlBuffer (Rob Richards), runtest schemas error not
+    reported(HisashiFujinaka), signed/unsigned problem in date/time code
+    (AlbertChin), fixXSI driven XSD validation (Kasimier), parsing of
+    xs:decimal(Kasimier),fix DTD writer output (Rob Richards), leak
+    inxmlTextReaderReadInnerXml(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), bugwith <xml:foo/>, more XPathpattern based evaluation
+    fixes(Kasimier)
                  • 
+  
                • improvements: XSD Schemas redefinitions/restrictions
+    (KasimierBuchcik),node copy checks and fix for attribute (Rob Richards),
+    countedtransitionbug in regexps, ctxt->standalone = -2 to indicate
+    nostandaloneattribute was found, add
+    xmlSchemaSetParserStructuredErrors()(KasimierBuchcik), add
+    xmlTextReaderSchemaValidateCtxt() to API(Kasimier), handlegzipped HTTP
+    resources (Gary Coady), addhtmlDocDumpMemoryFormat. (RobRichards),
                  • 
+  
                • documentation: typo (Michael Day), libxml man page (Albert
+    Chin),savefunction to XML buffer (Geert Jansen), small doc fix
+    (AronStansvik),
                  • 
 
                2.6.22: Sep 12 2005
                • build fixes: compile without schematron (Stéphane Bidoul)
                  • 
-  
                • 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)
                  • 
-  
                • improvements: add XML_SAVE_NO_EMPTY xmlSaveOption (Rob Richards), add
-    XML_SAVE_NO_XHTML xmlSaveOption, XML Schemas improvements preparing for
-    derive (Kasimier Buchcik).
                  • 
-  
                • documentation: generation of gtk-doc like docs, integration with
-    devhelp.
                  • 
-
                2.6.21: Sep 4 2005
                • 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,
                  • 
-  
                • 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.
                  • 
-  
                • 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.
                  • 
+  
                • bug fixes: xmlDebugDumpNode on namespace node (Oleg
+    Paraschenko)i,CDATApush parser bug, xmlElemDump problem with XHTML1
+    doc,XML_FEATURE_xxxclash with expat headers renamed XML_WITH_xxx, fix
+    someoutput formattingfor meta element (Rob Richards), script and
+    styleXHTML1 serialization(David Madore), Attribute derivation fixups in
+    XSD(Kasimier Buchcik),better IDC error reports (Kasimier Buchcik)
                  • 
+  
                • improvements: add XML_SAVE_NO_EMPTY xmlSaveOption (Rob
+    Richards),addXML_SAVE_NO_XHTML xmlSaveOption, XML Schemas improvements
+    preparingforderive (Kasimier Buchcik).
                  • 
+  
                • documentation: generation of gtk-doc like docs,
+  integrationwithdevhelp.
                  • 
+
                2.6.21: Sep 4 2005
                • build fixes: Cygwin portability fixes (Gerrit P.
+    Haase),callingconvention problems on Windows (Marcus Boerger), cleanups
+    based onLinus'sparse tool, update of win32/configure.js (Rob Richards),
+    removewarningson Windows(Marcus Boerger), compilation without SAX1,
+    detectionof thePython binary, use $GCC inestad of $CC = 'gcc' (Andrew
+    W.Nosenko),compilation/link with threads and old gcc, compile problem
+    byC370 onZ/OS,
                  • 
+  
                • bug fixes: http_proxy environments (Peter Breitenlohner), HTML
+    UTF-8bug(Jiri Netolicky), XPath NaN compare bug (William
+    Brack),htmlParseScriptpotential bug, Schemas regexp handling of spaces,
+    Base64Schemascomparisons NIST passes, automata build error
+    xsd:all,xmlGetNodePath fornamespaced attributes (Alexander Pohoyda),
+    xmlSchemasforeign namespaceshandling, XML Schemas facet comparison
+    (KupriyanovAnatolij),xmlSchemaPSimpleTypeErr error report (Kasimier
+    Buchcik), xml:namespaceahndling in Schemas (Kasimier), empty model group
+    in Schemas(Kasimier),wilcard in Schemas (Kasimier), URI composition
+    (William),xs:anyType inSchemas (Kasimier), Python resolver emmitting
+    errormessages directly,Python xmlAttr.parent (Jakub Piotr Clapa), trying
+    tofix the file path/URIconversion, xmlTextReaderGetAttribute fix
+    (RobRichards),xmlSchemaFreeAnnot memleak (Kasimier), HTML
+    UTF-8serialization, streamingXPath, Schemas determinism detection
+    problem,XInclude bug, Schemascontext type (Dean Hill), validation fix
+    (DerekPoon),xmlTextReaderGetAttribute[Ns] namespaces (Rob Richards),
+    Schemastype fix(Kuba Nowakowski), UTF-8 parser bug, error in
+    encodinghandling,xmlGetLineNo fixes, bug on entities handling, entity
+    nameextraction inerror handling with XInclude, text nodes in HTML body
+    tags(Gary Coady),xml:id and IDness at the treee level fixes, XPath
+    streamingpatternsbugs.
                  • 
+  
                • improvements: structured interfaces for schemas and RNG
+    errorreports(Marcus Boerger), optimization of the char data inner
+    loopparsing(thanks to Behdad Esfahbod for the idea), schematron
+    validationthoughnot finished yet, xmlSaveOption to omit XML declaration,
+    keyrefmatcherror reports (Kasimier), formal expression handling code
+    notpluggedyet, more lax mode for the HTML parser, parser
+    XML_PARSE_COMPACToptionfor text nodes allocation.
                  • 
   
                • documentation: xmllint man page had --nonet duplicated
                  • 
-
                2.6.20: Jul 10 2005
                • 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.
                  • 
-  
                • 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).
                  • 
-  
                • 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.
                  • 
-
                2.6.19: Apr 02 2005
                • 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
                  • 
-  
                • 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
                  • 
-  
                • improvements: lot of work on Schemas by Kasimier Buchcik on facets
-    checking and also mixed handling.
                  • 
+
                2.6.20: Jul 10 2005
                • build fixes: Windows build (Rob Richards), Mingw
+    compilation(IgorZlatkovic), Windows Makefile (Igor), gcc warnings
+    (Kasimierandandriy@google.com), use gcc weak references to pthread to
+    avoidthepthread dependancy on Linux, compilation problem (Steve
+    Nairn),compilingof subset (Morten Welinder), IPv6/ss_family compilation
+    (WilliamBrack),compilation when disabling parts of the library,
+    standalonetestdistribution.
                  • 
+  
                • bug fixes: bug in lang(), memory cleanup on errors (William
+    Brack),HTTPquery strings (Aron Stansvik), memory leak in DTD
+    (William),integeroverflow in XPath (William), nanoftp buffer size,
+    pattern "." apthfixup(Kasimier), leak in tree reported by Malcolm Rowe,
+    replaceNodepatch(Brent Hendricks), CDATA with NULL content (Mark Vakoc),
+    xml:basefixupon XInclude (William), pattern fixes (William), attribute
+    buginexclusive c14n (Aleksey Sanin), xml:space and xml:lang with
+    SAX2(RobRichards), namespace trouble in complex parsing (Malcolm Rowe),
+    XSDtypeQNames fixes (Kasimier), XPath streaming fixups (William),
+    RelaxNGbug(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
+    CDATAsections,areBlanks() heuristic failure, duplicate attributes in
+    DTDbug(William).
                  • 
+  
                • improvements: lot of work on Schemas by Kasimier Buchcik
+    bothonconformance and streaming, Schemas validation messages
+    (KasimierBuchcik,Matthew Burgess), namespace removal at the python
+    level(BrentHendricks), Update to new Schemas regression tests
+    fromW3C/Nist(Kasimier), xmlSchemaValidateFile() (Kasimier),
+    implementationofxmlTextReaderReadInnerXml and xmlTextReaderReadOuterXml
+    (JamesWert),standalone test framework and programs, new DOM
+    importAPIsxmlDOMWrapReconcileNamespaces()
+    xmlDOMWrapAdoptNode()andxmlDOMWrapRemoveNode(), extension of xmllint
+    capabilities for SAXandSchemas regression tests, xmlStopParser()
+    available in pull modetoo,ienhancement to xmllint --shell namespaces
+    support, Windows port ofthestandalone testing tools (Kasimier
+    andWilliam),xmlSchemaValidateStream() xmlSchemaSAXPlug()
+    andxmlSchemaSAXUnplug() SAXSchemas APIs, Schemas xmlReader support.
                  • 
+
                2.6.19: Apr 02 2005
                • build fixes: drop .la from RPMs, --with-minimum build
+    fix(WilliamBrack), use XML_SOCKLEN_T instead of SOCKLEN_T because it
+    breakswith AIX5.3 compiler, fixed elfgcchack.h generation and PLT
+    reductioncode onLinux/ELF/gcc4
                  • 
+  
                • bug fixes: schemas type decimal fixups (William Brack),
+    xmmlintreturncode (Gerry Murphy), small schemas fixes (Matthew Burgess
+    andGUYFabrice), workaround "DAV:" namespace brokeness in c14n
+    (AlekseySanin),segfault in Schemas (Kasimier Buchcik), Schemas
+    attributevalidation(Kasimier), Prop related functions and
+    xmlNewNodeEatName (RobRichards),HTML serialization of name attribute on a
+    elements, Pythonerror handlersleaks and improvement (Brent Hendricks),
+    uninitializedvariable inencoding code, Relax-NG validation bug, potential
+    crashifgnorableWhitespace is NULL, xmlSAXParseDoc and
+    xmlParseDocsignatures,switched back to assuming UTF-8 in case no encoding
+    is givenatserialization time
                  • 
+  
                • improvements: lot of work on Schemas by Kasimier Buchcik
+    onfacetschecking and also mixed handling.
                  • 
   
                • 
-
                2.6.18: Mar 13 2005
                • 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).
                  • 
-  
                • 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).
                  • 
-  
                • 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),
                  • 
+
                2.6.18: Mar 13 2005
                • build fixes: warnings (Peter Breitenlohner),
+    testapi.cgeneration,Bakefile support (Francesco Montorsi), Windows
+    compilation(Joel Reed),some gcc4 fixes, HP-UX portability fixes (Rick
+    Jones).
                  • 
+  
                • bug fixes: xmlSchemaElementDump namespace (Kasimier Buchcik),
+    pushandxmlreader stopping on non-fatal errors, thread support
+    fordictionnariesreference counting (Gary Coady), internal subset and
+    pushproblem, 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 (WilliamBrack),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 ons390, xmlTextReaderNext bug(Rob Richards), Schemas decimal type
+    fixes(William Brack),xmlByteConsumed static buffer (Ben Maurer).
                  • 
+  
                • improvement: speedup parsing comments and DTDs, dictionnary
+    supportforhash tables, Schemas Identity constraints (Kasimier),
+    streamingXPathsubset, xmlTextReaderReadString added (Bjorn Reese),
+    Schemascanonicalvalues handling (Kasimier), add
+    xmlTextReaderByteConsumed(AronStansvik),
                  • 
   
                • Documentation: Wiki support (Joel Reed)
                  • 
-
                2.6.17: Jan 16 2005
                • 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)
                  • 
-  
                • 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.
                  • 
-  
                • improvements: XSD Schemas (Kasimier Buchcik), python generator
-    (William), xmlUTF8Strpos speedup (William), unicode Python strings
-    (William), XSD error reports (Kasimier Buchcik), Python __str__ call
-    serialize().
                  • 
-  
                • 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)
                  • 
-  
                • documentation: site improvement (John Fleck), FAQ entries
-  (William).
                  • 
-
                2.6.16: Nov 10 2004
                • general hardening and bug fixing crossing all the API based on new
-    automated regression testing
                  • 
+
                2.6.17: Jan 16 2005
                • build fixes: Windows, warnings removal (William
+    Brack),maintainer-cleandependency(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)
                  • 
+  
                • bug fixes: xmlTextReaderHasAttributes (Rob
+    Richards),xmlCtxtReadFile()to use the catalog(s), loop on output (William
+    Brack),XPath memory leak,ID deallocation problem (Steve Shepard),
+    debugDumpNodecrash (William),warning not using error callback (William),
+    xmlStopParserbug (William),UTF-16 with BOM on DTDs (William), namespace
+    bug on emptyelements 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.
                  • 
+  
                • improvements: XSD Schemas (Kasimier Buchcik), pythongenerator(William),
+    xmlUTF8Strpos speedup (William), unicode Pythonstrings(William), XSD
+    error reports (Kasimier Buchcik), Python __str__callserialize().
                  • 
+  
                • new APIs: added xmlDictExists(), GetLineNumber and
+    GetColumnNumberforthe xmlReader (Aleksey Sanin), Dynamic Shared Libraries
+    APIs (mostlyJoelReed), error extraction API from regexps, new XMLSave
+    option forformat(Phil Shafer)
                  • 
+  
                • documentation: site improvement (John Fleck), FAQ entries(William).
                  • 
+
                2.6.16: Nov 10 2004
                • general hardening and bug fixing crossing all the API based
+    onnewautomated regression testing
                  • 
   
                • build fix: IPv6 build and test on AIX (Dodji Seketeli)
                  • 
-  
                • 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)
                  • 
-  
                • documentation: fix to xmllint man page, some API function descritpion
-    were updated.
                  • 
-  
                • improvements: DTD validation APIs provided at the Python level (Brent
-    Hendricks)
                  • 
+  
                • bug fixes: problem with XML::Libxml reported by Petr
+    Pajas,encodingconversion functions return values, UTF-8 bug affecting
+    XPathreported byMarkus Bertheau, catalog problem with NULL entries
+    (WilliamBrack)
                  • 
+  
                • documentation: fix to xmllint man page, some API
+    functiondescritpionwere updated.
                  • 
+  
                • improvements: DTD validation APIs provided at the Python
+    level(BrentHendricks)
                  • 
 
                2.6.15: Oct 27 2004
                • security fixes on the nanoftp and nanohttp modules
                  • 
-  
                • build fixes: xmllint detection bug in configure, building outside the
-    source tree (Thomas Fitzsimmons)
                  • 
-  
                • 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 <group> 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).
                  • 
-  
                • 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.
                  • 
-
                2.6.14: Sep 29 2004
                • build fixes: configure paths for xmllint and xsltproc, compilation
-    without HTML parser, compilation warning cleanups (William Brack &
-    Malcolm Tredinnick), VMS makefile update (Craig Berry),
                  • 
-  
                • 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),
                  • 
-  
                • 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)
                  • 
-
                2.6.13: Aug 31 2004
                • build fixes: Windows and zlib (Igor Zlatkovic), -O flag with gcc,
-    Solaris compiler warning, fixing RPM BuildRequires,
                  • 
-  
                • 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.
                  • 
-  
                • Improvements: Schemas validity improvements (Kasimier), added --path
-    and --load-trace options to xmllint
                  • 
+  
                • build fixes: xmllint detection bug in configure, building
+    outsidethesource tree (Thomas Fitzsimmons)
                  • 
+  
                • 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 lookupfix(Malcolm), save back <group> in catalogs (William),
+    treebuildfixes (DV and Rob Richards), Schemas memory bug, structured
+    errorhandleron Python 64bits, thread local memory deallocation, memory
+    leakreportedby Volker Roth, xmlValidateDtd in the presence of an
+    internalsubset,entities and _private problem (William),
+    xmlBuildRelativeURIerror(William).
                  • 
+  
                • improvements: better XInclude error reports (William),
+    treedebuggingmodule and tests, convenience functions at the Reader
+    API(GrahamBennett), add support for PI in the HTML parser.
                  • 
+
                2.6.14: Sep 29 2004
                • build fixes: configure paths for xmllint and
+    xsltproc,compilationwithout HTML parser, compilation warning cleanups
+    (WilliamBrack &Malcolm Tredinnick), VMS makefile update (Craig
+  Berry),
                  • 
+  
                • bug fixes: xmlGetUTF8Char (William Brack), QName
+    properties(KasimierBuchcik), XInclude testing, Notation
+    serialization,UTF8ToISO8859xtranscoding (Mark Itzcovitz), lots of XML
+    Schemas cleanupand fixes(Kasimier), ChangeLog cleanup (Stepan Kasal),
+    memory fixes (MarkVakoc),handling of failed realloc(), out of bound array
+    adressing inSchemasdate handling, Python space/tabs cleanups (Malcolm
+    Tredinnick),NMTOKENSE20 validation fix (Malcolm),
                  • 
+  
                • improvements: added W3C XML Schemas testsuite (Kasimier
+    Buchcik),addxmlSchemaValidateOneElement (Kasimier), Python
+    exceptionhierearchy(Malcolm Tredinnick), Python libxml2 driver
+    improvement(MalcolmTredinnick), Schemas support
+    forxsi:schemaLocation,xsi:noNamespaceSchemaLocation, xsi:type
+    (KasimierBuchcik)
                  • 
+
                2.6.13: Aug 31 2004
                • build fixes: Windows and zlib (Igor Zlatkovic), -O flag withgcc,Solaris
+    compiler warning, fixing RPM BuildRequires,
                  • 
+  
                • fixes: DTD loading on Windows (Igor), Schemas error
+    reportsAPIs(Kasimier Buchcik), Schemas validation crash, xmlCheckUTF8
+    (WilliamBrackand Julius Mittenzwei), Schemas facet check (Kasimier),
+    defaultnamespaceproblem (William), Schemas hexbinary empty values,
+    encodingerror couldgenrate a serialization loop.
                  • 
+  
                • Improvements: Schemas validity improvements (Kasimier), added
+    --pathand--load-trace options to xmllint
                  • 
   
                • documentation: tutorial update (John Fleck)
                  • 
-
                2.6.12: Aug 22 2004
                • build fixes: fix --with-minimum, elfgcchack.h fixes (Peter
-    Breitenlohner), perl path lookup (William), diff on Solaris (Albert
-    Chin), some 64bits cleanups.
                  • 
-  
                • 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)
                  • 
+
                2.6.12: Aug 22 2004
                • build fixes: fix --with-minimum, elfgcchack.h
+    fixes(PeterBreitenlohner), perl path lookup (William), diff on
+    Solaris(AlbertChin), some 64bits cleanups.
                  • 
+  
                • Python: avoid a warning with 2.3 (William Brack), tab and
+    spacemixes(William), wrapper generator fixes (William), Cygwin support
+    (GerritP.Haase), node wrapper fix (Marc-Antoine Parent), XML
+    Schemassupport(Torkel Lyng)
                  • 
   
                • Schemas: a lot of bug fixes and improvements from Kasimier Buchcik
                  • 
-  
                • 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)
                  • 
-  
                • 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)
                  • 
-  
                • documentation: web pages fixes, validity API docs fixes (William)
-    schemas API fix (Eric Haszlakiewicz), xmllint man page (John Fleck)
                  • 
-
                2.6.11: July 5 2004
                • Schemas: a lot of changes and improvements by Kasimier Buchcik for
-    attributes, namespaces and simple types.
                  • 
-  
                • build fixes: --with-minimum (William Brack),  some gcc cleanup
-    (William), --with-thread-alloc (William)
                  • 
-  
                • portability: Windows binary package change (Igor Zlatkovic), Catalog
-    path on Windows
                  • 
-  
                • documentation: update to the tutorial (John Fleck), xmllint return code
-    (John Fleck), man pages (Ville Skytta),
                  • 
-  
                • 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.
                  • 
-  
                • 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)
                  • 
-  
                • 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.
                  • 
+  
                • fixes: RVT fixes (William), XPath context resets bug
+    (William),memorydebug (Steve Hay), catalog white space handling
+    (PeterBreitenlohner),xmlReader state after attribute reading
+    (William),structured errorhandler (William), XInclude generated xml:base
+    fixup(William), Windowsmemory reallocation problem (Steve Hay), Out of
+    Memoryconditionshandling (William and Olivier Andrieu), htmlNewDoc()
+    charsetbug,htmlReadMemory init (William), a posteriori validation
+    DTDbase(William), notations serialization missing,
+    xmlGetNodePath(Dodji),xmlCheckUTF8 (Diego Tartara), missing line numbers
+    onentity(William)
                  • 
+  
                • improvements: DocBook catalog build scrip (William),
+    xmlcatalogtool(Albert Chin), xmllint --c14n option, no_proxy environment
+    (MikeHommey),xmlParseInNodeContext() addition, extend xmllint --shell,
+    allowXIncludeto not generate start/end nodes, extend xmllint --version
+    toinclude CVStag (William)
                  • 
+  
                • documentation: web pages fixes, validity API docs fixes(William)schemas
+    API fix (Eric Haszlakiewicz), xmllint man page (JohnFleck)
                  • 
+
                2.6.11: July 5 2004
                • Schemas: a lot of changes and improvements by Kasimier
+    Buchcikforattributes, namespaces and simple types.
                  • 
+  
                • build fixes: --with-minimum (William Brack),  some gcccleanup(William),
+    --with-thread-alloc (William)
                  • 
+  
                • portability: Windows binary package change (Igor Zlatkovic),Catalogpath
+    on Windows
                  • 
+  
                • documentation: update to the tutorial (John Fleck), xmllint
+    returncode(John Fleck), man pages (Ville Skytta),
                  • 
+  
                • bug fixes: C14N bug serializing namespaces (Aleksey
+    Sanin),testSAXproperly initialize the library (William), empty node set
+    inXPath(William), xmlSchemas errors (William), invalid charref
+    problempointedby Morus Walter, XInclude xml:base generation (William),
+    Relax-NGbugwith div processing (William), XPointer and
+    xml:baseproblem(William),Reader and entities, xmllint return code for
+    schemas(William), readerstreaming problem (Steve Ball), DTD
+    serializationproblem (William),libxml.m4 fixes (Mike Hommey), do not
+    providedestructors as methods onPython classes, xmlReader buffer bug,
+    Pythonbindings memory interfacesimprovement (with Stéphane Bidoul), Fixed
+    thepush parser to be back tosynchronous behaviour.
                  • 
+  
                • improvement: custom per-thread I/O enhancement (Rob
+    Richards),registernamespace in debug shell (Stefano Debenedetti), Python
+    basedregressiontest for non-Unix users (William), dynamically increase
+    thenumber ofXPath extension functions in Python and fix a memory
+    leak(Marc-AntoineParent and William)
                  • 
+  
                • performance: hack done with Arjan van de Ven to reduce ELF
+    footprintandgenerated code on Linux, plus use gcc runtime profiling to
+    optimizethecode generated in the RPM packages.
                  • 
 
                2.6.10: May 17 2004
                • Web page generated for ChangeLog
                  • 
   
                • build fixes: --without-html problems, make check without make all
                  • 
-  
                • 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),
                  • 
-  
                • 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
                  • 
-  
                • 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 '"'
                  • 
+  
                • portability: problem with xpath.c on Windows (MSC and
+    Borland),memcmpvs. strncmp on Solaris, XPath tests on Windows (Mark
+    Vakoc), C++ donotuse "list" as parameter name, make tests work with
+    Python 1.5(EdDavis),
                  • 
+  
                • improvements: made xmlTextReaderMode public, small
+    buffersresizing(Morten Welinder), add --maxmem option to
+    xmllint,addxmlPopInputCallback() for Matt Sergeant, refactoring
+    ofserializationescaping, added escaping customization
                  • 
+  
                • bugfixes: xsd:extension (Taihei Goi), assorted regexp
+    bugs(WilliamBrack), xmlReader end of stream problem, node deregistration
+    withreader,URI escaping and filemanes,  XHTML1 formatting (Nick
+    Wellnhofer),regexptransition reduction (William), various XSD Schemas
+    fixes(KasimierBuchcik), XInclude fallback problem (William), weird
+    problemswith DTD(William), structured error handler callback context
+    (William),reversexmlEncodeSpecialChars() behaviour back to escaping
+  '"'
                  • 
 
                2.6.9: Apr 18 2004
                • implement xml:id Working Draft, relaxed XPath id() checking
                  • 
-  
                • 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
                  • 
-  
                • 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
                  • 
-  
                • documentation: examples and xmlDocDumpMemory docs (John Fleck), new
-    example (load, xpath, modify, save), xmlCatalogDump() comments,
                  • 
-  
                • Windows: Borland C++ builder (Eric Zurcher), work around Microsoft
-    compiler NaN handling bug (Mark Vakoc)
                  • 
+  
                • 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),
+    XIncludeduplicatefallback (William), external DTD encoding detection
+    (William), aDTDvalidation bug (William), xmlReader Close() fix,
+    recusiveextentionschemas
                  • 
+  
                • improvements: use xmlRead* APIs in test tools (Mark
+    Vakoc),indentingsave optimization, better handle IIS broken HTTP
+    redirectbehaviour (IanHummel), HTML parser frameset (James Bursa),
+    libxml2-pythonRPMdependancy, XML Schemas union support (Kasimier
+    Buchcik), warningremovalclanup (William), keep ChangeLog compressed when
+    installing fromRPMs
                  • 
+  
                • documentation: examples and xmlDocDumpMemory docs (John
+    Fleck),newexample (load, xpath, modify, save), xmlCatalogDump()
+  comments,
                  • 
+  
                • Windows: Borland C++ builder (Eric Zurcher), work
+    aroundMicrosoftcompiler NaN handling bug (Mark Vakoc)
                  • 
 
                2.6.8: Mar 23 2004
                • First step of the cleanup of the serialization code and APIs
                  • 
-  
                • XML Schemas: mixed content (Adam Dickmeiss), QName handling fixes (Adam
-    Dickmeiss), anyURI for "" (John Belmonte)
                  • 
+  
                • XML Schemas: mixed content (Adam Dickmeiss), QName handling
+    fixes(AdamDickmeiss), anyURI for "" (John Belmonte)
                  • 
   
                • Python: Canonicalization C14N support added (Anthony Carrico)
                  • 
   
                • xmlDocCopyNode() extension (William)
                  • 
-  
                • Relax-NG: fix when processing XInclude results (William), external
-    reference in interleave (William), missing error on <choice>
-    failure (William), memory leak in schemas datatype facets.
                  • 
+  
                • Relax-NG: fix when processing XInclude results
+    (William),externalreference in interleave (William), missing error
+    on<choice>failure (William), memory leak in schemas
+  datatypefacets.
                  • 
   
                • xmlWriter: patch for better DTD support (Alfred Mickautsch)
                  • 
-  
                • 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.
                  • 
+  
                • bug fixes: xmlXPathLangFunction memory leak (Mike Hommey
+    andWilliamBrack), no ID errors if using HTML_PARSE_NOERROR,
+    xmlcatalogfallbacks toURI on SYSTEM lookup failure, XInclude parse
+    flagsinheritance (William),XInclude and XPointer fixes for entities
+    (William),XML parser bugreported by Holger Rauch, nanohttp fd leak
+    (William),regexps chargroups '-' handling (William), dictionnary
+    reference countingproblems,do not close stderr.
                  • 
   
                • performance patches from Petr Pajas
                  • 
   
                • Documentation fixes: XML_CATALOG_FILES in man pages (Mike Hommey)
                  • 
-  
                • 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)
                  • 
+  
                • compilation and portability fixes: --without-valid,
+    catalogcleanups(Peter Breitenlohner), MingW patch (Roland
+    Schwingel),cross-compilationto Windows (Christophe de Vienne), 
+    --with-html-dirfixup (Julio MerinoVidal), Windows build (Eric
+  Zurcher)
                  • 
 
                2.6.7: Feb 23 2004
                • documentation: tutorial updates (John Fleck), benchmark results
                  • 
   
                • xmlWriter: updates and fixes (Alfred Mickautsch, Lucas Brasilino)
                  • 
   
                • XPath optimization (Petr Pajas)
                  • 
   
                • DTD ID handling optimization
                  • 
-  
                • bugfixes: xpath number with  > 19 fractional (William Brack), push
-    mode with unescaped '>' characters, fix xmllint --stream --timing, fix
-    xmllint --memory --stream memory usage, xmlAttrSerializeTxtContent
-    handling NULL, trying to fix Relax-NG/Perl interface.
                  • 
+  
                • bugfixes: xpath number with  > 19 fractional (William
+    Brack),pushmode with unescaped '>' characters, fix xmllint --stream
+    --timing,fixxmllint --memory --stream memory
+    usage,xmlAttrSerializeTxtContenthandling NULL, trying to fix
+    Relax-NG/Perlinterface.
                  • 
   
                • python: 2.3 compatibility, whitespace fixes (Malcolm Tredinnick)
                  • 
   
                • Added relaxng option to xmllint --shell
                  • 
-
                2.6.6: Feb 12 2004
                • nanohttp and nanoftp: buffer overflow error on URI parsing (Igor and
-    William) reported by Yuuichi Teranishi
                  • 
-  
                • 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,
-    <xs:all> fix (Alexey Sarytchev)
                  • 
-  
                • Build: fix for automake-1.8 (Alexander Winston), warnings removal
-    (Philip Ludlam), SOCKLEN_T detection fixes (Daniel Richard), fix
-    --with-minimum configuration.
                  • 
+
                2.6.6: Feb 12 2004
                • nanohttp and nanoftp: buffer overflow error on URI parsing
+    (IgorandWilliam) reported by Yuuichi Teranishi
                  • 
+  
                • bugfixes: make test and path issues, xmlWriter
+    attributeserialization(William Brack), xmlWriter indentation (William),
+    schemasvalidation(Eric Haszlakiewicz), XInclude dictionnaries issues
+    (Williamand OlegParaschenko), XInclude empty fallback (William), HTML
+    warnings(William),XPointer in XInclude (William), Python
+    namespaceserialization,isolat1ToUTF8 bound error (Alfred Mickautsch),
+    output ofparameterentities in internal subset (William), internal subset
+    bug inpush mode,<xs:all> fix (Alexey Sarytchev)
                  • 
+  
                • Build: fix for automake-1.8 (Alexander Winston), warningsremoval(Philip
+    Ludlam), SOCKLEN_T detection fixes (Daniel Richard),fix--with-minimum
+    configuration.
                  • 
   
                • XInclude: allow the 2001 namespace without warning.
                  • 
-  
                • Documentation: missing example/index.html (John Fleck), version
-    dependancies (John Fleck)
                  • 
+  
                • Documentation: missing example/index.html (John
+    Fleck),versiondependancies (John Fleck)
                  • 
   
                • reader API: structured error reporting (Steve Ball)
                  • 
-  
                • Windows compilation: mingw, msys (Mikhail Grushinskiy), function
-    prototype (Cameron Johnson), MSVC6 compiler warnings, _WINSOCKAPI_
-  patch
                  • 
-  
                • Parsers: added xmlByteConsumed(ctxt) API to get the byte offest in
-    input.
                  • 
-
                2.6.5: Jan 25 2004
                • 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)
                  • 
-  
                • Documentation: python scripts (William Brack), xslt stylesheets (John
-    Fleck), doc (Sven Zimmerman), I/O example.
                  • 
-  
                • Python bindings: fixes (William), enum support (Stéphane Bidoul),
-    structured error reporting (Stéphane Bidoul)
                  • 
-  
                • XInclude: various fixes for conformance, problem related to dictionnary
-    references (William & me), recursion (William)
                  • 
-  
                • xmlWriter: indentation (Lucas Brasilino), memory leaks (Alfred
-    Mickautsch),
                  • 
+  
                • Windows compilation: mingw, msys (Mikhail
+    Grushinskiy),functionprototype (Cameron Johnson), MSVC6 compiler
+    warnings,_WINSOCKAPI_patch
                  • 
+  
                • Parsers: added xmlByteConsumed(ctxt) API to get the byte
+  offestininput.
                  • 
+
                2.6.5: Jan 25 2004
                • Bugfixes: dictionnaries for schemas (William Brack),
+    regexpsegfault(William), xs:all problem (William), a number of
+    XPointerbugfixes(William), xmllint error go to stderr, DTD validation
+    problemwithnamespace, memory leak (William), SAX1 cleanup and minimal
+    optionsfixes(Mark Vadoc), parser context reset on error (Shaun McCance),
+    XPathunionevaluation problem (William) , xmlReallocLoc with NULL
+    (AlekseySanin),XML Schemas double free (Steve Ball), XInclude with no
+    href,argumentcallbacks order for XPath callbacks (Frederic Peters)
                  • 
+  
                • Documentation: python scripts (William Brack), xslt
+    stylesheets(JohnFleck), doc (Sven Zimmerman), I/O example.
                  • 
+  
                • Python bindings: fixes (William), enum support
+    (StéphaneBidoul),structured error reporting (Stéphane Bidoul)
                  • 
+  
                • XInclude: various fixes for conformance, problem related
+    todictionnaryreferences (William & me), recursion (William)
                  • 
+  
                • xmlWriter: indentation (Lucas Brasilino), memory
+    leaks(AlfredMickautsch),
                  • 
   
                • xmlSchemas: normalizedString datatype (John Belmonte)
                  • 
   
                • code cleanup for strings functions (William)
                  • 
   
                • Windows: compiler patches (Mark Vakoc)
                  • 
-  
                • Parser optimizations, a few new XPath and dictionnary APIs for future
-    XSLT optimizations.
                  • 
+  
                • Parser optimizations, a few new XPath and dictionnary APIs
+    forfutureXSLT optimizations.
                  • 
 
                2.6.4: Dec 24 2003
                • Windows build fixes (Igor Zlatkovic)
                  • 
   
                • Some serious XInclude problems reported by Oleg Paraschenko and
                  • 
   
                • Unix and Makefile packaging fixes (me, William Brack,
                  • 
-  
                • Documentation improvements (John Fleck, William Brack), example fix
-    (Lucas Brasilino)
                  • 
-  
                • 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
                  • 
+  
                • Documentation improvements (John Fleck, William Brack),
+    examplefix(Lucas Brasilino)
                  • 
+  
                • bugfixes: xmlTextReaderExpand() with xmlReaderWalker, XPath
+    handlingofNULL strings (William Brack) , API building reader or
+    parserfromfiledescriptor should not close it, changed XPath sorting to
+    bestableagain (William Brack), xmlGetNodePath() generating
+    '(null)'(WilliamBrack), DTD validation and namespace bug (William Brack),
+    XMLSchemasdouble inclusion behaviour
                  • 
 
                2.6.3: Dec 10 2003
                • documentation updates and cleanup (DV, William Brack, John Fleck)
                  • 
-  
                • added a repository of examples, examples from Aleksey Sanin, Dodji
-    Seketeli, Alfred Mickautsch
                  • 
-  
                • Windows updates: Mark Vakoc, Igor Zlatkovic, Eric Zurcher, Mingw
-    (Kenneth Haley)
                  • 
+  
                • added a repository of examples, examples from Aleksey
+    Sanin,DodjiSeketeli, Alfred Mickautsch
                  • 
+  
                • Windows updates: Mark Vakoc, Igor Zlatkovic, Eric Zurcher,Mingw(Kenneth
+    Haley)
                  • 
   
                • Unicode range checking (William Brack)
                  • 
   
                • code cleanup (William Brack)
                  • 
   
                • Python bindings: doc (John Fleck),  bug fixes
                  • 
   
                • UTF-16 cleanup and BOM issues (William Brack)
                  • 
-  
                • 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)
                  • 
-  
                • XInclude bugfix, new APIs and update to the last version including the
-    namespace change.
                  • 
-  
                • 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
                  • 
-  
                • preliminary pattern support for streaming (needed for schemas
-    constraints), added xmlTextReaderPreservePattern() to collect subdocument
-    when streaming.
                  • 
+  
                • 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(DanielSchulman)
                  • 
+  
                • XInclude bugfix, new APIs and update to the last version
+    includingthenamespace change.
                  • 
+  
                • XML Schemas improvements: include (Robert Stepanek), importandnamespace
+    handling, fixed the regression tests troubles, addedexamplesbased on Eric
+    van der Vlist book, regexp fixes
                  • 
+  
                • preliminary pattern support for streaming (needed
+    forschemasconstraints), added xmlTextReaderPreservePattern() to
+    collectsubdocumentwhen streaming.
                  • 
   
                • various fixes in the structured error handling
                  • 
 
                2.6.2: Nov 4 2003
                • XPath context unregistration fixes
                  • 
   
                • text node coalescing fixes (Mark Lilback)
                  • 
@@ -482,117 +501,118 @@ to the CVS code base.
                  
   
                • a posteriori DTD validation fixes
                  • 
   
                • xmlReader bug fixes: Walker fixes, python bindings
                  • 
   
                • fixed xmlStopParser() to really stop the parser and errors
                  • 
-  
                • always generate line numbers when using the new xmlReadxxx
-  functions
                  • 
+  
                • always generate line numbers when using the new xmlReadxxxfunctions
                  • 
   
                • added XInclude support to the xmlReader interface
                  • 
   
                • implemented XML_PARSE_NONET parser option
                  • 
   
                • DocBook XSLT processing bug fixed
                  • 
   
                • HTML serialization for <p> elements (William Brack and me)
                  • 
   
                • XPointer failure in XInclude are now handled as resource errors
                  • 
-  
                • fixed xmllint --html to use the HTML serializer on output (added
-    --xmlout to implement the previous behaviour of saving it using the XML
-    serializer)
                  • 
+  
                • fixed xmllint --html to use the HTML serializer on output(added--xmlout
+    to implement the previous behaviour of saving it using
+  theXMLserializer)
                  • 
 
                2.6.1: Oct 28 2003
                • Mostly bugfixes after the big 2.6.0 changes
                  • 
-  
                • Unix compilation patches: libxml.m4 (Patrick Welche), warnings cleanup
-    (William Brack)
                  • 
-  
                • Windows compilation patches (Joachim Bauch, Stephane Bidoul, Igor
-    Zlatkovic)
                  • 
+  
                • Unix compilation patches: libxml.m4 (Patrick Welche),
+    warningscleanup(William Brack)
                  • 
+  
                • Windows compilation patches (Joachim Bauch, Stephane
+    Bidoul,IgorZlatkovic)
                  • 
   
                • xmlWriter bugfix (Alfred Mickautsch)
                  • 
   
                • chvalid.[ch]: couple of fixes from Stephane Bidoul
                  • 
-  
                • context reset: error state reset, push parser reset (Graham
-  Bennett)
                  • 
+  
                • context reset: error state reset, push parser reset (GrahamBennett)
                  • 
   
                • context reuse: generate errors if file is not readable
                  • 
-  
                • defaulted attributes for element coming from internal entities
-    (Stephane Bidoul)
                  • 
+  
                • defaulted attributes for element coming from internal
+    entities(StephaneBidoul)
                  • 
   
                • Python: tab and spaces mix (William Brack)
                  • 
   
                • Error handler could crash in DTD validation in 2.6.0
                  • 
   
                • xmlReader: do not use the document or element _private field
                  • 
   
                • testSAX.c: avoid a problem with some PIs (Massimo Morara)
                  • 
-  
                • 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.
                  • 
-
                2.6.0: Oct 20 2003
                • Major revision release: should be API and ABI compatible but got a lot
-    of change
                  • 
-  
                • Increased the library modularity, far more options can be stripped out,
-    a --with-minimum configuration will weight around 160KBytes
                  • 
-  
                • Use per parser and per document dictionnary, allocate names and small
-    text nodes from the dictionnary
                  • 
-  
                • 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...
                  • 
-  
                • rewrote all the error handling in the library, all errors can be
-    intercepted at a structured level, with precise information
-  available.
                  • 
-  
                • 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.
                  • 
-  
                • Similar new APIs for the xmlReader, for options and reuse, provided new
-    functions to access content as const strings, use them for Python
-  bindings
                  • 
-  
                • 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
                  • 
+  
                • general bug fixes: mandatory encoding in text decl,
+    serializingDocumentFragment nodes, xmlSearchNs 2.6.0 problem (Kasimier
+    Buchcik),XPath errorsnot reported,  slow HTML parsing of large
+  documents.
                  • 
+
                2.6.0: Oct 20 2003
                • Major revision release: should be API and ABI compatible but got alotof
+    change
                  • 
+  
                • Increased the library modularity, far more options can be strippedout,a
+    --with-minimum configuration will weight around 160KBytes
                  • 
+  
                • Use per parser and per document dictionnary, allocate names
+    andsmalltext nodes from the dictionnary
                  • 
+  
                • Switch to a SAX2 like parser rewrote most of the XML
+    parsercore,provides namespace resolution and defaulted attributes,
+    minimizememoryallocations and copies, namespace checking and specific
+    errorhandling,immutable buffers, make predefined entities static
+    structures,etc...
                  • 
+  
                • rewrote all the error handling in the library, all errors
+    canbeintercepted at a structured level, with
+  preciseinformationavailable.
                  • 
+  
                • New simpler and more generic XML and HTML parser APIs,
+    allowingtoeasilly modify the parsing options and reuse parser context
+    formultipleconsecutive documents.
                  • 
+  
                • Similar new APIs for the xmlReader, for options and reuse,
+    providednewfunctions to access content as const strings, use them
+    forPythonbindings
                  • 
+  
                • a  lot of other smaller API improvements: xmlStrPrintf
+    (AlekseySanin),Walker i.e. reader on a document tree based on Alfred
+    Mickautschcode,make room in nodes for line numbers, reference counting
+    and futurePSVIextensions, generation of character ranges to be checked
+    withfasteralgorithm (William),  xmlParserMaxDepth (Crutcher
+    Dunnavant),bufferaccess
                  • 
   
                • New xmlWriter API provided by Alfred Mickautsch
                  • 
   
                • Schemas: base64 support by Anthony Carrico
                  • 
-  
                • Parser<->HTTP integration fix, proper processing of the Mime-Type
-    and charset informations if available.
                  • 
-  
                • Relax-NG: bug fixes including the one reported by Martijn Faassen and
-    zeroOrMore, better error reporting.
                  • 
-  
                • Python bindings (Stéphane Bidoul), never use stdout for errors
-  output
                  • 
-  
                • 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)
                  • 
-  
                • Documentation fixes and README (William Brack), search fix (William),
-    tutorial updates (John Fleck), namespace docs (Stefan Kost)
                  • 
-  
                • 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 &#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.
                  • 
-  
                • 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
                  • 
+  
                • Parser<->HTTP integration fix, proper processing of
+    theMime-Typeand charset informations if available.
                  • 
+  
                • Relax-NG: bug fixes including the one reported by Martijn
+    FaassenandzeroOrMore, better error reporting.
                  • 
+  
                • Python bindings (Stéphane Bidoul), never use stdout forerrorsoutput
                  • 
+  
                • Portability: all the headers have macros for export
+    andcallingconvention definitions (Igor Zlatkovic), VMS update (Craig
+    A.Berry),Windows: threads (Jesse Pelton), Borland compiler (Eric
+    Zurcher,Igor),Mingw (Igor), typos (Mark Vakoc),  beta version
+    (StephaneBidoul),warning cleanups on AIX and MIPS compilers (William
+    Brack), BeOS(Marcin'Shard' Konicki)
                  • 
+  
                • Documentation fixes and README (William Brack), search
+    fix(William),tutorial updates (John Fleck), namespace docs (Stefan
+  Kost)
                  • 
+  
                • Bug fixes: xmlCleanupParser (Dave Beckett),
+    threadinguninitializedmutexes, 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 &#x10FFFF;, bufferaccess in pushmode (Justin Fletcher),
+    TLS threads on Windows (JessePelton), XPath bug(William),
+    xmlCleanupParser (Marc Liyanage), CDATAoutput (William), HTTPerror
+    handling.
                  • 
+  
                • xmllint options: --dtdvalidfpi for Tobias Reif, --sax1
+    forcompattesting,  --nodict for building without tree dictionnary,
+    --nocdatatoreplace CDATA by text, --nsclean to remove
+    surperfluousnamespacedeclarations
                  • 
   
                • added xml2-config --libtool-libs option from Kevin P. Fleming
                  • 
-  
                • 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.
                  • 
+  
                • a lot of profiling and tuning of the code, speedup
+    patchforxmlSearchNs() by Luca Padovani. The xmlReader should do
+    farlessallocation and it speed should get closer to SAX. Chris
+    Andersonworkedon speeding and cleaning up repetitive checking code.
                  • 
   
                • cleanup of "make tests"
                  • 
   
                • libxml-2.0-uninstalled.pc from Malcolm Tredinnick
                  • 
-  
                • deactivated the broken docBook SGML parser code and plugged the XML
-    parser instead.
                  • 
+  
                • deactivated the broken docBook SGML parser code and plugged
+    theXMLparser instead.
                  • 
 
                2.5.11: Sep 9 2003
                A bugfix only release:
                • risk of crash in Relax-NG
                  • 
   
                • risk of crash when using multithreaded programs
                  • 
 
                2.5.10: Aug 15 2003
                A bugfixes only release
                • Windows Makefiles (William Brack)
                  • 
   
                • UTF-16 support fixes (Mark Itzcovitz)
                  • 
-  
                • Makefile and portability (William Brack) automake, Linux alpha, Mingw
-    on Windows (Mikhail Grushinskiy)
                  • 
+  
                • Makefile and portability (William Brack) automake, Linux alpha,
+    MingwonWindows (Mikhail Grushinskiy)
                  • 
   
                • HTML parser (Oliver Stoeneberg)
                  • 
   
                • XInclude performance problem reported by Kevin Ruscoe
                  • 
   
                • XML parser performance problem reported by Grant Goodale
                  • 
   
                • xmlSAXParseDTD() bug fix from Malcolm Tredinnick
                  • 
   
                • and a couple other cleanup
                  • 
-
                2.5.9: Aug 9 2003
                • 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
                  • 
+
                2.5.9: Aug 9 2003
                • bugfixes: IPv6 portability, xmlHasNsProp (Markus Keim),
+    Windowsbuild(Wiliam Brake, Jesse Pelton, Igor), Schemas (Peter
+    Sobisch),threading(Rob Richards), hexBinary type (), UTF-16 BOM
+    (DodjiSeketeli),xmlReader, Relax-NG schemas compilation, namespace
+    handling,EXSLT (SeanGriffin), HTML parsing problem (William Brack), DTD
+    validationfor mixedcontent + namespaces, HTML serialization,
+    libraryinitialization,progressive HTML parser
                  • 
   
                • better interfaces for Relax-NG error handling (Joachim Bauch, )
                  • 
   
                • adding xmlXIncludeProcessTree() for XInclud'ing in a subtree
                  • 
   
                • doc fixes and improvements (John Fleck)
                  • 
@@ -600,122 +620,121 @@ to the CVS code base.
                  
   
                • couple of new UTF-8 helper functions (William Brack)
                  • 
   
                • general encoding cleanup + ISO-8859-x without iconv (Peter Jacobi)
                  • 
   
                • xmlTextReader cleanup + enum for node types (Bjorn Reese)
                  • 
-  
                • general compilation/warning cleanup Solaris/HP-UX/... (William
-  Brack)
                  • 
-
                2.5.8: Jul 6 2003
                • 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)
                  • 
+  
                • general compilation/warning cleanup Solaris/HP-UX/...(WilliamBrack)
                  • 
+
                2.5.8: Jul 6 2003
                • bugfixes: XPath, XInclude, file/URI mapping, UTF-16
+    save(MarkItzcovitz), UTF-8 checking, URI saving, error printing
+    (WilliamBrack),PI related memleak, compilation without schemas or without
+    xpath(JoergSchmitz-Linneweber/Garry Pennington), xmlUnlinkNode problem
+    withDTDs,rpm problem on , i86_64, removed a few compilation problems
+    from2.5.7,xmlIOParseDTD, and xmlSAXParseDTD (Malcolm Tredinnick)
                  • 
   
                • portability: DJGPP (MsDos) , OpenVMS (Craig A. Berry)
                  • 
   
                • William Brack fixed multithreading lock problems
                  • 
   
                • IPv6 patch for FTP and HTTP accesses (Archana Shah/Wipro)
                  • 
-  
                • Windows fixes (Igor Zlatkovic,  Eric Zurcher), threading (Stéphane
-    Bidoul)
                  • 
+  
                • Windows fixes (Igor Zlatkovic,  Eric Zurcher),
+  threading(StéphaneBidoul)
                  • 
   
                • A few W3C Schemas Structure improvements
                  • 
   
                • W3C Schemas Datatype improvements (Charlie Bozeman)
                  • 
-  
                • Python bindings for thread globals (Stéphane Bidoul), and method/class
-    generator
                  • 
+  
                • Python bindings for thread globals (Stéphane Bidoul),
+    andmethod/classgenerator
                  • 
   
                • added --nonet option to xmllint
                  • 
   
                • documentation improvements (John Fleck)
                  • 
-
                2.5.7: Apr 25 2003
                • Relax-NG: Compiling to regexp and streaming validation on top of the
-    xmlReader interface, added to xmllint --stream
                  • 
+
                2.5.7: Apr 25 2003
                • Relax-NG: Compiling to regexp and streaming validation on top
+    ofthexmlReader interface, added to xmllint --stream
                  • 
   
                • xmlReader: Expand(), Next() and DOM access glue, bug fixes
                  • 
   
                • Support for large files: RGN validated a 4.5GB instance
                  • 
   
                • Thread support is now configured in by default
                  • 
-  
                • 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
                  • 
-  
                • extended the API to be able to plug a garbage collecting memory
-    allocator, added xmlMallocAtomic() and modified the allocations
-    accordingly.
                  • 
-  
                • Performances: removed excessive malloc() calls, speedup of the push and
-    xmlReader interfaces, removed excessive thread locking
                  • 
+  
                • Fixes: update of the Trio code (Bjorn), WXS Date and
+    Durationfixes(Charles Bozeman), DTD and namespaces (Brent Hendricks),
+    HTML pushparserand zero bytes handling, some missing Windows file
+    pathconversions,behaviour of the parser and validator in the presence of
+    "outof memory"error conditions
                  • 
+  
                • extended the API to be able to plug a garbage
+    collectingmemoryallocator, added xmlMallocAtomic() and modified
+    theallocationsaccordingly.
                  • 
+  
                • Performances: removed excessive malloc() calls, speedup of the
+    pushandxmlReader interfaces, removed excessive thread locking
                  • 
   
                • Documentation: man page (John Fleck), xmlReader documentation
                  • 
   
                • Python: adding binding for xmlCatalogAddLocal (Brent M Hendricks)
                  • 
-
                2.5.6: Apr 1 2003
                • Fixed W3C XML Schemas datatype, should be compliant now except for
-    binHex and base64 which are not supported yet.
                  • 
-  
                • 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)
                  • 
+
                2.5.6: Apr 1 2003
                • Fixed W3C XML Schemas datatype, should be compliant now exceptforbinHex
+    and base64 which are not supported yet.
                  • 
+  
                • bug fixes: non-ASCII IDs, HTML output, XInclude on large
+    docsandXInclude entities handling, encoding detection on external
+    subsets,XMLSchemas bugs and memory leaks, HTML parser (James Bursa)
                  • 
   
                • portability: python/trio (Albert Chin), Sun compiler warnings
                  • 
   
                • documentation: added --relaxng option to xmllint man page (John)
                  • 
-  
                • improved error reporting: xml:space, start/end tag mismatches, Relax NG
-    errors
                  • 
-
                2.5.5: Mar 24 2003
                • Lot of fixes on the Relax NG implementation. More testing including
-    DocBook and TEI examples.
                  • 
+  
                • improved error reporting: xml:space, start/end tag mismatches,
+    RelaxNGerrors
                  • 
+
                2.5.5: Mar 24 2003
                • Lot of fixes on the Relax NG implementation. More
+    testingincludingDocBook and TEI examples.
                  • 
   
                • Increased the support for W3C XML Schemas datatype
                  • 
   
                • Several bug fixes in the URI handling layer
                  • 
-  
                • Bug fixes: HTML parser, xmlReader, DTD validation, XPath, encoding
-    conversion, line counting in the parser.
                  • 
+  
                • Bug fixes: HTML parser, xmlReader, DTD validation,
+    XPath,encodingconversion, line counting in the parser.
                  • 
   
                • Added support for $XMLLINT_INDENT environment variable, FTP delete
                  • 
   
                • Fixed the RPM spec file name
                  • 
-
                2.5.4: Feb 20 2003
                • Conformance testing and lot of fixes on Relax NG and XInclude
-    implementation
                  • 
+
                2.5.4: Feb 20 2003
                • Conformance testing and lot of fixes on Relax NG
+    andXIncludeimplementation
                  • 
   
                • Implementation of XPointer element() scheme
                  • 
-  
                • Bug fixes: XML parser, XInclude entities merge, validity checking on
-    namespaces,
-    
                  2 serialization bugs, node info generation problems, a DTD regexp
-    generation problem.
                  
+  
                • Bug fixes: XML parser, XInclude entities merge, validity
+    checkingonnamespaces,
+    
                  2 serialization bugs, node info generation problems, a
+    DTDregexpgeneration problem.
                  
   
                  • 
   
                • Portability: windows updates and path canonicalization (Igor)
                  • 
   
                • A few typo fixes (Kjartan Maraas)
                  • 
   
                • Python bindings generator fixes (Stephane Bidoul)
                  • 
-
                2.5.3: Feb 10 2003
                • RelaxNG and XML Schemas datatypes improvements, and added a first
-    version of RelaxNG Python bindings
                  • 
-  
                • Fixes: XLink (Sean Chittenden), XInclude (Sean Chittenden), API fix for
-    serializing namespace nodes, encoding conversion bug, XHTML1
-  serialization
                  • 
+
                2.5.3: Feb 10 2003
                • RelaxNG and XML Schemas datatypes improvements, and added afirstversion
+    of RelaxNG Python bindings
                  • 
+  
                • Fixes: XLink (Sean Chittenden), XInclude (Sean Chittenden), API
+    fixforserializing namespace nodes, encoding conversion
+    bug,XHTML1serialization
                  • 
   
                • Portability fixes: Windows (Igor), AMD 64bits RPM spec file
                  • 
 
                2.5.2: Feb 5 2003
                • First implementation of RelaxNG, added --relaxng flag to xmllint
                  • 
   
                • Schemas support now compiled in by default.
                  • 
-  
                • 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
                  • 
+  
                • Bug fixes: DTD validation, namespace checking, XInclude
+    andentities,delegateURI in XML Catalogs, HTML parser, XML reader
+    (StéphaneBidoul),XPath parser and evaluation,  UTF8ToUTF8 serialization,
+    XMLreader memoryconsumption, HTML parser, HTML serialization in the
+    presenceofnamespaces
                  • 
   
                • added an HTML API to check elements and attributes.
                  • 
-  
                • Documentation improvement, PDF for the tutorial (John Fleck), doc
-    patches (Stefan Kost)
                  • 
+  
                • Documentation improvement, PDF for the tutorial (John Fleck),docpatches
+    (Stefan Kost)
                  • 
   
                • Portability fixes: NetBSD (Julio Merino), Windows (Igor Zlatkovic)
                  • 
-  
                • Added python bindings for XPointer, contextual error reporting
-    (Stéphane Bidoul)
                  • 
+  
                • Added python bindings for XPointer, contextual error
+    reporting(StéphaneBidoul)
                  • 
   
                • URI/file escaping problems (Stefano Zacchiroli)
                  • 
 
                2.5.1: Jan 8 2003
                • Fixes a memory leak and configuration/compilation problems in 2.5.0
                  • 
   
                • documentation updates (John)
                  • 
   
                • a couple of XmlTextReader fixes
                  • 
-
                2.5.0: Jan 6 2003
                2.5.0: Jan 6 2003
                • New XmltextReader interfacebased on
+    C#API(with help of Stéphane Bidoul)
                  • 
   
                • Windows: more exports, including the new API (Igor)
                  • 
   
                • XInclude fallback fix
                  • 
-  
                • 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)
                  • 
-  
                • Tutorial fixes (john Fleck and Niraj Tolia) xmllint man update
-  (John)
                  • 
+  
                • Python: bindings for the new API, packaging
+    (StéphaneBidoul),drv_libxml2.py Python xml.sax driver (Stéphane Bidoul),
+    fixes,speedupand iterators for Python-2.2 (Hannu Krosing)
                  • 
+  
                • Tutorial fixes (john Fleck and Niraj Tolia) xmllint manupdate(John)
                  • 
   
                • Fix an XML parser bug raised by Vyacheslav Pindyura
                  • 
   
                • Fix for VMS serialization (Nigel Hall) and config (Craig A. Berry)
                  • 
   
                • Entities handling fixes
                  • 
-  
                • new API to optionally track node creation and deletion (Lukas
-  Schroeder)
                  • 
+  
                • new API to optionally track node creation and
+  deletion(LukasSchroeder)
                  • 
   
                • Added documentation for the XmltextReader interface and some XML guidelines
                  • 
 
                2.4.30: Dec 12 2002
                • 2.4.29 broke the python bindings, rereleasing
                  • 
-  
                • Improvement/fixes of the XML API generator, and couple of minor code
-    fixes.
                  • 
-
                2.4.29: Dec 11 2002
                • Windows fixes (Igor): Windows CE port, pthread linking, python bindings
-    (Stéphane Bidoul), Mingw (Magnus Henoch), and export list updates
                  • 
+  
                • Improvement/fixes of the XML API generator, and couple of
+    minorcodefixes.
                  • 
+
                2.4.29: Dec 11 2002
                • Windows fixes (Igor): Windows CE port, pthread linking,
+    pythonbindings(Stéphane Bidoul), Mingw (Magnus Henoch), and export
+    listupdates
                  • 
   
                • Fix for prev in python bindings (ERDI Gergo)
                  • 
   
                • Fix for entities handling (Marcus Clarke)
                  • 
-  
                • Refactored the XML and HTML dumps to a single code path, fixed XHTML1
-    dump
                  • 
+  
                • Refactored the XML and HTML dumps to a single code path,
+  fixedXHTML1dump
                  • 
   
                • Fix for URI parsing when handling URNs with fragment identifiers
                  • 
   
                • Fix for HTTP URL escaping problem
                  • 
   
                • added an TextXmlReader (C#) like API (work in progress)
                  • 
-  
                • Rewrote the API in XML generation script, includes a C parser and saves
-    more informations needed for C# bindings
                  • 
+  
                • Rewrote the API in XML generation script, includes a C parser
+    andsavesmore informations needed for C# bindings
                  • 
 
                2.4.28: Nov 22 2002
                • a couple of python binding fixes
                  • 
   
                • 2 bug fixes in the XML push parser
                  • 
   
                • potential memory leak removed (Martin Stoilov)
                  • 
@@ -724,41 +743,41 @@ to the CVS code base.
                  
   
                • autodetection of XHTML1 and specific serialization rules added
                  • 
   
                • nasty threading bug fixed (William Brack)
                  • 
 
                2.4.27: Nov 17 2002
                • fixes for the Python bindings
                  • 
-  
                • 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
                  • 
+  
                • a number of bug fixes: SGML catalogs,xmlParseBalancedChunkMemory(),HTML
+    parser,  Schemas (Charles Bozeman),document fragment support(Christian
+    Glahn), xmlReconciliateNs (BrianStafford), XPointer,xmlFreeNode(),
+    xmlSAXParseMemory (Peter Jones),xmlGetNodePath (PetrPajas), entities
+    processing
                  • 
   
                • added grep to xmllint --shell
                  • 
   
                • VMS update patch from Craig A. Berry
                  • 
-  
                • cleanup of the Windows build with support for more compilers (Igor),
-    better thread support on Windows
                  • 
+  
                • cleanup of the Windows build with support for more
+    compilers(Igor),better thread support on Windows
                  • 
   
                • cleanup of Unix Makefiles and spec file
                  • 
   
                • Improvements to the documentation (John Fleck)
                  • 
 
                2.4.26: Oct 18 2002
                • Patches for Windows CE port, improvements on Windows paths handling
                  • 
-  
                • Fixes to the validation  code (DTD and Schemas), xmlNodeGetPath() ,
-    HTML serialization, Namespace compliance,  and a number of small
-  problems
                  • 
-
                2.4.25: Sep 26 2002
                • A number of bug fixes: XPath, validation, Python bindings, DOM and
-    tree, xmlI/O,  Html
                  • 
+  
                • Fixes to the validation  code (DTD and Schemas), xmlNodeGetPath()
+    ,HTMLserialization, Namespace compliance,  and a number of
+  smallproblems
                  • 
+
                2.4.25: Sep 26 2002
                • A number of bug fixes: XPath, validation, Python bindings, DOM
+    andtree,xmlI/O,  Html
                  • 
   
                • Serious rewrite of XInclude
                  • 
-  
                • Made XML Schemas regexp part of the default build and APIs, small fix
-    and improvement of the regexp core
                  • 
+  
                • Made XML Schemas regexp part of the default build and APIs, smallfixand
+    improvement of the regexp core
                  • 
   
                • Changed the validation code to reuse XML Schemas regexp APIs
                  • 
-  
                • Better handling of Windows file paths, improvement of Makefiles (Igor,
-    Daniel Gehriger, Mark Vakoc)
                  • 
-  
                • Improved the python I/O bindings, the tests, added resolver and regexp
-    APIs
                  • 
+  
                • Better handling of Windows file paths, improvement of
+    Makefiles(Igor,Daniel Gehriger, Mark Vakoc)
                  • 
+  
                • Improved the python I/O bindings, the tests, added resolver
+    andregexpAPIs
                  • 
   
                • New logos from Marc Liyanage
                  • 
   
                • Tutorial improvements: John Fleck, Christopher Harris
                  • 
-  
                • Makefile: Fixes for AMD x86_64 (Mandrake), DESTDIR (Christophe
-  Merlet)
                  • 
+  
                • Makefile: Fixes for AMD x86_64 (Mandrake),
+  DESTDIR(ChristopheMerlet)
                  • 
   
                • removal of all stderr/perror use for error reporting
                  • 
   
                • Better error reporting: XPath and DTD validation
                  • 
   
                • update of the trio portability layer (Bjorn Reese)
                  • 
 
                2.4.24: Aug 22 2002
                • XPath fixes (William), xf:escape-uri() (Wesley Terpstra)
                  • 
-  
                • Python binding fixes: makefiles (William), generator, rpm build, x86-64
-    (fcrozat)
                  • 
+  
                • Python binding fixes: makefiles (William), generator, rpm
+    build,x86-64(fcrozat)
                  • 
   
                • HTML <style> and boolean attributes serializer fixes
                  • 
   
                • C14N improvements by Aleksey
                  • 
   
                • doc cleanups: Rick Jones
                  • 
@@ -768,96 +787,98 @@ to the CVS code base.
                  
   
                • c14n fixes, testsuite and performances: Aleksey Sanin
                  • 
   
                • added xmlDocFormatDump: Chema Celorio
                  • 
   
                • new tutorial: John Fleck
                  • 
-  
                • new hash functions and performances: Sander Vesik, portability fix from
-    Peter Jacobi
                  • 
-  
                • a number of bug fixes: XPath (William Brack, Richard Jinks), XML and
-    HTML parsers, ID lookup function
                  • 
+  
                • new hash functions and performances: Sander Vesik, portability
+    fixfromPeter Jacobi
                  • 
+  
                • a number of bug fixes: XPath (William Brack, Richard Jinks), XMLandHTML
+    parsers, ID lookup function
                  • 
   
                • removal of all remaining sprintf: Aleksey Sanin
                  • 
-
                2.4.22: May 27 2002
                • a number of bug fixes: configure scripts, base handling, parser, memory
-    usage, HTML parser, XPath, documentation (Christian Cornelssen),
-    indentation, URI parsing
                  • 
-  
                • Optimizations for XMLSec, fixing and making public some of the network
-    protocol handlers (Aleksey)
                  • 
+
                2.4.22: May 27 2002
                • a number of bug fixes: configure scripts, base handling,
+    parser,memoryusage, HTML parser, XPath, documentation
+    (ChristianCornelssen),indentation, URI parsing
                  • 
+  
                • Optimizations for XMLSec, fixing and making public some of
+    thenetworkprotocol handlers (Aleksey)
                  • 
   
                • performance patch from Gary Pennington
                  • 
-  
                • Charles Bozeman provided date and time support for XML Schemas
-  datatypes
                  • 
-
                2.4.21: Apr 29 2002
                This release is both a bug fix release and also contains the early XML
-Schemas structures and datatypes 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:
                • a couple of bugs or limitations introduced in 2.4.20
                  • 
+  
                • Charles Bozeman provided date and time support for
+  XMLSchemasdatatypes
                  • 
+
                2.4.21: Apr 29 2002
                This release is both a bug fix release and also contains the
+earlyXMLSchemas structuresand
+datatypescode,
+beware,allinterfaces are likely to change, there is huge holes, it is clearly
+a workinprogress and don't even think of putting this code in a
+productionsystem,it's actually not compiled in by default. The real fixes
+are:
                • a couple of bugs or limitations introduced in 2.4.20
                  • 
   
                • patches for Borland C++ and MSC by Igor
                  • 
-  
                • some fixes on XPath strings and conformance patches by Richard
-  Jinks
                  • 
+  
                • some fixes on XPath strings and conformance patches by RichardJinks
                  • 
   
                • patch from Aleksey for the ExcC14N specification
                  • 
   
                • OSF/1 bug fix by Bjorn
                  • 
 
                2.4.20: Apr 15 2002
                • bug fixes: file descriptor leak, XPath, HTML output, DTD validation
                  • 
   
                • XPath conformance testing by Richard Jinks
                  • 
-  
                • Portability fixes: Solaris, MPE/iX, Windows, OSF/1, python bindings,
-    libxml.m4
                  • 
-
                2.4.19: Mar 25 2002
                • bug fixes: half a dozen XPath bugs, Validation, ISO-Latin to UTF8
-    encoder
                  • 
+  
                • Portability fixes: Solaris, MPE/iX, Windows, OSF/1,
+    pythonbindings,libxml.m4
                  • 
+
                2.4.19: Mar 25 2002
                • bug fixes: half a dozen XPath bugs, Validation, ISO-Latin
+  toUTF8encoder
                  • 
   
                • portability fixes in the HTTP code
                  • 
   
                • memory allocation checks using valgrind, and profiling tests
                  • 
   
                • revamp of the Windows build and Makefiles
                  • 
-
                2.4.18: Mar 18 2002
                • bug fixes: tree, SAX, canonicalization, validation, portability,
-  XPath
                  • 
+
                2.4.18: Mar 18 2002
                • bug fixes: tree, SAX, canonicalization,
+  validation,portability,XPath
                  • 
   
                • removed the --with-buffer option it was becoming unmaintainable
                  • 
   
                • serious cleanup of the Python makefiles
                  • 
   
                • speedup patch to XPath very effective for DocBook stylesheets
                  • 
   
                • Fixes for Windows build, cleanup of the documentation
                  • 
-
                2.4.17: Mar 8 2002
                • a lot of bug fixes, including "namespace nodes have no parents in
-  XPath"
                  • 
-  
                • fixed/improved the Python wrappers, added more examples and more
-    regression tests, XPath extension functions can now return node-sets
                  • 
+
                2.4.17: Mar 8 2002
                • a lot of bug fixes, including "namespace nodes have no
+  parentsinXPath"
                  • 
+  
                • fixed/improved the Python wrappers, added more examples
+    andmoreregression tests, XPath extension functions can now
+  returnnode-sets
                  • 
   
                • added the XML Canonicalization support from Aleksey Sanin
                  • 
-
                2.4.16: Feb 20 2002
                • a lot of bug fixes, most of them were triggered by the XML Testsuite
-    from OASIS and W3C. Compliance has been significantly improved.
                  • 
+
                2.4.16: Feb 20 2002
                • a lot of bug fixes, most of them were triggered by the XMLTestsuitefrom
+    OASIS and W3C. Compliance has been significantlyimproved.
                  • 
   
                • a couple of portability fixes too.
                  • 
 
                2.4.15: Feb 11 2002
                • Fixed the Makefiles, especially the python module ones
                  • 
   
                • A few bug fixes and cleanup
                  • 
   
                • Includes cleanup
                  • 
-
                2.4.14: Feb 8 2002
                • Change of License to the MIT
-    License basically for integration in XFree86 codebase, and removing
-    confusion around the previous dual-licensing
                  • 
-  
                • added Python bindings, beta software but should already be quite
-    complete
                  • 
-  
                • a large number of fixes and cleanups, especially for all tree
-    manipulations
                  • 
-  
                • cleanup of the headers, generation of a reference API definition in
-  XML
                  • 
+
                2.4.14: Feb 8 2002
                • Change of License to the MITLicensebasicallyfor
+    integration in XFree86 codebase, and removingconfusion around theprevious
+    dual-licensing
                  • 
+  
                • added Python bindings, beta software but should already
+  bequitecomplete
                  • 
+  
                • a large number of fixes and cleanups, especially for
+    alltreemanipulations
                  • 
+  
                • cleanup of the headers, generation of a reference API
+  definitioninXML
                  • 
 
                2.4.13: Jan 14 2002
                • update of the documentation: John Fleck and Charlie Bozeman
                  • 
   
                • cleanup of timing code from Justin Fletcher
                  • 
-  
                • fixes for Windows and initial thread support on Win32: Igor and Serguei
-    Narojnyi
                  • 
+  
                • fixes for Windows and initial thread support on Win32: Igor
+    andSergueiNarojnyi
                  • 
   
                • Cygwin patch from Robert Collins
                  • 
   
                • added xmlSetEntityReferenceFunc() for Keith Isdale work on xsldbg
                  • 
-
                2.4.12: Dec 7 2001
                • a few bug fixes: thread (Gary Pennington), xmllint (Geert Kloosterman),
-    XML parser (Robin Berjon), XPointer (Danny Jamshy), I/O cleanups
-  (robert)
                  • 
+
                2.4.12: Dec 7 2001
                • a few bug fixes: thread (Gary Pennington), xmllint
+    (GeertKloosterman),XML parser (Robin Berjon), XPointer (Danny Jamshy),
+    I/Ocleanups(robert)
                  • 
   
                • Eric Lavigne contributed project files for MacOS
                  • 
   
                • some makefiles cleanups
                  • 
-
                2.4.11: Nov 26 2001
                • fixed a couple of errors in the includes, fixed a few bugs, some code
-    cleanups
                  • 
+
                2.4.11: Nov 26 2001
                • fixed a couple of errors in the includes, fixed a few bugs,
+    somecodecleanups
                  • 
   
                • xmllint man pages improvement by Heiko Rupp
                  • 
   
                • updated VMS build instructions from John A Fotheringham
                  • 
   
                • Windows Makefiles updates from Igor
                  • 
 
                2.4.10: Nov 10 2001
                • URI escaping fix (Joel Young)
                  • 
   
                • added xmlGetNodePath() (for paths or XPointers generation)
                  • 
   
                • Fixes namespace handling problems when using DTD and validation
                  • 
-  
                • improvements on xmllint: Morus Walter patches for --format and
-    --encode, Stefan Kost and Heiko Rupp improvements on the --shell
                  • 
+  
                • improvements on xmllint: Morus Walter patches for --format
+    and--encode,Stefan Kost and Heiko Rupp improvements on the --shell
                  • 
   
                • fixes for xmlcatalog linking pointed by Weiqi Gao
                  • 
   
                • fixes to the HTML parser
                  • 
 
                2.4.9: Nov 6 2001
                • fixes more catalog bugs
                  • 
   
                • avoid a compilation problem, improve xmlGetLineNo()
                  • 
-
                2.4.8: Nov 4 2001
                • fixed SGML catalogs broken in previous release, updated xmlcatalog
-  tool
                  • 
+
                2.4.8: Nov 4 2001
                • fixed SGML catalogs broken in previous release,
+  updatedxmlcatalogtool
                  • 
   
                • fixed a compile errors and some includes troubles.
                  • 
 
                2.4.7: Oct 30 2001
                • exported some debugging interfaces
                  • 
   
                • serious rewrite of the catalog code
                  • 
-  
                • integrated Gary Pennington thread safety patch, added configure option
-    and regression tests
                  • 
+  
                • integrated Gary Pennington thread safety patch, added
+    configureoptionand regression tests
                  • 
   
                • removed an HTML parser bug
                  • 
   
                • fixed a couple of potentially serious validation bugs
                  • 
   
                • integrated the SGML DocBook support in xmllint
                  • 
@@ -873,12 +894,11 @@ it's actually not compiled in by default. The real fixes are:
                  • a coupl
   
                  • fixed half a dozen bugs reported for libxml or libxslt
                    • 
   
                  • updated xmlcatalog to be able to modify SGML super catalogs
                    • 
 
                  2.4.5: Sep 14 2001
                  • Remove a few annoying bugs in 2.4.4
                    • 
-  
                  • forces the HTML serializer to output decimal charrefs since some
-    version of Netscape can't handle hexadecimal ones
                    • 
-
                  1.8.16: Sep 14 2001
                  • maintenance release of the old libxml1 branch, couple of bug and
-    portability fixes
                    • 
-
                  2.4.4: Sep 12 2001
                  • added --convert to xmlcatalog, bug fixes and cleanups of XML
-  Catalog
                    • 
+  
                  • forces the HTML serializer to output decimal charrefs since
+    someversionof Netscape can't handle hexadecimal ones
                    • 
+
                  1.8.16: Sep 14 2001
                  • maintenance release of the old libxml1 branch, couple of
+    bugandportability fixes
                    • 
+
                  2.4.4: Sep 12 2001
                  • added --convert to xmlcatalog, bug fixes and cleanups of XMLCatalog
                    • 
   
                  • a few bug fixes and some portability changes
                    • 
   
                  • some documentation cleanups
                    • 
 
                  2.4.3:  Aug 23 2001
                  • XML Catalog support see the doc
                    • 
@@ -896,13 +916,13 @@ it's actually not compiled in by default. The real fixes are:
                    • a coupl
   
                    • cleanup for alpha and ia64 targets
                      • 
   
                    • patch to allow saving through HTTP PUT or POST
                      • 
 
                    2.4.0: July 10 2001
                    • Fixed a few bugs in XPath, validation, and tree handling.
                      • 
-  
                    • Fixed XML Base implementation, added a couple of examples to the
-    regression tests
                      • 
+  
                    • Fixed XML Base implementation, added a couple of examples
+    totheregression tests
                      • 
   
                    • A bit of cleanup
                      • 
-
                    2.3.14: July 5 2001
                    • fixed some entities problems and reduce memory requirement when
-    substituting them
                      • 
-  
                    • lots of improvements in the XPath queries interpreter can be
-    substantially faster
                      • 
+
                    2.3.14: July 5 2001
                    • fixed some entities problems and reduce memory
+    requirementwhensubstituting them
                      • 
+  
                    • lots of improvements in the XPath queries interpreter
+    canbesubstantially faster
                      • 
   
                    • Makefiles and configure cleanups
                      • 
   
                    • Fixes to XPath variable eval, and compare on empty node set
                      • 
   
                    • HTML tag closing bug fixed
                      • 
@@ -916,37 +936,38 @@ it's actually not compiled in by default. The real fixes are:
                      • a coupl
   
                      • fixed line number counting
                        • 
   
                      • fixed serious problems in the XInclude processing
                        • 
   
                      • added support for UTF8 BOM at beginning of entities
                        • 
-  
                      • 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
                        • 
-  
                      • incorporated Yon Derek and Igor Zlatkovic  fixes and improvements for
-    compilation on Windows MSC
                        • 
+  
                      • fixed a strange gcc optimizer bugs in xpath handling of
+    float,gcc-3.0miscompile uri.c (William), Thomas Leitner provided a fix
+    fortheoptimizer on Tru64
                        • 
+  
                      • incorporated Yon Derek and Igor Zlatkovic  fixes and
+    improvementsforcompilation on Windows MSC
                        • 
   
                      • update of libxml-doc.el (Felix Natter)
                        • 
   
                      • fixed 2 bugs in URI normalization code
                        • 
-
                      2.3.11: June 17 2001
                      • updates to trio, Makefiles and configure should fix some portability
-    problems (alpha)
                        • 
-  
                      • fixed some HTML serialization problems (pre, script, and block/inline
-    handling), added encoding aware APIs, cleanup of this code
                        • 
+
                      2.3.11: June 17 2001
                      • updates to trio, Makefiles and configure should fix
+    someportabilityproblems (alpha)
                        • 
+  
                      • fixed some HTML serialization problems (pre, script,
+    andblock/inlinehandling), added encoding aware APIs, cleanup of
+  thiscode
                        • 
   
                      • added xmlHasNsProp()
                        • 
-  
                      • implemented a specific PI for encoding support in the DocBook SGML
-    parser
                        • 
-  
                      • some XPath fixes (-Infinity, / as a function parameter and namespaces
-    node selection)
                        • 
+  
                      • implemented a specific PI for encoding support in the
+  DocBookSGMLparser
                        • 
+  
                      • some XPath fixes (-Infinity, / as a function parameter
+    andnamespacesnode selection)
                        • 
   
                      • fixed a performance problem and an error in the validation code
                        • 
   
                      • fixed XInclude routine to implement the recursive behaviour
                        • 
   
                      • fixed xmlFreeNode problem when libxml is included statically twice
                        • 
   
                      • added --version to xmllint for bug reports
                        • 
 
                      2.3.10: June 1 2001
                      • fixed the SGML catalog support
                        • 
-  
                      • a number of reported bugs got fixed, in XPath, iconv detection,
-    XInclude processing
                        • 
+  
                      • a number of reported bugs got fixed, in XPath, iconv
+    detection,XIncludeprocessing
                        • 
   
                      • XPath string function should now handle unicode correctly
                        • 
 
                      2.3.9: May 19 2001
                      Lots of bugfixes, and added a basic SGML catalog support:
                      • HTML push bugfix #54891 and another patch from Jonas Borgström
                        • 
   
                      • some serious speed optimization again
                        • 
   
                      • some documentation cleanups
                        • 
   
                      • trying to get better linking on Solaris (-R)
                        • 
   
                      • XPath API cleanup from Thomas Broyer
                        • 
-  
                      • Validation bug fixed #54631, added a patch from Gary Pennington, fixed
-    xmlValidGetValidElements()
                        • 
+  
                      • Validation bug fixed #54631, added a patch from Gary
+    Pennington,fixedxmlValidGetValidElements()
                        • 
   
                      • Added an INSTALL file
                        • 
   
                      • Attribute removal added to API: #54433
                        • 
   
                      • added a basic support for SGML catalogs
                        • 
@@ -957,10 +978,10 @@ it's actually not compiled in by default. The real fixes are:
                        • a coupl
 
                        1.8.13: May 14 2001
                        • bugfixes release of the old libxml1 branch used by Gnome
                          • 
 
                        2.3.8: May 3 2001
                        • Integrated an SGML DocBook parser for the Gnome project
                          • 
   
                        • Fixed a few things in the HTML parser
                          • 
-  
                        • Fixed some XPath bugs raised by XSLT use, tried to fix the floating
-    point portability issue
                          • 
-  
                        • 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).
                          • 
+  
                        • Fixed some XPath bugs raised by XSLT use, tried to fix thefloatingpoint
+    portability issue
                          • 
+  
                        • Speed improvement (8M/s for SAX, 3M/s for DOM, 1.5M/s
+    forDOM+validationusing the XML REC as input and a 700MHz celeron).
                          • 
   
                        • incorporated more Windows cleanup
                          • 
   
                        • added xmlSaveFormatFile()
                          • 
   
                        • fixed problems in copying nodes with entities references (gdome)
                          • 
@@ -975,32 +996,33 @@ it's actually not compiled in by default. The real fixes are:
                          • a coupl
   
                          • Improved validation speed sensible for DocBook
                            • 
   
                          • fixed a big bug with ID declared in external parsed entities
                            • 
   
                          • portability fixes, update of Trio from Bjorn Reese
                            • 
-
                          2.3.6: April 8 2001
                          • Code cleanup using extreme gcc compiler warning options, found and
-    cleared half a dozen potential problem
                            • 
+
                          2.3.6: April 8 2001
                          • Code cleanup using extreme gcc compiler warning options,
+    foundandcleared half a dozen potential problem
                            • 
   
                          • the Eazel team found an XML parser bug
                            • 
-  
                          • 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
                            • 
-  
                          • xpath: removed a memory leak and fixed the predicate evaluation
-    problem, extended the testsuite and cleaned up the result. XPointer seems
-    broken ...
                            • 
-
                          2.3.5: Mar 23 2001
                          • Biggest change is separate parsing and evaluation of XPath expressions,
-    there is some new APIs for this too
                            • 
-  
                          • included a number of bug fixes(XML push parser, 51876, notations,
-  52299)
                            • 
+  
                          • cleaned up the user of some of the string formatting function.
+    usedthetrio library code to provide the one needed when the platform
+    ismissingthem
                            • 
+  
                          • xpath: removed a memory leak and fixed the predicate
+    evaluationproblem,extended the testsuite and cleaned up the result.
+    XPointer seemsbroken...
                            • 
+
                          2.3.5: Mar 23 2001
                          • Biggest change is separate parsing and evaluation of
+    XPathexpressions,there is some new APIs for this too
                            • 
+  
                          • included a number of bug fixes(XML push parser,
+  51876,notations,52299)
                            • 
   
                          • Fixed some portability issues
                            • 
 
                          2.3.4: Mar 10 2001
                          • Fixed bugs #51860 and #51861
                            • 
-  
                          • Added a global variable xmlDefaultBufferSize to allow default buffer
-    size to be application tunable.
                            • 
-  
                          • Some cleanup in the validation code, still a bug left and this part
-    should probably be rewritten to support ambiguous content model :-\
                            • 
-  
                          • Fix a couple of serious bugs introduced or raised by changes in 2.3.3
-    parser
                            • 
+  
                          • Added a global variable xmlDefaultBufferSize to allow defaultbuffersize
+    to be application tunable.
                            • 
+  
                          • Some cleanup in the validation code, still a bug left and
+    thispartshould probably be rewritten to support ambiguous content
+  model:-\
                            • 
+  
                          • Fix a couple of serious bugs introduced or raised by changes
+    in2.3.3parser
                            • 
   
                          • Fixed another bug in xmlNodeGetContent()
                            • 
   
                          • Bjorn fixed XPath node collection and Number formatting
                            • 
   
                          • Fixed a loop reported in the HTML parsing
                            • 
-  
                          • blank space are reported even if the Dtd content model proves that they
-    are formatting spaces, this is for XML conformance
                            • 
+  
                          • blank space are reported even if the Dtd content model proves
+    thattheyare formatting spaces, this is for XML conformance
                            • 
 
                          2.3.3: Mar 1 2001
                          • small change in XPath for XSLT
                            • 
   
                          • documentation cleanups
                            • 
   
                          • fix in validation by Gary Pennington
                            • 
@@ -1010,18 +1032,17 @@ it's actually not compiled in by default. The real fixes are:
                            • a coupl
   
                            • fixed a bug in xmlNodeGetContent
                              • 
   
                            • ID/IDREF support partly rewritten by Gary Pennington
                              • 
 
                            2.3.1: Feb 15 2001
                            • some XPath and HTML bug fixes for XSLT
                              • 
-  
                            • small extension of the hash table interfaces for DOM gdome2
-    implementation
                              • 
+  
                            • small extension of the hash table interfaces for
+  DOMgdome2implementation
                              • 
   
                            • A few bug fixes
                              • 
 
                            2.3.0: Feb 8 2001 (2.2.12 was on 25 Jan but I didn't kept track)
                            • Lots of XPath bug fixes
                              • 
-  
                            • Add a mode with Dtd lookup but without validation error reporting for
-    XSLT
                              • 
+  
                            • Add a mode with Dtd lookup but without validation error
+  reportingforXSLT
                              • 
   
                            • Add support for text node without escaping (XSLT)
                              • 
   
                            • bug fixes for xmlCheckFilename
                              • 
   
                            • validation code bug fixes from Gary Pennington
                              • 
   
                            • Patch from Paul D. Smith correcting URI path normalization
                              • 
-  
                            • Patch to allow simultaneous install of libxml-devel and
-  libxml2-devel
                              • 
+  
                            • Patch to allow simultaneous install of libxml-develandlibxml2-devel
                              • 
   
                            • the example Makefile is now fixed
                              • 
   
                            • added HTML to the RPM packages
                              • 
   
                            • tree copying bugfixes
                              • 
@@ -1038,8 +1059,7 @@ it's actually not compiled in by default. The real fixes are:
                              • a coupl
   
                              • Improved the XPointer implementation
                                • 
   
                              • integrate a number of provided patches
                                • 
 
                              2.2.9: Nov 25 2000
                              • erroneous release :-(
                                • 
-
                              2.2.8: Nov 13 2000
                              2.2.8: Nov 13 2000
                              • First version of XIncludesupport
                                • 
   
                              • Patch in conditional section handling
                                • 
   
                              • updated MS compiler project
                                • 
   
                              • fixed some XPath problems
                                • 
@@ -1050,19 +1070,19 @@ it's actually not compiled in by default. The real fixes are:
                                • a coupl
   
                                • xmlIOParseDTD() added
                                  • 
   
                                • various small fixes in the HTML, URI, HTTP and XPointer support
                                  • 
   
                                • some cleanup of the Makefile, autoconf and the distribution content
                                  • 
-
                                2.2.6: Oct 25 2000:
                                • Added an hash table module, migrated a number of internal structure to
-    those
                                  • 
+
                                2.2.6: Oct 25 2000:
                                • Added an hash table module, migrated a number of internal
+    structuretothose
                                  • 
   
                                • Fixed a posteriori validation problems
                                  • 
   
                                • HTTP module cleanups
                                  • 
-  
                                • HTML parser improvements (tag errors, script/style handling, attribute
-    normalization)
                                  • 
+  
                                • HTML parser improvements (tag errors, script/style
+    handling,attributenormalization)
                                  • 
   
                                • coalescing of adjacent text nodes
                                  • 
   
                                • couple of XPath bug fixes, exported the internal API
                                  • 
 
                                2.2.5: Oct 15 2000:
                                • XPointer implementation and testsuite
                                  • 
-  
                                • Lot of XPath fixes, added variable and functions registration, more
-    tests
                                  • 
-  
                                • Portability fixes, lots of enhancements toward an easy Windows build
-    and release
                                  • 
+  
                                • Lot of XPath fixes, added variable and functions
+  registration,moretests
                                  • 
+  
                                • Portability fixes, lots of enhancements toward an easy Windows
+    buildandrelease
                                  • 
   
                                • Late validation fixes
                                  • 
   
                                • Integrated a lot of contributed patches
                                  • 
   
                                • added memory management docs
                                  • 
@@ -1072,115 +1092,113 @@ it's actually not compiled in by default. The real fixes are:
                                  • a coupl
   
                                  • Serious bug fixes on the URI and HTML code
                                    • 
 
                                  2.2.3: Sep 17 2000
                                  • bug fixes
                                    • 
   
                                  • cleanup of entity handling code
                                    • 
-  
                                  • overall review of all loops in the parsers, all sprintf usage has been
-    checked too
                                    • 
-  
                                  • Far better handling of larges Dtd. Validating against DocBook XML Dtd
-    works smoothly now.
                                    • 
+  
                                  • overall review of all loops in the parsers, all sprintf usage
+    hasbeenchecked too
                                    • 
+  
                                  • Far better handling of larges Dtd. Validating against DocBook
+    XMLDtdworks smoothly now.
                                    • 
 
                                  1.8.10: Sep 6 2000
                                  • bug fix release for some Gnome projects
                                    • 
 
                                  2.2.2: August 12 2000
                                  • mostly bug fixes
                                    • 
   
                                  • started adding routines to access xml parser context options
                                    • 
 
                                  2.2.1: July 21 2000
                                  • a purely bug fixes release
                                    • 
   
                                  • fixed an encoding support problem when parsing from a memory block
                                    • 
   
                                  • fixed a DOCTYPE parsing problem
                                    • 
-  
                                  • removed a bug in the function allowing to override the memory
-    allocation routines
                                    • 
+  
                                  • removed a bug in the function allowing to override the
+    memoryallocationroutines
                                    • 
 
                                  2.2.0: July 14 2000
                                  • applied a lot of portability fixes
                                    • 
-  
                                  • better encoding support/cleanup and saving (content is now always
-    encoded in UTF-8)
                                    • 
+  
                                  • better encoding support/cleanup and saving (content is nowalwaysencoded
+    in UTF-8)
                                    • 
   
                                  • the HTML parser now correctly handles encodings
                                    • 
   
                                  • added xmlHasProp()
                                    • 
   
                                  • fixed a serious problem with &#38;
                                    • 
   
                                  • propagated the fix to FTP client
                                    • 
   
                                  • cleanup, bugfixes, etc ...
                                    • 
-  
                                  • Added a page about libxml Internationalization
-    support
                                    • 
+  
                                  • Added a page about libxmlInternationalizationsupport
                                    • 
 
                                  1.8.9:  July 9 2000
                                  • fixed the spec the RPMs should be better
                                    • 
-  
                                  • fixed a serious bug in the FTP implementation, released 1.8.9 to solve
-    rpmfind users problem
                                    • 
+  
                                  • fixed a serious bug in the FTP implementation, released 1.8.9
+    tosolverpmfind users problem
                                    • 
 
                                  2.1.1: July 1 2000
                                  • fixes a couple of bugs in the 2.1.0 packaging
                                    • 
   
                                  • improvements on the HTML parser
                                    • 
-
                                  2.1.0 and 1.8.8: June 29 2000
                                  • 1.8.8 is mostly a commodity package for upgrading to libxml2 according
-    to new instructions. It fixes a nasty problem
-    about &#38; charref parsing
                                    • 
-  
                                  • 2.1.0 also ease the upgrade from libxml v1 to the recent version. it
-    also contains numerous fixes and enhancements:
+
                                  2.1.0 and 1.8.8: June 29 2000
                                  • 1.8.8 is mostly a commodity package for upgrading to libxml2accordingto
+    new instructions. It fixes a nastyproblemabout
+    &#38; charref parsing
                                    • 
+  
                                  • 2.1.0 also ease the upgrade from libxml v1 to the recent version.italso
+    contains numerous fixes and enhancements:
     
                                    • added xmlStopParser() to stop parsing
                                      • 
       
                                    • improved a lot parsing speed when there is large CDATA blocs
                                      • 
       
                                    • includes XPath patches provided by Picdar Technology
                                      • 
-      
                                    • tried to fix as much as possible DTD validation and namespace
-        related problems
                                      • 
+      
                                    • tried to fix as much as possible DTD validation andnamespacerelated
+        problems
                                      • 
       
                                    • output to a given encoding has been added/tested
                                      • 
       
                                    • lot of various fixes
                                      • 
     
                                    • 
-
                                  2.0.0: Apr 12 2000
                                  • 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.
                                    • 
-  
                                  • The include are now located under $prefix/include/libxml (instead of
-    $prefix/include/gnome-xml), they also are referenced by
+
                                  2.0.0: Apr 12 2000
                                  • First public release of libxml2. If you are using libxml, it's
+    agoodidea to check the 1.x to 2.x upgrade instructions. NOTE:
+    whileinitiallyscheduled for Apr 3 the release occurred only on Apr 12 due
+    tomassiveworkload.
                                    • 
+  
                                  • The include are now located under $prefix/include/libxml
+    (insteadof$prefix/include/gnome-xml), they also are referenced by
     
                                    #include <libxml/xxx.h>
                                    
     
                                    instead of
                                    
     
                                    #include "xxx.h"
                                    
   
                                    • 
   
                                  • a new URI module for parsing URIs and following strictly RFC 2396
                                    • 
-  
                                  • the memory allocation routines used by libxml can now be overloaded
-    dynamically by using xmlMemSetup()
                                    • 
-  
                                  • The previously CVS only tool tester has been renamed
-    xmllint and is now installed as part of the libxml2
-    package
                                    • 
-  
                                  • 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()
                                    • 
-  
                                  • there is a C preprocessor macro LIBXML_VERSION providing the version
-    number of the libxml module in use
                                    • 
-  
                                  • a number of optional features of libxml can now be excluded at
-    configure time (FTP/HTTP/HTML/XPath/Debug)
                                    • 
+  
                                  • the memory allocation routines used by libxml can now
+    beoverloadeddynamically by using xmlMemSetup()
                                    • 
+  
                                  • The previously CVS only tool tester has
+    beenrenamedxmllintand is now installed as part of
+    thelibxml2package
                                    • 
+  
                                  • The I/O interface has been revamped. There is now ways to
+    pluginspecific I/O modules, either at the URI scheme detection
+    levelusingxmlRegisterInputCallbacks()  or by passing I/O functions
+    whencreating aparser context using xmlCreateIOParserCtxt()
                                    • 
+  
                                  • there is a C preprocessor macro LIBXML_VERSION providing
+    theversionnumber of the libxml module in use
                                    • 
+  
                                  • a number of optional features of libxml can now be excluded
+    atconfiguretime (FTP/HTTP/HTML/XPath/Debug)
                                    • 
 
                                  2.0.0beta: Mar 14 2000
                                  • This is a first Beta release of libxml version 2
                                    • 
-  
                                  • It's available only fromxmlsoft.org
-    FTP, it's packaged as libxml2-2.0.0beta and available as tar and
-  RPMs
                                    • 
-  
                                  • This version is now the head in the Gnome CVS base, the old one is
-    available under the tag LIB_XML_1_X
                                    • 
-  
                                  • 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
-    upgrade page
                                    • 
+  
                                  • It's available only fromxmlsoft.orgFTP, it's packaged
+    aslibxml2-2.0.0beta and available as tar andRPMs
                                    • 
+  
                                  • This version is now the head in the Gnome CVS base, the old
+    oneisavailable under the tag LIB_XML_1_X
                                    • 
+  
                                  • This includes a very large set of changes. From a  programmatic
+    pointofview applications should not have to be modified too much, check
+    theupgrade page
                                    • 
   
                                  • Some interfaces may changes (especially a bit about encoding).
                                    • 
   
                                  • the updates includes:
-    
                                    • fix I18N support. ISO-Latin-x/UTF-8/UTF-16 (nearly) seems correctly
-        handled now
                                      • 
-      
                                    • Better handling of entities, especially well-formedness checking
-        and proper PEref extensions in external subsets
                                      • 
+    
-  
                                    • Serious progress were made toward compliance, here are the result of the test 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.
                                      • 
+  
                                    • Serious progress were made toward compliance, here are the result of the
+    testagainsttheOASIS testsuite (except the Japanese tests since I
+    don't supportthatencoding yet). This URL is rebuilt every couple of hours
+    using theCVShead version.
                                      • 
 
                                    1.8.7: Mar 6 2000
                                    • This is a bug fix release:
                                      • 
-  
                                    • 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.
                                      • 
-  
                                    • Blanks in <a>  </a> constructs are not ignored anymore,
-    avoiding heuristic is really the Right Way :-\
                                      • 
-  
                                    • The unchecked use of snprintf which was breaking libxml-1.8.6
-    compilation on some platforms has been fixed
                                      • 
-  
                                    • nanoftp.c nanohttp.c: Fixed '#' and '?' stripping when processing
-  URIs
                                      • 
-
                                    1.8.6: Jan 31 2000
                                    • added a nanoFTP transport module, debugged until the new version of rpmfind can use
-    it without troubles
                                      • 
-
                                    1.8.5: Jan 21 2000
                                    • adding APIs to parse a well balanced chunk of XML (production [43] content of the
-    XML spec)
                                      • 
+  
                                    • It is possible to disable the ignorable blanks heuristic
+    usedbylibxml-1.x, a new function  xmlKeepBlanksDefault(0) will allow
+    this.Notethat for adherence to XML spec, this behaviour will be
+    disabledbydefault in 2.x . The same function will allow to keep
+    compatibilityforold code.
                                      • 
+  
                                    • Blanks in <a>  </a> constructs are not
+    ignoredanymore,avoiding heuristic is really the Right Way :-\
                                      • 
+  
                                    • The unchecked use of snprintf which was breakinglibxml-1.8.6compilation
+    on some platforms has been fixed
                                      • 
+  
                                    • nanoftp.c nanohttp.c: Fixed '#' and '?' stripping
+  whenprocessingURIs
                                      • 
+
                                    1.8.6: Jan 31 2000
                                    • added a nanoFTP transport module, debugged until the new version of rpmfindcanuseit
+    without troubles
                                      • 
+
                                    1.8.5: Jan 21 2000
                                    • adding APIs to parse a well balanced chunk of XML (production [43] contentof
+    theXMLspec)
                                      • 
   
                                    • fixed a hideous bug in xmlGetProp pointed by Rune.Djurhuus@fast.no
                                      • 
-  
                                    • Jody Goldberg <jgoldberg@home.com> provided another patch trying
-    to solve the zlib checks problems
                                      • 
-  
                                    • The current state in gnome CVS base is expected to ship as 1.8.5 with
-    gnumeric soon
                                      • 
+  
                                    • Jody Goldberg <jgoldberg@home.com> provided another patchtryingto
+    solve the zlib checks problems
                                      • 
+  
                                    • The current state in gnome CVS base is expected to ship as
+    1.8.5withgnumeric soon
                                      • 
 
                                    1.8.4: Jan 13 2000
                                    • bug fixes, reintroduced xmlNewGlobalNs(), fixed xmlNewNs()
                                      • 
   
                                    • all exit() call should have been removed from libxml
                                      • 
   
                                    • fixed a problem with INCLUDE_WINSOCK on WIN32 platform
                                      • 
@@ -1191,52 +1209,52 @@ it's actually not compiled in by default. The real fixes are:
                                      • a coupl
   
                                      • fixed the DTD parsing code to work with the xhtml DTD
                                        • 
   
                                      • added xmlRemoveProp(), xmlRemoveID() and xmlRemoveRef()
                                        • 
   
                                      • Fixed bugs in xmlNewNs()
                                        • 
-  
                                      • External entity loading code has been revamped, now it uses
-    xmlLoadExternalEntity(), some fix on entities processing were added
                                        • 
+  
                                      • External entity loading code has been revamped, now
+    itusesxmlLoadExternalEntity(), some fix on entities processing
+  wereadded
                                        • 
   
                                      • cleaned up WIN32 includes of socket stuff
                                        • 
-
                                      1.8.2: Dec 21 1999
                                      • I got another problem with includes and C++, I hope this issue is fixed
-    for good this time
                                        • 
-  
                                      • Added a few tree modification functions: xmlReplaceNode,
-    xmlAddPrevSibling, xmlAddNextSibling, xmlNodeSetName and
-    xmlDocSetRootElement
                                        • 
+
                                      1.8.2: Dec 21 1999
                                      • I got another problem with includes and C++, I hope this issue
+    isfixedfor good this time
                                        • 
+  
                                      • Added a few tree modification
+    functions:xmlReplaceNode,xmlAddPrevSibling, xmlAddNextSibling,
+    xmlNodeSetNameandxmlDocSetRootElement
                                        • 
   
                                      • Tried to improve the HTML output with help from Chris Lahey
                                        • 
-
                                      1.8.1: Dec 18 1999
                                      • various patches to avoid troubles when using libxml with C++ compilers
-    the "namespace" keyword and C escaping in include files
                                        • 
+
                                      1.8.1: Dec 18 1999
                                      • various patches to avoid troubles when using libxml with
+    C++compilersthe "namespace" keyword and C escaping in include files
                                        • 
   
                                      • a problem in one of the core macros IS_CHAR was corrected
                                        • 
-  
                                      • fixed a bug introduced in 1.8.0 breaking default namespace processing,
-    and more specifically the Dia application
                                        • 
-  
                                      • fixed a posteriori validation (validation after parsing, or by using a
-    Dtd not specified in the original document)
                                        • 
+  
                                      • fixed a bug introduced in 1.8.0 breaking default
+    namespaceprocessing,and more specifically the Dia application
                                        • 
+  
                                      • fixed a posteriori validation (validation after parsing, or by
+    usingaDtd not specified in the original document)
                                        • 
   
                                      • fixed a bug in
                                        • 
 
                                      1.8.0: Dec 12 1999
                                      • cleanup, especially memory wise
                                        • 
-  
                                      • the parser should be more reliable, especially the HTML one, it should
-    not crash, whatever the input !
                                        • 
-  
                                      • Integrated various patches, especially a speedup improvement for large
-    dataset from Carl Nygard,
-    configure with --with-buffers to enable them.
                                        • 
+  
                                      • the parser should be more reliable, especially the HTML one,
+    itshouldnot crash, whatever the input !
                                        • 
+  
                                      • Integrated various patches, especially a speedup improvement
+    forlargedataset from CarlNygard,configure with
+    --with-buffers to enable them.
                                        • 
   
                                      • attribute normalization, oops should have been added long ago !
                                        • 
-  
                                      • attributes defaulted from DTDs should be available, xmlSetProp() now
-    does entities escaping by default.
                                        • 
+  
                                      • attributes defaulted from DTDs should be available, xmlSetProp()nowdoes
+    entities escaping by default.
                                        • 
 
                                      1.7.4: Oct 25 1999
                                      • Lots of HTML improvement
                                        • 
   
                                      • Fixed some errors when saving both XML and HTML
                                        • 
   
                                      • More examples, the regression tests should now look clean
                                        • 
   
                                      • Fixed a bug with contiguous charref
                                        • 
 
                                      1.7.3: Sep 29 1999
                                      • portability problems fixed
                                        • 
-  
                                      • snprintf was used unconditionally, leading to link problems on system
-    were it's not available, fixed
                                        • 
-
                                      1.7.1: Sep 24 1999
                                      • The basic type for strings manipulated by libxml has been renamed in
-    1.7.1 from CHAR to xmlChar. 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
-    #define .
                                        • 
-  
                                      • Changed another error : the use of a structure field called errno, and
-    leading to troubles on platforms where it's a macro
                                        • 
-
                                      1.7.0: Sep 23 1999
                                      • Added the ability to fetch remote DTD or parsed entities, see the nanohttp module.
                                        • 
-  
                                      • Added an errno to report errors by another mean than a simple printf
-    like callback
                                        • 
+  
                                      • snprintf was used unconditionally, leading to link problems
+    onsystemwere it's not available, fixed
                                        • 
+
                                      1.7.1: Sep 24 1999
                                      • The basic type for strings manipulated by libxml has been
+    renamedin1.7.1 from CHARto xmlChar.
+    Thereasonis that CHAR was conflicting with a predefined type on
+    Windows.Howeveron non WIN32 environment, compatibility is provided by the
+    way ofa#define .
                                        • 
+  
                                      • Changed another error : the use of a structure field called
+    errno,andleading to troubles on platforms where it's a macro
                                        • 
+
                                      1.7.0: Sep 23 1999
                                      • Added the ability to fetch remote DTD or parsed entities, see the nanohttpmodule.
                                        • 
+  
                                      • Added an errno to report errors by another mean than a simpleprintflike
+    callback
                                        • 
   
                                      • Finished ID/IDREF support and checking when validation
                                        • 
-  
                                      • Serious memory leaks fixed (there is now a memory wrapper module)
                                        • 
-  
                                      • Improvement of XPath
-    implementation
                                        • 
+  
                                      • Serious memory leaks fixed (there is now a memory wrappermodule)
                                        • 
+  
                                      • Improvement of XPathimplementation
                                        • 
   
                                      • Added an HTML parser front-end
                                        • 
 
                                      Daniel Veillard
                
diff --git a/doc/python.html b/doc/python.html
index 5910766..adb3d36 100644
--- a/doc/python.html
+++ b/doc/python.html
@@ -7,73 +7,66 @@ 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 }
-Python and bindings
                Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
                Made with Libxml2 Logo
                The XML C parser and toolkit of Gnome
                Python and bindings
                Developer Menu
                API Indexes
                Related links
                There are a number of language bindings and wrappers available for
-libxml2, the list below is not exhaustive. Please contact the xml-bindings@gnome.org
-(archives) in
-order to get updates to this list or to discuss the specific topic of libxml2
-or libxslt wrappers or bindings:
                • Libxml++ seems the
-    most up-to-date C++ bindings for libxml2, check the documentation
-    and the examples.
                  • 
-  
                • There is another C++ wrapper
-    based on the gdome2 bindings maintained by Tobias Peters.
                  • 
+Python and bindings
                  Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
                  Made with Libxml2 Logo
                  The XML C parser and toolkit of Gnome
                  Python and bindings
                  Developer Menu
                  API Indexes
                  Related links
                  There are a number of language bindings and wrappers available
+forlibxml2,the list below is not exhaustive. Please contact the xml-bindings@gnome.org(archives) inorder
+toget updates to this list or to discuss the specific topic of
+libxml2orlibxslt wrappers or bindings:
                  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.
                  Note that some of the Python purist dislike the default set of Python
-bindings, rather than complaining I suggest they have a look at lxml the more pythonic bindings for libxml2
-and libxslt and help Martijn
-Faassen complete those.
                  Stéphane Bidoul
-maintains a Windows port
-of the Python bindings.
                  Note to people interested in building bindings, the API is formalized as
-an XML API description file 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.
                  To install the Python bindings there are 2 options:
                  • If you use an RPM based distribution, simply install the libxml2-python
-    RPM (and if needed the libxslt-python
-    RPM).
                    • 
-  
                  • Otherwise use the libxml2-python
-    module distribution 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.
                    • 
-
                  The distribution includes a set of examples and regression tests for the
-python bindings in the python/tests directory. Here are some
-excerpts from those tests:
                  tst.py:
                  This is a basic test of the file interface and DOM navigation:
                  import libxml2, sys
+  
                • LibxmlJisaneffort
+    to create a 100% JAXP-compatible Java wrapper for libxml2andlibxslt as
+    part of GNU ClasspathX project.
                  • 
+  
                • Patrick McPhee provides Rexx bindings fof libxml2 and libxslt,
+    lookforRexxXML.
                  • 
+  
                • SatimageprovidesXMLLibosax.This
+    is an osax for Mac OS X with a set of commands toimplement inAppleScript
+    the XML DOM, XPATH and XSLT. Also includescommands forProperty-lists
+    (Apple's fast lookup table XML format.)
                  • 
+  
                • Francesco Montorsi developped wxXml2wrappersthat
+    interface libxml2, allowing wxWidgets applications toload/save/editXML
+    instances.
                  • 
+
                  The distribution includes a set of Python bindings, which are
+guaranteedtobe maintained as part of the library in the future, though
+thePythoninterface have not yet reached the completeness of the C API.
                  Note that some of the Python purist dislike the default set
+ofPythonbindings, rather than complaining I suggest they have a look at lxml the more pythonic bindings
+forlibxml2and libxsltand helpMartijnFaassencomplete
+those.
                  StéphaneBidoulmaintains aWindows portof the Python
+bindings.
                  Note to people interested in building bindings, the API is formalized asan XML API description filewhich allows
+toautomatea large part of the Python bindings, this includes
+functiondescriptions,enums, structures, typedefs, etc... The Python script
+used tobuild thebindings is python/generator.py in the source
+distribution.
                  To install the Python bindings there are 2 options:
                  • If you use an RPM based distribution, simply install the libxml2-pythonRPM(andif
+    needed the libxslt-pythonRPM).
                    • 
+  
                  • Otherwise use the libxml2-pythonmoduledistributioncorresponding
+    to your installed version oflibxml2 andlibxslt. Note that to install it
+    you will need both libxml2and libxsltinstalled and run "python setup.py
+    build install" in themodule tree.
                    • 
+
                  The distribution includes a set of examples and regression tests
+forthepython bindings in the python/testsdirectory. Here
+aresomeexcerpts from those tests:
                  tst.py:
                  This is a basic test of the file interface and DOM navigation:
                  import libxml2, sys
 
 doc = libxml2.parseFile("tst.xml")
 if doc.name != "tst.xml":
@@ -87,24 +80,25 @@ child = root.children
 if child.name != "foo":
     print "child.name failed"
     sys.exit(1)
-doc.freeDoc()
                  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:
                  • name : returns the node name
                    • 
-  
                  • type : returns a string indicating the node type
                    • 
-  
                  • content : returns the content of the node, it is based on
-    xmlNodeGetContent() and hence is recursive.
                    • 
-  
                  • parent , children, last,
-    next, prev, doc,
-    properties: pointing to the associated element in the tree,
-    those may return None in case no such link exists.
                    • 
-
                  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.
                  validate.py:
                  This test check the validation interfaces and redirection of error
-messages:
                  import libxml2
+doc.freeDoc()
                  The Python module is called libxml2; parseFile is the
+equivalentofxmlParseFile (most of the bindings are automatically generated,
+and thexmlprefix is removed and the casing convention are kept). All node
+seen atthebinding level share the same subset of accessors:
                  • name: returns the node name
                    • 
+  
                  • type: returns a string indicating the node type
                    • 
+  
                  • content: returns the content of the node, it is
+    basedonxmlNodeGetContent() and hence is recursive.
                    • 
+  
                  • parent,
+    children,last,next,
+    prev,doc,properties: pointing to
+    the associatedelement in the tree,those may return None in case no such
+    linkexists.
                    • 
+
                  Also note the need to explicitly deallocate documents with
+freeDoc().Reference counting for libxml2 trees would need quite a lot of
+worktofunction properly, and rather than risk memory leaks if
+notimplementedcorrectly it sounds safer to have an explicit function to free
+atree. Thewrapper python objects like doc, root or child are
+themautomatically garbagecollected.
                  validate.py:
                  This test check the validation interfaces and redirection
+oferrormessages:
                  import libxml2
 
 #deactivate error messages from the validation
 def noerr(ctx, str):
@@ -119,27 +113,29 @@ doc = ctxt.doc()
 valid = ctxt.isValid()
 doc.freeDoc()
 if valid != 0:
-    print "validity check failed"
                  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.
                  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.
                  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.
                  push.py:
                  This test show how to activate the push parser interface:
                  import libxml2
+    print "validity check failed"
                  The first thing to notice is the call to registerErrorHandler(),
+itdefinesa new error handler global to the library. It is used to avoid
+seeingtheerror messages when trying to validate the invalid document.
                  The main interest of that test is the creation of a parser
+contextwithcreateFileParserCtxt() and how the behaviour can be changed
+beforecallingparseDocument() . Similarly the informations resulting from
+theparsing phaseare also available using context methods.
                  Contexts like nodes are defined as class and the libxml2 wrappers mapstheC
+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 atthelibxml2.py
+module containing all the wrappers.
                  push.py:
                  This test show how to activate the push parser interface:
                  import libxml2
 
 ctxt = libxml2.createPushParser(None, "<foo", 4, "test.xml")
 ctxt.parseChunk("/>", 2, 1)
 doc = ctxt.doc()
 
-doc.freeDoc()
                  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.
                  Then the data are pushed using the parseChunk() method, the last call
-setting the third argument terminate to 1.
                  pushSAX.py:
                  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:
                  import libxml2
+doc.freeDoc()
                  The context is created with a special call based
+onthexmlCreatePushParser() from the C library. The first argument is
+anoptionalSAX callback object, then the initial set of data, the length and
+thename ofthe resource in case URI-References need to be computed by
+theparser.
                  Then the data are pushed using the parseChunk() method, the
+lastcallsetting the third argument terminate to 1.
                  pushSAX.py:
                  this test show the use of the event based parsing interfaces. In
+thiscasethe parser does not build a document, but provides callback
+informationasthe parser makes progresses analyzing the data being
+provided:
                  import libxml2
 log = ""
 
 class callback:
@@ -187,15 +183,16 @@ reference = "startDocument:startElement foo {'url': 'tst'}:" + \
             "characters: bar:endElement foo:endDocument:"
 if log != reference:
     print "Error got: %s" % log
-    print "Expected: %s" % reference
                  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.
                  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()
                  xpath.py:
                  This is a basic test of XPath wrappers support
                  import libxml2
+    print "Expected: %s" % reference
                  The key object in that test is the handler, it provides a number
+ofentrypoints which can be called by the parser as it makes progresses
+toindicatethe information set obtained. The full set of callback is larger
+thanwhatthe callback class in that specific example implements (see
+theSAXdefinition for a complete list). The wrapper will only call those
+suppliedbythe object when activated. The startElement receives the names of
+theelementand a dictionary containing the attributes carried by this
+element.
                  Also note that the reference string generated from the callback
+showsasingle character call even though the string "bar" is passed to
+theparserfrom 2 different call to parseChunk()
                  xpath.py:
                  This is a basic test of XPath wrappers support
                  import libxml2
 
 doc = libxml2.parseFile("tst.xml")
 ctxt = doc.xpathNewContext()
@@ -207,14 +204,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()
                  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.
                  xpathext.py:
                  This test shows how to extend the XPath engine with functions written in
-python:
                  import libxml2
+ctxt.xpathFreeContext()
                  This test parses a file, then create an XPath context to
+evaluateXPathexpression on it. The xpathEval() method execute an XPath query
+andreturnsthe result mapped in a Python way. String and numbers are
+nativelyconverted,and node sets are returned as a tuple of libxml2 Python
+nodeswrappers. Likethe document, the XPath context need to be freed
+explicitly,also not thatthe result of the XPath query may point back to the
+documenttree and hencethe document must be freed after the result of the
+query isused.
                  xpathext.py:
                  This test shows how to extend the XPath engine with functions
+writteninpython:
                  import libxml2
 
 def foo(ctx, x):
     return x + 1
@@ -226,9 +224,10 @@ res = ctxt.xpathEval("foo(1)")
 if res != 2:
     print "xpath extension failure"
 doc.freeDoc()
-ctxt.xpathFreeContext()
                  Note how the extension function is registered with the context (but that
-part is not yet finalized, this may change slightly in the future).
                  tstxpath.py:
                  This test is similar to the previous one but shows how the extension
-function can access the XPath evaluation context:
                  def foo(ctx, x):
+ctxt.xpathFreeContext()
                  Note how the extension function is registered with the context
+(butthatpart is not yet finalized, this may change slightly in the
+future).
                  tstxpath.py:
                  This test is similar to the previous one but shows how
+theextensionfunction can access the XPath evaluation context:
                  def foo(ctx, x):
     global called
 
     #
@@ -237,16 +236,16 @@ function can access the XPath evaluation context:
                  def foo(ctx, x):
     pctxt = libxml2.xpathParserContext(_obj=ctx)
     ctxt = pctxt.context()
     called = ctxt.function()
-    return x + 1
                  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.
                  Memory debugging:
                  last but not least, all tests starts with the following prologue:
                  #memory debug specific
+    return x + 1
                  All the interfaces around the XPath parser(or rather evaluation)contextare
+not finalized, but it should be sufficient to do contextual workat
+theevaluation point.
                  Memory debugging:
                  last but not least, all tests starts with the following prologue:
                  #memory debug specific
 libxml2.debugMemory(1)
                  and ends with the following epilogue:
                  #memory debug specific
 libxml2.cleanupParser()
 if libxml2.debugMemory(1) == 0:
     print "OK"
 else:
     print "Memory leak %d bytes" % (libxml2.debugMemory(1))
-    libxml2.dumpMemory()
                  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 .memdump file.
                  Daniel Veillard
                  
+    libxml2.dumpMemory()
                  Those activate the memory debugging interface of libxml2 whereallallocated
+block in the library are tracked. The prologue then cleans upthelibrary state
+and checks that all allocated memory has been freed. If notitcalls
+dumpMemory() which saves that list in a .memdumpfile.
                  Daniel Veillard
                
diff --git a/doc/threads.html b/doc/threads.html
index 8082dbd..e6fe497 100644
--- a/doc/threads.html
+++ b/doc/threads.html
@@ -7,15 +7,16 @@ 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 }
-Thread safety
                Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
                Made with Libxml2 Logo
                The XML C parser and toolkit of Gnome
                Thread safety
                Developer Menu
                API Indexes
                Related links
                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:
                • configure the library accordingly using the --with-threads options
                  • 
-  
                • call xmlInitParser() in the "main" thread before using any of the
-    libxml2 API (except possibly selecting a different memory allocator)
                  • 
-
                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 <libxml/threads.h>.
-The parts of the library checked for thread safety are:
                XPath is supposed to be thread safe now, but this
+wasn'ttestedseriously.
                Daniel Veillard
                
diff --git a/doc/tree.html b/doc/tree.html
index 6556637..238cd6d 100644
--- a/doc/tree.html
+++ b/doc/tree.html
@@ -7,22 +7,22 @@ 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 }
-The tree output
                Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
                Made with Libxml2 Logo
                The XML C parser and toolkit of Gnome
                The tree output
                Developer Menu
                API Indexes
                Related links
                The parser returns a tree built during the document analysis. The value
-returned is an xmlDocPtr (i.e., a pointer to an
-xmlDoc structure). This structure contains information such
-as the file name, the document type, and a children 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 xmlNodes,
-chained in double-linked lists of siblings and with a children<->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.
                Here is an example (erroneous with respect to the XML spec since there
-should be only one ELEMENT under the root):
                 structure.gif 
                In the source package there is a small program (not installed by default)
-called xmllint 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 --debug
-which prints the actual in-memory structure of the document; here is the
-result with the example given before:
                DOCUMENT
+The tree output
                Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
                Made with Libxml2 Logo
                The XML C parser and toolkit of Gnome
                The tree output
                Developer Menu
                API Indexes
                Related links
                The parser returns a tree built during the document analysis.
+Thevaluereturned is an xmlDocPtr(i.e., a pointer
+toanxmlDocstructure). This structure contains
+informationsuchas the file name, the document type, and
+achildrenpointerwhich is the root of the document (or
+moreexactly the first child under theroot which is the document). The tree
+ismade of xmlNodes,chained in double-linked lists of
+siblingsand with a children<->parentrelationship. An xmlNode can also
+carryproperties (a chain of xmlAttrstructures). An attribute may have a
+valuewhich is a list of TEXT orENTITY_REF nodes.
                Here is an example (erroneous with respect to the XML spec
+sincethereshould be only one ELEMENT under the root):
                 structure.gif 
                In the source package there is a small program (not installed
+bydefault)called xmllintwhich parses XML files given
+asargument andprints them back as parsed. This is useful for detecting
+errorsboth in XMLcode and in the XML parser itself. It has an
+option--debugwhich prints the actual in-memory structure of
+thedocument; here is theresult with the examplegivenbefore:
                DOCUMENT
 version=1.0
 standalone=true
   ELEMENT EXAMPLE
diff --git a/doc/upgrade.html b/doc/upgrade.html
index 59815ba..590b8a4 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 }
-Upgrading 1.x code
                Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
                Made with Libxml2 Logo
                The XML C parser and toolkit of Gnome
                Upgrading 1.x code
                Developer Menu
                API Indexes
                Related links
                Incompatible changes:
                Version 2 of libxml2 is the first version introducing serious backward
-incompatible changes. The main goals were:
                • 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.
                  • 
-  
                • 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.
                  • 
-  
                • 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.
                  • 
-
                How to fix libxml-1.x code:
                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, drop me a
-mail:
                1. 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
                  2. 
-  
                2. Node childs field has been renamed
-    children so s/childs/children/g should be  applied
-    (probability of having "childs" anywhere else is close to 0+
                  3. 
-  
                3. The document don't have anymore a root element it has
-    been replaced by children 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 xmlDocGetRootElement(doc) 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/->root/->children/g will probably do it.
                  4. 
-  
                4. 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:
-    
                  1. lazy one, use the compatibility call
-        xmlKeepBlanksDefault(0) 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.
                    2. 
-      
                  2. 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
-        xmlIsBlankNode(node) returning 1 for such blank
-        nodes.
                    3. 
-    
                  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.
                  
+Upgrading 1.x code
                  Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
                  Made with Libxml2 Logo
                  The XML C parser and toolkit of Gnome
                  Upgrading 1.x code
                  Developer Menu
                  API Indexes
                  Related links
                  Incompatible changes:
                  Version 2 of libxml2 is the first version introducing
+seriousbackwardincompatible changes. The main goals were:
                  • a general cleanup. A number of mistakes inherited from the
+    veryearlyversions couldn't be changed due to compatibility
+    constraints.Examplethe "childs" element in the nodes.
                    • 
+  
                  • Uniformization of the various nodes, at least for their header
+    andlinkparts (doc, parent, children, prev, next), the goal is
+    asimplerprogramming model and simplifying the task of the
+  DOMimplementors.
                    • 
+  
                  • better conformances to the XML specification, for example version1.xhad
+    an heuristic to try to detect ignorable white spaces. As a resulttheSAX
+    event generated were ignorableWhitespace() while the
+    specrequirescharacter() in that case. This also mean that a number of
+    DOMnodecontaining blank text may populate the DOM tree which were
+    notpresentbefore.
                    • 
+
                  How to fix libxml-1.x code:
                  So client code of libxml designed to run with version 1.x may have
+tobechanged to compile against version 2.x of libxml. Here is a list
+ofchangesthat I have collected, they may not be sufficient, so in case you
+findotherchange which are required, dropme amail:
                  1. The package name have changed from libxml to libxml2, the librarynameis
+    now -lxml2 . There is a new xml2-config script which should beused
+    toselect the right parameters libxml2
                    2. 
+  
                  2. Node childsfield has
+    beenrenamedchildrenso s/childs/children/g should
+    beapplied(probability of having "childs" anywhere else is close to 0+
                    3. 
+  
                  3. The document don't have anymore a rootelement
+    ithasbeen replaced by childrenand usually you will
+    getalist of element here. For example a Dtd element for the
+    internalsubsetand it's declaration may be found in that list, as well
+    asprocessinginstructions or comments found before or after the
+    documentroot element.Use xmlDocGetRootElement(doc)to get
+    theroot element ofa document. Alternatively if you are sure to not
+    referenceDTDs nor havePIs or comments before or after the
+    rootelements/->root/->children/g will probably do it.
                    4. 
+  
                  4. The white space issue, this one is more complex, unless special
+    caseofvalidating parsing, the line breaks and spaces usually used
+    forindentingand formatting the document content becomes significant. So
+    theyarereported by SAX and if your using the DOM tree, corresponding
+    nodesaregenerated. Too approach can be taken:
+    
                    1. lazy one, use the
+        compatibilitycallxmlKeepBlanksDefault(0)but be aware
+        that youarerelying on a special (and possibly broken) set of
+        heuristicsoflibxml to detect ignorable blanks. Don't complain if it
+        breaksormake your application not 100% clean w.r.t. to it's
+      input.
                      2. 
+      
                    2. the Right Way: change you code to accept
+        possiblyinsignificantblanks characters, or have your tree populated
+        withweird blank textnodes. You can spot them using the
+        commodityfunctionxmlIsBlankNode(node)returning 1 for
+        suchblanknodes.
                      3. 
+    
                    Note also that with the new default the output functions don't
+    addanyextra indentation when saving a tree in order to be able to
+    roundtrip(read and save) without inflating the document with
+    extraformattingchars.
                    
   
                    5. 
-  
                  5. 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
+  
                  6. The include path has changed to $prefix/libxml/ and
+    theincludesthemselves uses this new prefix in includes instructions...
+    Ifyou areusing (as expected) the
     
                    xml2-config --cflags
                    
-    
                    output to generate you compile commands this will probably work out of
-    the box
                    
+    
                    output to generate you compile commands this will probably work
+    outofthe box
                    
   
                    7. 
-  
                  7. xmlDetectCharEncoding takes an extra argument indicating the length in
-    byte of the head of the document available for character detection.
                    8. 
-
                  Ensuring both libxml-1.x and libxml-2.x compatibility
                  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:
                  1. similar include naming, one should use
-    #include<libxml/...> in both cases.
                    2. 
-  
                  2. similar identifiers defined via macros for the child and root fields:
-    respectively xmlChildrenNode and
-    xmlRootNode
                    3. 
-  
                  3. a new macro LIBXML_TEST_VERSION which should be
-    inserted once in the client code
                    4. 
-
                  So the roadmap to upgrade your existing libxml applications is the
-following:
                  1. install the  libxml-1.8.8 (and libxml-devel-1.8.8) packages
                    2. 
-  
                  2. find all occurrences where the xmlDoc root field is
-    used and change it to xmlRootNode
                    3. 
-  
                  3. similarly find all occurrences where the xmlNode
-    childs field is used and change it to
-    xmlChildrenNode
                    4. 
-  
                  4. add a LIBXML_TEST_VERSION macro somewhere in your
-    main() or in the library init entry point
                    5. 
+  
                  5. xmlDetectCharEncoding takes an extra argument indicating the
+    lengthinbyte of the head of the document available for character
+    detection.
                    6. 
+
                  Ensuring both libxml-1.x and libxml-2.x compatibility
                  Two new version of libxml (1.8.11) and libxml2 (2.3.4) have beenreleasedto
+allow smooth upgrade of existing libxml v1code whileretainingcompatibility.
+They offers the following:
                  1. similar include naming, one
+    shoulduse#include<libxml/...>in both cases.
                    2. 
+  
                  2. similar identifiers defined via macros for the child and
+    rootfields:respectivelyxmlChildrenNodeandxmlRootNode
                    3. 
+  
                  3. a new macro LIBXML_TEST_VERSIONwhich should
+    beinsertedonce in the client code
                    4. 
+
                  So the roadmap to upgrade your existing libxml applications
+isthefollowing:
                  1. install the  libxml-1.8.8 (and libxml-devel-1.8.8) packages
                    2. 
+  
                  2. find all occurrences where the xmlDoc rootfield
+    isusedand change it to xmlRootNode
                    3. 
+  
                  3. similarly find all occurrences where
+    thexmlNodechildsfield is used and change
+    ittoxmlChildrenNode
                    4. 
+  
                  4. add a LIBXML_TEST_VERSIONmacro somewhere
+    inyourmain()or in the library init entry point
                    5. 
   
                  5. Recompile, check compatibility, it should still work
                    6. 
-  
                  6. 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.
                    7. 
-  
                  7. 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)
                    8. 
-  
                  8. remove your config.cache, relaunch your configuration mechanism, and
-    recompile, if steps 2 and 3 were done right it should compile as-is
                    9. 
-  
                  9. 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
-    LIBXML_TEST_VERSION is a fine place).
                    10. 
-
                  Following those steps should work. It worked for some of my own code.
                  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 ...
                  Daniel Veillard
                  
+  
                5. Change your configure script to look first for xml2-config and
+    fallbackusing xml-config . Use the --cflags and --libs output of the
+    commandasthe Include and Linking parameters needed to use libxml.
                  6. 
+  
                6. install libxml2-2.3.x and  libxml2-devel-2.3.x
+    (libxml-1.8.yandlibxml-devel-1.8.y can be kept simultaneously)
                  7. 
+  
                7. remove your config.cache, relaunch your configuration
+    mechanism,andrecompile, if steps 2 and 3 were done right it should
+    compileas-is
                  8. 
+  
                8. Test that your application is still running correctly, if not thismaybe
+    due to extra empty nodes due to formating spaces being kept
+    inlibxml2contrary to libxml1, in that case insert
+    xmlKeepBlanksDefault(1)in yourcode before calling the parser
+    (nexttoLIBXML_TEST_VERSIONis a fine place).
                  9. 
+
                Following those steps should work. It worked for some of my own code.
                Let me put some emphasis on the fact that there is far more
+changesfromlibxml 1.x to 2.x than the ones you may have to patch for. The
+overallcodehas been considerably cleaned up and the conformance to the
+XMLspecificationhas been drastically improved too. Don't take those changes
+asan excuse tonot upgrade, it may cost a lot on the long term ...
                Daniel Veillard
                
diff --git a/doc/xml.html b/doc/xml.html
index e013dcc..72a0a9c 100644
--- a/doc/xml.html
+++ b/doc/xml.html
@@ -3,42 +3,42 @@
 
 
   The XML C parser and toolkit of Gnome
-  
-  
+  
+  
 
 
 
 
                The XML C parser and toolkit of Gnome
                
 
-
                Note: this is the flat content of the web
-site
                
+
                Note: this is the flat content of the website
                
 
 
                libxml, a.k.a. gnome-xml
                
 
 
                
 
 
                "Programming
-with libxml2 is like the thrilling embrace of an exotic stranger." Mark
-Pilgrim
                
-
-
                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 MIT
-License. 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 variety of language bindings make it available in
-other environments.
                
-
-
                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, ...)
                
-
-
                Libxml2 implements a number of existing standards related to markup
-languages:
                
+style="text-align: right; font-style: italic; font-size: 10pt">"Programmingwithlibxml2
+is like the thrilling embrace of an exotic stranger." MarkPilgrim
                
+
+
                Libxml2 is the XML C parser and toolkit developed for the Gnomeproject(but
+usable outside of the Gnome platform), it is free softwareavailableunder the
+MITLicense.XML
+itself is a metalanguage to design markup languages, i.e.text languagewhere
+semantic and structure are added to the content usingextra
+"markup"information enclosed between angle brackets. HTML is the
+mostwell-knownmarkup language. Though the library is written in C avariety of language bindingsmake it available inother
+environments.
                
+
+
                Libxml2 is known to be very portable, the library should build
+andworkwithout serious troubles on a variety of systems (Linux,
+Unix,Windows,CygWin, MacOS, MacOS X, RISC Os, OS/2, VMS, QNX, MVS, ...)
                
+
+
                Libxml2 implements a number of existing standards related
+tomarkuplanguages:
                
 
 
-
                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 OASIS XML Tests
-Suite.
                
+
                In most cases libxml2 tries to implement the specifications in
+arelativelystrictly compliant way. As of release 2.4.16, libxml2 passed
+all1800+ testsfrom the OASIS
+XMLTestsSuite.
                
 
-
                To some extent libxml2 provides support for the following additional
-specifications but doesn't claim to implement them completely:
                
+
                To some extent libxml2 provides support for the
+followingadditionalspecifications but doesn't claim to implement them
+completely:
                
 
                  
   
                • Document Object Model (DOM) http://www.w3.org/TR/DOM-Level-2-Core/
-    the document model, but it doesn't implement the API itself, gdome2 does
-    this on top of libxml2
                  • 
-  
                • RFC 959 :
-    libxml2 implements a basic FTP client code
                  • 
-  
                • RFC 1945 :
-    HTTP/1.0, again a basic HTTP client code
                  • 
-  
                • SAX: a SAX2 like interface and a minimal SAX1 implementation compatible
-    with early expat versions
                  • 
+    href="http://www.w3.org/TR/DOM-Level-2-Core/">http://www.w3.org/TR/DOM-Level-2-Core/thedocument
+    model, but it doesn't implement the API itself, gdome2 doesthison top of
+    libxml2
+  
                • RFC959:libxml2
+    implements a basic FTP client code
                  • 
+  
                • RFC1945:HTTP/1.0,
+    again a basic HTTP client code
                  • 
+  
                • SAX: a SAX2 like interface and a minimal SAX1
+    implementationcompatiblewith early expat versions
                  • 
 
                
 
 
                A partial implementation of XML Schemas Part
-1: Structure is being worked on but it would be far too early to make any
-conformance statement about it at the moment.
                
+href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/">XML Schemas
+Part1:Structureis being worked on but it would be far too early to
+makeanyconformance statement about it at the moment.
                
 
 
                Separate documents: