diff --git a/ChangeLog b/ChangeLog index c9eca016..3a3a8f12 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Tue Jun 6 15:19:57 CEST 2006 Daniel Veillard + + * 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 diff --git a/configure.in b/configure.in index cb9e0b1d..7fbacfbe 100644 --- a/configure.in +++ b/configure.in @@ -5,7 +5,7 @@ AC_CANONICAL_HOST LIBXML_MAJOR_VERSION=2 LIBXML_MINOR_VERSION=6 -LIBXML_MICRO_VERSION=24 +LIBXML_MICRO_VERSION=25 LIBXML_MICRO_VERSION_SUFFIX= LIBXML_VERSION=$LIBXML_MAJOR_VERSION.$LIBXML_MINOR_VERSION.$LIBXML_MICRO_VERSION$LIBXML_MICRO_VERSION_SUFFIX LIBXML_VERSION_INFO=`expr $LIBXML_MAJOR_VERSION + $LIBXML_MINOR_VERSION`:$LIBXML_MICRO_VERSION:$LIBXML_MINOR_VERSION diff --git a/doc/APIchunk1.html b/doc/APIchunk1.html index ca14e32b..7c9ff725 100644 --- a/doc/APIchunk1.html +++ b/doc/APIchunk1.html @@ -81,6 +81,7 @@ A:link, A:visited, A:active { text-decoration: underline }
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 c2e8d33c..0486624d 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 8f93a9f7..1c552b14 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 96643e35..5980cc29 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 eb1716e6..f5134af2 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 8b51338d..4ac0a55a 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 892cf527..071403e8 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 0cde864b..8541fe1a 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 8817d3c7..f503ffe8 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 dec83506..f4c83216 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 ebbea9a0..4a782246 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 fa596f61..6ac493b1 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/APIchunk5.html b/doc/APIchunk5.html index dbc12b16..3ebc5a88 100644 --- a/doc/APIchunk5.html +++ b/doc/APIchunk5.html @@ -71,6 +71,7 @@ A:link, A:visited, A:active { text-decoration: underline }
Optional
_htmlElemDesc
Oriya
xmlUCSIsOriya
Osmanya
xmlUCSIsOsmanya
+
Other
xmlXPathContextSetCache
Otherwise
xmlStreamPush
xmlStreamPushAttr
Output
xmlOutputCloseCallback
diff --git a/doc/APIchunk8.html b/doc/APIchunk8.html index 87c07a43..82de64be 100644 --- a/doc/APIchunk8.html +++ b/doc/APIchunk8.html @@ -114,6 +114,7 @@ A:link, A:visited, A:active { text-decoration: underline } 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 2de70cc0..2a5af4b6 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 042bc3a2..92489fb0 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 cc7019a7..7e1ba3c4 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 52f11392..0a477704 100644 --- a/doc/DOM.html +++ b/doc/DOM.html @@ -7,11 +7,10 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 DocumentObject +Model; this is an API for accessing XML or HTML structureddocuments. +Native support for DOM in Gnome is on the way (module gnome-dom),and will be +based on gnome-xml. This will be a far cleaner interface tomanipulate XML +files within Gnome since it won't expose the internalstructure.

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

Daniel Veillard

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

  • 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 changes + youmade to libxml, but it would be graceful to send-back bug fixes + andimprovements as patches for possible incorporation in the + maindevelopment tree.

    3. -

    Installation

    1. Do Not Use - libxml1, use libxml2
    2. -
    3. 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 Not + Uselibxml1, use libxml2
    2. +
    3. Where can I get libxml? +

      The original distribution comes from xmlsoft.orgor gnome.org

      +

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

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

    4. 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 issues + withexisting applications, install libxml2 only
        • +
        • If you are not doing development, you can safely install + both.Usually the packages libxmland libxml2arecompatible + (this is not the case for development packages).
        • +
        • If you are a developer and your system provides separate + packagingfor shared libraries and the development components, it is + possibleto install libxml and libxml2, and also libxml-develand + libxml2-develtoo + for libxml2 >= 2.3.0
        • +
        • If you are developing a new application, please develop + againstlibxml2(-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 the + sharedlibrary for libxml.so.0, you can probably safely remove it. The + libxmlpackages 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 to + faileddependencies +

        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 to + buildapplications 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 +67,107 @@ 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 utility + toupdate 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 ANSI + APIshould be sufficient (please report any violation to this rule you + mayfind).

        +

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

        +
        • libz: + ahighly portable and available widely compression library.
        • +
        • iconv: a powerful character encoding conversion library. It + isincluded by default in recent glibc libraries, so it doesn't need + tobe installed specifically on Linux. It now seems a partof + the official UNIXspecification. Here is one implementation of + thelibrarywhich 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 match + thevalue produced by the parser, and the makefile uses diff to print + thedelta. On some platforms the diff return breaks the compilation + process;if the diff is small this is probably not a serious problem.

        +

        Sometimes (especially on Solaris) make checks fail due to + limitationsin 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. Use + theautogen.sh script to regenerate the configure script and + Makefiles,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 with + theoptimizer which miscompiles the URI module. Please use + anothercompiler.

      • -

    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't + getthe right compilation or linking flags. There is a small shell + scriptxml2-configwhich is installed as part of libxml2 + usualinstall 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 from + theMakefile as:

      CFLAGS=`xml2-config --cflags`

      LIBS=`xml2-config --libs`

    2. -
    3. 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:

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

      There are many different ways to accomplish this. Here is one way + todo 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 subdirectory + in/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 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

        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 it + tothe beginning of your default PATH (so that your own private + programfiles such as xmllint will be used instead of the normal + systemones). To do this, the Bash command would be

        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 you + wouldlike to compile with your "private" library. Simply compile it + usingthe 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, the + xml2-configprogram which you just installed will be used instead of + the systemdefault one, and this will automaticallyget the + correctlibraries linked with your program.
    5. 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 of + adocument since all spaces in the content of a document + aresignificant. If you build a tree from the API and + wantindentation:

      1. the correct way is to generate those yourself too.
      2. -
      3. 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 - ()
      4. +
      5. the dangerous way is to ask libxml2 to add those blanks to + yourcontent modifying the content of your document in + theprocess. The result may not be what you expect. There + isNOway to guarantee that such a modification + won'taffect other parts of the content of your document. See xmlKeepBlanksDefault()and + xmlSaveFormatFile()
    6. Extra nodes in the document:

      For a XML file as below:

      @@ -180,10 +176,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 the + functionpxmlDoc=xmlParseFile(...);

      +

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

      so I did it as following;

      xmlNodePtr pnode;
       pnode=pxmlDoc->children->children;
      @@ -191,63 +187,64 @@ 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 are + significantincluding blanks and formatting line + breaks.

      +

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

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

      +
    9. I get compilation errors of existing code like when + accessingrootor child fieldsof + nodes. +

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

    10. -
    11. 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

      +
    12. I get compilation errors about non + existingxmlRootNodeor + xmlChildrenNodefields. +

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

    13. 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 toa + recent version, there are no known bugs in the current version.

    14. 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 the + code<grin/> ...

      +

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

    15. -
    16. 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 on + theweb page? +

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

        +
        • check more deeply the existinggenerated doc
        • +
        • have a look at the set + ofexamples.
        • +
        • look for examples of use for libxml2 function using the Gnome + code.For example the following will query the full Gnome CVS base for + theuse of the 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 gnome + projectcould 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.
        • +
        • Browsethe + libxml2 source, I try to write code as clean and documentedas + possible, so looking at it may be helpful. In particular the codeof + xmllint.c and of the various testXXX.c test programs shouldprovide + good examples of how to do things with the library.
      • 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 a + numberof platforms, including embedded systems. I don't intend to convert + toC++.

        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 validated + atinitial parsing time or documents which have been built from + scratchusing 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 +273,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 only + utf-8!You need to convert strings encoded in different ways to utf-8 + beforepassing them to the API. This can be accomplished with the iconv + libraryfor instance.

      • etc ...

    Daniel Veillard

    diff --git a/doc/XMLinfo.html b/doc/XMLinfo.html index 474f9c1c..347f4002 100644 --- a/doc/XMLinfo.html +++ b/doc/XMLinfo.html @@ -7,9 +7,8 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 a +standardformarkup-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 +19,16 @@ 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 gives +usefulinformation about its encoding. Then the rest of the document is a +textformat 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 the +opening andclosing tag if it ends with />rather than +with>. 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 fromlong +term structured document maintenance (where it follows the steps ofSGML) to +simple data encoding mechanisms like configuration file formatting(glade), +spreadsheets (gnumeric), or even shorter lived documents such asWebDAV where +it is used to encode remote calls between a client and aserver.

    Daniel Veillard

    diff --git a/doc/XSLT.html b/doc/XSLT.html index 657ead30..29385d99 100644 --- a/doc/XSLT.html +++ b/doc/XSLT.html @@ -7,7 +7,7 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 alanguage +for transforming XML documents into other XML documents (orHTML/textual +output).

    A separate library called libxslt is available implementing XSLT-1.0 +forlibxml2. 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 906c5b2d..9623bb39 100644 --- a/doc/architecture.html +++ b/doc/architecture.html @@ -7,8 +7,8 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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, andmost +of 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 6415c85b..e69f3edb 100644 --- a/doc/bugs.html +++ b/doc/bugs.html @@ -7,62 +7,60 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 apoint +of fixing them in a timely fashion. The best way to report a bug is touse the +Gnomebug +tracking database(make sure to use the "libxml2" module name). Ilook at +reports there regularly and it's good to have a reminder when a bugis still +open. Be sure to specify that the bug is for the package libxml2.

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

      There is also a mailing-list xml@gnome.orgfor libxml, with an on-line archive(old). To subscribe to this list,please +visit the associated +Webpage andfollow 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 mailto +the list without being subscribed won't work. There is *far too manybounces* +(in the order of a thousand a day !) I cannot approve them manuallyanymore. +If your mail to the list bounced waiting for administrator approval,it is +LOST ! Repost it and fix the problem triggering the error. Also pleasenote +that emails witha +legal warning asking to not copy or redistribute freely the informationsthey +containare NOTacceptable for the mailing-list,such +mail will as much as possible be discarded automatically, and are lesslikely +to be answered if they made it to the list, DO NOTpost to +the list from an email address where such legal requirements areautomatically +added, get private paying support if you can't shareinformations.

      Check the following beforeposting:

      • Read the FAQand use + thesearch engineto get information related to your problem.
      • +
      • Make sure you are using a + recentversion, and that the problem still shows up in a recent + version.
      • +
      • Check the listarchivesto see if the + problem was reported already. In this casethere is probably a fix + available, similarly check the registeredopen + bugs.
      • +
      • Make sure you can reproduce the bug with xmllint or one of the + testprograms found in source in the distribution.
      • +
      • Please send the command showing the error as well as the input (as + anattachment)
      • +

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

      To be really clear about support:

      • Support or help requests MUST be sent + tothe list or on bugzillain case of problems, so that the + Questionand Answers can be shared publicly. Failing to do so carries the + implicitmessage "I want free support but I don't want to share the + benefits withothers" and is not welcome. I will automatically Carbon-Copy + thexml@gnome.org mailing list for any technical reply made about libxml2 + orlibxslt.
      • +
      • There is no garantee of support, + ifyour question remains unanswered after a week, repost it, making sure + yougave all the detail needed and the information requested.
      • +
      • Failing to provide information as requested or double checking firstfor + prior feedback also carries the implicit message "the time of thelibrary + maintainers is less valuable than my time" and might not bewelcome.
      • +

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

      If you're looking for help, a quick look at the list archivemay +actuallyprovide the answer. I usually send source samples when answering +libxml2usage questions. The auto-generated +documentationisnot as polished as I would like (i need to learn more +about DocBook), butit's a good starting point.

      Daniel Veillard

      diff --git a/doc/catalog.html b/doc/catalog.html index 4100fed9..435990e5 100644 --- a/doc/catalog.html +++ b/doc/catalog.html @@ -14,77 +14,77 @@ A:link, A:visited, A:active { text-decoration: underline }
    • 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 of + theAPI
    • 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(a +file or a remote resource) references another entity. The catalog lookupis +inserted between the moment the reference is recognized by the software(XML +parser, stylesheet processing, or even images referenced for inclusionin a +rendering) and the time where loading that resource is actuallystarted.

        It is basically used for 3 things:

        • mapping from "logical" names, the public identifiers and a moreconcrete + name usable for download (and URI). For example it can associatethe + logical 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 can + bedownloaded

          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 HTTP + indirectionsaying 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 the + entitiesassociated to public identifiers or remote resources, this is a + reallyimportant feature for any significant deployment of XML or SGML + since itallows to avoid the aleas and delays associated to fetching + remoteresources.
      • +

      The definitions

      Libxml, as of 2.4.3 implements 2 kind of catalogs:

      • the older SGML catalogs, the official spec is SGML Open + TechnicalResolution TR9401:1997, but is better understood by reading the SP Catalog + pagefromJames Clark. This is relatively old and not the preferred + mode ofoperation of libxml.
      • +
      • XMLCatalogsis + far more flexible, more recent, uses an XML syntax andshould scale quite + better. This is the default option of libxml.
      • +

      Using catalog

      In a normal environment libxml2 will by default check the presence of +acatalog in /etc/xml/catalog, and assuming it has been correctly +populated,the processing is completely transparent to the document user. To +take aconcrete example, suppose you are authoring a DocBook document, this +onestarts with the following DOCTYPE definition:

      <?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 beautomatically +consulted to lookup the public identifier "-//Norman Walsh//DTDDocBk XML +V3.1.4//EN" and the system +identifier"http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd", and if these +entities havebeen installed on your system and the catalogs actually point to +them, libxmlwill fetch them from the local disk.

      Note: Really don't use +thisDOCTYPE 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 +anentity, this includes DTD, external parsed entities, stylesheets, etc ... +Ifyour system is correctly configured all the authoring phase and +processingshould use only local files, even if your document stays portable +because ituses the canonical public and system ID, referencing the remote +document.

      Some examples:

      Here is a couple of fragments from XML Catalogs used in libxml2 +earlyregression 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 Catalogs +arewritten in XML, there is a specific namespace for catalog +elements"urn:oasis:names:tc:entity:xmlns:xml:catalog". The first entry in +thiscatalog is a publicmapping it allows to associate a +PublicIdentifier 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 says +thatany URI starting with a given prefix should be looked at another +URIconstructed by replacing the prefix with an new one. In effect this acts +likea cache system for a full area of the Web. In practice it is extremely +usefulwith a file prefix if you have installed a copy of those resources on +yourlocal system.

      ...
       <delegatePublic publicIdStartString="-//OASIS//DTD XML Catalog //"
                       catalog="file:///usr/share/xml/docbook.xml"/>
       <delegatePublic publicIdStartString="-//OASIS//ENTITIES DocBook XML"
      @@ -95,21 +95,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 of +catalogs,easier to maintain than a single catalog, based on Public +Identifier, SystemIdentifier or URI prefixes it instructs the catalog +software to look upentries in another resource. This feature allow to build +hierarchies ofcatalogs, the set of entries presented should be sufficient to +redirect theresolution of all DocBook references to the specific catalog +in/usr/share/xml/docbook.xmlthis one in turn could delegate +allreferences for DocBook 4.2.1 to a specific catalog installed at the same +timeas the DocBook resources on the local machine.

      How to tune catalog usage:

      The user can change the default catalog behaviour by redirecting queriesto +its own set of catalogs, this can be done by setting +theXML_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 willmake +libxml2 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 +117,26 @@ Failed to parse catalog /etc/xml/catalog
       Failed to parse catalog /etc/xml/catalog
       warning: failed to load external entity "title.xml"
       Catalogs cleanup
      -orchis:~/XML -> 

      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 memory +makesthe base URI unavailable and the the "title.xml" entity cannot be +loaded.Setting up the debug environment variable allows to detect that an +attempt ismade to load the /etc/xml/catalogbut since it's not +present theresolution fails.

      But the most advanced way to debug XML catalog processing is to use +thexmlcatalogcommand shipped with libxml2, it allows to +loadcatalogs and make resolution queries to see what is going on. This is +alsoused 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 the +verbositylevel to indicate the processing done (adding a second flag also +indicatewhat 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 multiple +queries(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 +152,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 was +actuallyused heavily to debug the XML Catalog implementation itself.

      How to create and maintaincatalogs:

      Basically XML Catalogs are XML files, you can either use XML tools +tomanage them or use xmlcatalogfor this. The basic step +isto 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 save +theresult on the standard output, this can be overridden using the +-nooutoption. The -addcommand allows to add entries in +thecatalog:

      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 +174,82 @@ 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 some +ofthe XML Catalog constructs (like nextCatalog) will have only a +singleargument, just pass a third empty string, it will be ignored.

      Similarly the -deloption remove matching entries from +thecatalog:

      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 the +Public IDstring.

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

      The implementor corner quick review of +theAPI:

      First, and like for every other module of libxml, there is anautomatically +generated API page forcatalog +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 +thatapplications really need access to it since it is the default behaviour +oflibxml2 (Note: it is possible to completely override libxml2 default +catalogby using xmlSetExternalEntityLoadertoplug 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 + theoasis-xml-catalogPIs to specify its own catalog list, it + isassociated to the parser context and destroyed when the parsing + contextis destroyed.
      • +

      the document one will be used first if it exists.

      Initialization routines:

      xmlInitializeCatalog(), xmlLoadCatalog() and xmlLoadCatalogs() should +beused at startup to initialize the catalog, if the catalog should +beinitialized with specific values xmlLoadCatalog() or +xmlLoadCatalogs()should be called before xmlInitializeCatalog() which would +otherwise do adefault initialization first.

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

      Preferences setup:

      The XML Catalog spec requires the possibility to select defaultpreferences +between public and system delegation,xmlCatalogSetDefaultPrefer() allows +this, xmlCatalogSetDefaults() andxmlCatalogGetDefaults() allow to control if +XML Catalogs resolution shouldbe forbidden, allowed for global catalog, for +document catalog or both, thedefault is to allow both.

      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 XMLCatalog specification they correspond to section 7 +algorithms, they shouldalso work if you have loaded an SGML catalog with a +simplified semantic.

      xmlCatalogLocalResolve() and xmlCatalogLocalResolveURI() are the same +butoperate 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 modify +thefirst catalog in the global list, and xmlCatalogDump() allows to dump +acatalog state, those routines are primarily designed for xmlcatalog, I'm +notsure that exposing more complex interfaces (like navigation ones) would +bereally useful.

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

      threaded environments:

      Since the catalog tree is built progressively, some care has been taken +totry to avoid troubles in multithreaded environments. The code is now +threadsafe assuming that the libxml2 library has been compiled with +threadssupport.

      Other resources

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

      • You can find a good rant from Norm Walsh about theneed + for catalogs, it provides a lot of context informations even ifI + don't agree with everything presented. Norm also wrote a more + recentarticle XMLentities + and URI resolversdescribing them.
      • +
      • An old + XMLcatalog proposalfrom John Cowan
      • +
      • The Resource Directory + DescriptionLanguage(RDDL) another catalog system but more oriented + towardproviding metadata for XML namespaces.
      • +
      • the page from the OASIS Technical Committee on + EntityResolutionwho maintains XML Catalog, you will find pointers to + thespecification update, some background and pointers to others + toolsproviding XML Catalog support
      • +
      • There is a shell scriptto generateXML + Catalogs for DocBook 4.1.2 . If it can write to the /etc/xml/directory, + it will set-up /etc/xml/catalog and /etc/xml/docbook based onthe + resources found on the system. Otherwise it will just create~/xmlcatalog + and ~/dbkxmlcatalog and doing:

        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 without + requiringnetwork 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 asmall + tarballcontaining XML Catalogs for DocBook 4.1.2 which seemsto work + fine for me too
  • +
  • The xmlcatalogmanual + page
  • +

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

    Daniel Veillard

    diff --git a/doc/contribs.html b/doc/contribs.html index e493eb3b..8f1abb3b 100644 --- a/doc/contribs.html +++ b/doc/contribs.html @@ -7,34 +7,33 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 d0eb4770..7545da48 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 4d1a4ccf..f3fe7a67 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 ca79c03f..e0af8368 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 4c5fe555..49b86d9a 100644 --- a/doc/docs.html +++ b/doc/docs.html @@ -7,27 +7,25 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 look + upinformation.
        2. Check the FAQ.
        3. -
        4. Check the extensive - documentation automatically extracted from code comments.
        5. -
        6. Look at the documentation about libxml - internationalization support.
        7. -
        8. This page provides a global overview and some - examples on how to use libxml.
        9. +
        10. Check the extensivedocumentationautomatically + extracted from code comments.
        11. +
        12. Look at the documentation about libxmlinternationalization support.
        13. +
        14. This page provides a global overview and someexampleson how to use libxml.
        15. Code examples
        16. -
        17. John Fleck's libxml2 tutorial: html - or pdf.
        18. -
        19. If you need to parse large files, check the xmlReader API tutorial
        20. -
        21. James Henstridge wrote some nice - documentation explaining how to use the libxml SAX interface.
        22. -
        23. George Lebl wrote an article - for IBM developerWorks about using libxml.
        24. -
        25. Check the TODO - file.
        26. -
        27. 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.
        28. +
        29. John Fleck's libxml2 tutorial: htmlor + pdf.
        30. +
        31. If you need to parse large files, check the xmlReaderAPI tutorial
        32. +
        33. James Henstridgewrote some + nicedocumentationexplaining how to use the libxml SAX interface.
        34. +
        35. George Lebl wrote an + articlefor IBM developerWorksabout using libxml.
        36. +
        37. Check the + TODOfile.
        38. +
        39. Read the 1.x to 2.x upgrade pathdescription. + If you are starting a new project using libxml you shouldreally use the + 2.x version.
        40. And don't forget to look at the mailing-list archive.

        Daniel Veillard

        diff --git a/doc/downloads.html b/doc/downloads.html index e49f4835..d12420eb 100644 --- a/doc/downloads.html +++ b/doc/downloads.html @@ -7,30 +7,30 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 is +alsomirrors (Australia( +Web), France) or on the Gnome FTP serveras source archive, +Antonin Sprinzl also provide amirror in Austria. (NOTE that +you need both the libxml(2)and libxml(2)-develpackages +installed to compile applications using libxml.)

          You can find all the history of libxml(2) and libxslt releases in the olddirectory. The +precompiledWindows 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 on +anotherplatform, get in touch with the list to upload the package, wrappers +forvarious languages have been provided, and can be found in the bindings section

          Libxml2 is also available from CVS:

          • The Gnome + CVSbase. 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 1f4558d4..4b6d0d47 100644 --- a/doc/encoding.html +++ b/doc/encoding.html @@ -7,44 +7,44 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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. -
          3. The internal encoding, how and - why
          4. +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 shortcutis +I18N) , Unicode, characters and glyphs, I suggest you read a presentationby +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 +stringwithout knowing what encoding it uses, then as Joel Spolsky said please do notwrite +another line of code until you finish reading that article.. It isa +prerequisite to understand this page, and avoid a lot of problems +withlibxml2, XML or text processing in general.

            Table of Content:

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

            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"?>
            +  
          5. How to extend the + existingsupport
          6. +

            What does internationalization support mean ?

            XML was designed from the start to allow the support of any character +setby using Unicode. Any conformant XML parser has to support the UTF-8 +andUTF-16 default encodings which can both express the full unicode ranges. +UTF8is a variable length encoding whose greatest points are to reuse the +sameencoding for ASCII and to save space for Western encodings, but it is a +bitmore complex to handle in practice. UTF-16 use 2 bytes per character +(andsometimes combines two pairs), it makes implementation easier, but looks +abit overkill for Western languages encoding. Moreover the XML +specificationallows the document to be encoded in other encodings at the +condition thatthey are clearly labeled as such. For example the following is +a wellformedXML document encoded in ISO-8859-1 and using accentuated letters +that weFrench like for both markup and content:

            <?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"
            +  
          7. it can also be saved in another encoding supported by libxml2 + (forexample straight UTF8 or even an ASCII form)
          8. +

            Another very important point is that the whole libxml2 API, with +theexception of a few routines to read with a specific encoding or save to +aspecific encoding, is completely agnostic about the original encoding of +thedocument.

            It should be noted too that the HTML parser embedded in libxml2 now +obeythe same rules too, the following document will be (as of 2.2.2) handled +inan internationalized fashion by libxml2 too:

            <!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 to +adefault internal encoding, and that encoding to be UTF-8, here are +therationales for those choices:

            • keeping the native encoding in the internal form would force the + libxmlusers (or the code associated) to be fully aware of the encoding of + theoriginal document, for examples when adding a text node to a + document,the content would have to be provided in the document encoding, + i.e. theclient code would have to check it before hand, make sure it's + conformantto the encoding, etc ... Very hard in practice, though in some + specificcases this may make sense.
            • +
            • the second decision was which encoding. From the XML spec only UTF8 + andUTF16 really makes sense as being the two only encodings for which + thereis mandatory support. UCS-4 (32 bits fixed size encoding) could + beconsidered an intelligent choice too since it's a direct Unicode + mappingsupport. I selected UTF-8 on the basis of efficiency and + compatibilitywith surrounding software: +
              • UTF-8 while a bit more complex to convert from/to (i.e. + slightlymore costly to import and export CPU wise) is also far more + compactthan UTF-16 (and UCS-4) for a majority of the documents I see + it usedfor right now (RPM RDF catalogs, advogato data, various + configurationfile formats, etc.) and the key point for today's + computerarchitecture is efficient uses of caches. If one nearly + double thememory requirement to store the same amount of data, this + will trashcaches (main memory/external caches/internal caches) and my + take isthat this harms the system far more than the CPU requirements + neededfor the conversion to UTF-8
              • +
              • Most of libxml2 version 1 users were using it with straight + ASCIImost of the time, doing the conversion with an internal + encodingrequiring all their code to be rewritten was a serious + show-stopperfor using UTF-16 or UCS-4.
              • +
              • UTF-8 is being used as the de-facto internal encoding standard + forrelated code like the pangoupcoming Gnome text widget, and + a lot of Unix code (yet another placewhere Unix programmer base takes + a different approach from Microsoft- they are using UTF-16)
            • -

            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. -
            3. 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.
            4. -
            5. 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 be + assembledas 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 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 +readingsequence:

              1. when a document is processed, we usually don't know the encoding, + asimple heuristic allows to detect UTF-16 and UCS-4 from encodings + wherethe ASCII range (0-0x7F) maps with ASCII
              2. +
              3. the xml declaration if available is parsed, including the + encodingdeclaration. At that point, if the autodetected encoding is + differentfrom the one declared a call to xmlSwitchEncoding() is + issued.
              4. +
              5. If there is no encoding declaration, then the input has to be in + eitherUTF-8 or UTF-16, if it is not then at some point when processing + theinput, the converter/checker of UTF-8 form will raise an encoding + error.You may end-up with a garbled document, or no document at all ! + Example:
                ~/XML -> ./xmllint err.xml 
                 err.xml:1: error: Input is not proper UTF-8, indicate encoding !
                 <très>là</très>
                @@ -113,94 +114,94 @@ err.xml:1: error: Bytes: 0xE8 0x73 0x3E 0x6C
                 <très>là</très>
                    ^
              6. -
              7. 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: +
              8. xmlSwitchEncoding() does an encoding name lookup, canonicalize it, + andthen search the default registered encoding converters for that + encoding.If it's not within the default set and iconv() support has been + compiledit, it will ask iconv for such an encoder. If this fails then the + parserwill report an error and stops processing:
                ~/XML -> ./xmllint err2.xml 
                 err2.xml:1: error: Unsupported encoding UnsupportedEnc
                 <?xml version="1.0" encoding="UnsupportedEnc"?>
                                                              ^
              9. -
              10. 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).
              11. -
              12. The result (when using DOM) is an internal form completely in UTF-8 - with just an encoding information on the document node.
              13. -

              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 (it + isplugged as a front-end to the I/O module) for that entity. It + capturesand converts on-the-fly the document to be parsed to UTF-8. The + parseritself just does UTF-8 checking of this input and process + ittransparently. The only difference is that the encoding information + hasbeen added to the parsing context (more precisely to the + inputcorresponding to this entity).
              3. +
              4. The result (when using DOM) is an internal form completely in UTF-8with + just an encoding information on the document node.
              5. +

              Ok then what happens when saving the document (assuming youcollected/built +an xmlDoc DOM like structure) ? It depends on the functioncalled, +xmlSaveFile() will just try to save in the original encoding, +whilexmlSaveFileTo() and xmlSaveFileEnc() can optionally save to a +givenencoding:

              1. if no encoding is given, libxml2 will look for an encoding + valueassociated to the document and if it exists will try to save to + thatencoding,

                otherwise everything is written in the internal form, i.e. UTF-8

              2. -
              3. 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
              4. -
              5. 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.
              6. -
              7. 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
              8. +
              9. so if an encoding was specified, either at the API level or on + thedocument, libxml2 will again canonicalize the encoding name, lookup + for aconverter in the registered set or through iconv. If not found + thefunction will return an error code
              10. +
              11. the converter is placed before the I/O buffer layer, as another kind + ofbuffer, then libxml2 will simply push the UTF-8 serialization to + throughthat buffer, which will then progressively be converted and pushed + ontothe I/O layer.
              12. +
              13. It is possible that the converter code fails on some input, for + exampletrying to push an UTF-8 encoded Chinese character through the + UTF-8 toISO-8859-1 converter won't work. Since the encoders are + progressive theywill just report the error and the number of bytes + converted, at thatpoint libxml2 will decode the offending character, + remove it from thebuffer and replace it with the associated charRef + encoding &#123; andresume the conversion. This guarantees that any + document will be savedwithout losses (except for markup names where this + is not legal, this isa problem in the current version, in practice avoid + using non-asciicharacters for tag or attribute names). A special "ascii" + encoding nameis used to save documents to a pure ascii form can be used + whenportability is really crucial

              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 HTML +I18Nprocessing. Looking up and modifying the content encoding is a bit +moredifficult since it is located in a <meta> tag under the +<head>,so a couple of functions htmlGetMetaEncoding() and +htmlSetMetaEncoding() havebeen provided. The parser also attempts to switch +encoding on the fly whendetecting such a tag on input. Except for that the +processing is the same(and again reuses the same code).

            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. UTF-16, both little and big endian
            3. ISO-Latin-1 (ISO-8859-1) covering most western languages
            4. ASCII, useful mostly for saving
            5. -
            6. HTML, a specific handler for the conversion of UTF-8 to ASCII with HTML - predefined entities like &copy; for the Copyright sign.
            7. -

            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 with + HTMLpredefined entities like &copy; for the Copyright sign.
            • +

              More over when compiled on an Unix platform with iconv support the fullset +of encodings supported by iconv can be instantly be used by libxml. On alinux +machine with glibc-2.1 the list of supported encodings and aliases fill3 full +pages, and include UCS-4, the full set of ISO-Latin encodings, and thevarious +Japanese ones.

              To convert from the UTF-8 values returned from the API to another +encodingthen it is possible to use the function provided from the encoding modulelike UTF8Toisolat1, or use +thePOSIX iconv()API +directly.

              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 but +wherethe name differs (for example from the default set of names accepted +byiconv). The following functions allow to register and handle new aliases +forexisting encodings. Once registered libxml2 will automatically lookup +thealiases when handling a document:

              • 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 the +encoders(assuming it is buggy) should not be hard, just write input and +outputconversion routines to/from UTF-8, and register them +usingxmlNewCharEncodingHandler(name, xxxToUTF8, UTF8Toxxx), and they will +becalled automatically if the parser(s) encounter such an encoding +name(register it uppercase, this will help). The description of the +encoders,their arguments and expected return values are described in the +encoding.hheader.

            Daniel Veillard

          diff --git a/doc/entities.html b/doc/entities.html index c234b41e..413dccef 100644 --- a/doc/entities.html +++ b/doc/entities.html @@ -7,34 +7,35 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 defines +anabbreviation for a given string that you can reuse many times throughout +thecontent of your document. Entities are especially useful when a given +stringmay occur frequently within a document, or to confine the change needed +to adocument to a restricted area in the internal subset of the document (at +thebeginning). Example:

          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, by +prefixingits name with '&' and following it by ';' without any spaces +added. Thereare 5 predefined entities in libxml2 allowing you to escape +characters withpredefined meaning in some parts of the xml document +content:&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 +tosubstitute an entity's content so that you can see the replacement text +inyour application. Or you may prefer to keep entity references as such in +thecontent to be able to save the document back without losing this +usuallyprecious information (if the user went through the pain of +explicitlydefining entities, he may have a a rather negative attitude if you +blindlysubstitute them as saving time). The xmlSubstituteEntitiesDefault()function +allows you to check and change the behaviour, which is to notsubstitute +entities by default.

          Here is the DOM tree built by libxml2 for the previous document in +thedefault case:

          /gnome/src/gnome-xml -> ./xmllint --debug test/ent1
           DOCUMENT
           version=1.0
              ELEMENT EXAMPLE
          @@ -49,16 +50,16 @@ DOCUMENT
           version=1.0
              ELEMENT EXAMPLE
                TEXT
          -     content=     Extensible Markup Language

          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 avoid +usingentities in your XML document or data if you are not willing to handle +theentity references elements in the DOM tree.

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

          WARNING: handling +entitieson top of the libxml2 SAX interface is difficult!!! If you plan to +usenon-predefined entities in your documents, then the learning curve to +handlethen using the SAX API may be long. If you plan to use complex +documents, Istrongly suggest you consider using the DOM interface instead and +let libxmldeal with the complexity rather than trying to do it yourself.

          Daniel Veillard

          diff --git a/doc/example.html b/doc/example.html index 894f03ad..37883aba 100644 --- a/doc/example.html +++ b/doc/example.html @@ -7,11 +7,11 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 the +applicationdata is not kept in the DOM tree but uses internal structures. It +is based ona proposal to keep a database of jobs related to Gnome, with an +XML basedstorage structure. Here is an XML encoded +jobsbase:

          <?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 ofcalling +only a couple of functions, browsing the tree to gather the data andgenerate +the internal structures is harder, and more error prone.

          The suggested principle is to be tolerant with respect to the +inputstructure. For example, the ordering of the attributes is not +significant,the XML specification is clear about it. It's also usually a good +idea not todepend on the order of the children of a given node, unless it +really makesthings harder. Here is some code to parse the information for a +person:

          /*
            * 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: XML + datais by nature subject to repetitive constructs and usually exhibits + highlystructured patterns.
          • +
          • The two arguments of type xmlDocPtrand xmlNsPtr,i.e. + the pointer to the global XML document and the namespace reserved tothe + application. Document wide information are needed for example todecode + entities and it's a good coding practice to define a namespace foryour + application set of data and test that the element and attributesyou're + analyzing actually pertains to your application space. This isdone by a + simple equality test (cur->ns == ns).
          • +
          • To retrieve text and attributes value, you can use the + functionxmlNodeListGetStringto gather all the text and entity + referencenodes generated by the DOM output and produce an single text + string.
          • +

          Here is another piece of code used to parse another level of +thestructure:

          #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 either +Cdata structure definitions, a set of XML examples or an XML DTD and +producethe code needed to import and export the content between C data and +XMLstorage. This is left as an exercise to the reader :-)

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

          Daniel Veillard

          diff --git a/doc/help.html b/doc/help.html index 55590074..f539bfb5 100644 --- a/doc/help.html +++ b/doc/help.html @@ -7,19 +7,18 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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. -
          3. 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
          4. -
          5. Provide documentation fixes (either as patches to the code comments or - as HTML diffs).
          6. -
          7. Provide new documentations pieces (translations, examples, etc - ...).
          8. +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 +tosubscribe to the mailing-list as explained before, check the archives and the Gnome +bugdatabase:

            1. Provide patches when you find problems.
            2. +
            3. Provide the diffs when you port libxml2 to a new platform. They may + notbe integrated in all cases but help pinpointing portability + problemsand
            4. +
            5. Provide documentation fixes (either as patches to the code comments + oras HTML diffs).
            6. +
            7. Provide new documentations pieces (translations, examples, etc...).
            8. Check the TODO file and try to close one of the items.
            9. -
            10. 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 :-)
            11. +
            12. Take one of the points raised in the archive or the bug database + andprovide a fix. Get in touch with + mebefore to avoid synchronization problems and check that the + suggestedfix will fit in nicely :-)

            Daniel Veillard

            diff --git a/doc/html/libxml-xmlerror.html b/doc/html/libxml-xmlerror.html index f526e690..aefa9673 100644 --- a/doc/html/libxml-xmlerror.html +++ b/doc/html/libxml-xmlerror.html @@ -657,6 +657,7 @@ void 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 4cfb2bc4..a0d9ba74 100644 --- a/doc/html/libxml-xpath.html +++ b/doc/html/libxml-xpath.html @@ -51,6 +51,7 @@ The content of this structure is not made public by the API.
            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 21d61eb3..6cbf99bd 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:

          +

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

          +

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

          +

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

          +

          Libxml2 implements a number of existing standards related to +markuplanguages:

          -

          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 arelatively +strictly compliant way. As of release 2.4.16, libxml2 passed all1800+ tests +from the OASIS XML +TestsSuite.

            +

            To some extent libxml2 provides support for the following +additionalspecifications 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 doesthis + 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 + compatiblewith 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 make +anyconformance 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 8163c410..f1698d66 100644 --- a/doc/interface.html +++ b/doc/interface.html @@ -7,19 +7,18 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 reasonably +intomemory. In that case (and if you don't expect to save back the XML +documentloaded using libxml), it's better to use the SAX interface of libxml. +SAX isa callback-based interfaceto the parser. Before +parsing,the application layer registers a customized set of callbacks which +arecalled by the library as it progresses through the XML input.

              To get more detailed step-by-step guidance on using the SAX interface +oflibxml, see the nicedocumentation.written +by JamesHenstridge.

              You can debug the SAX behaviour by using the +testSAXprogram located in the gnome-xml module (it's usually +not shipped in thebinary packages of libxml, but you can find it in the tar +sourcedistribution). Here is the sequence of callbacks that would be reported +bytestSAX when parsing the example XML document shown earlier:

              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 DOM +tree-buildingfacility, so nearly everything up to the end of this document +presupposes theuse of the standard DOM tree build. Note that the DOM tree +itself is built bya set of registered default callbacks, without internal +specificinterface.

              Daniel Veillard

              diff --git a/doc/intro.html b/doc/intro.html index 650eccbb..93ee1dfe 100644 --- a/doc/intro.html +++ b/doc/intro.html @@ -7,25 +7,23 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 with +aGnome-1.X library requiring it, Do Not Use libxml1, +uselibxml2

              Daniel Veillard

              diff --git a/doc/library.html b/doc/library.html index b5faade6..98a605b9 100644 --- a/doc/library.html +++ b/doc/library.html @@ -7,27 +7,26 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 getting +bootstrappedusing the XML tollkit from the C language. It is not intended to +beextensive. I hope the automatically generated documents will provide +thecompleteness required, but as a separate set of documents. The interfaces +ofthe XML parser are by principle low level, Those interested in a higher +levelAPI should look at DOM.

              The parser interfaces for +XMLareseparated from the HTML +parserinterfaces. 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 +acceptsdocuments either from in-memory strings or from files. The functions +aredefined 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 case +offailure).

              Invoking the parser: the push method

              In order for the application to keep the control when the document isbeing +fetched (which is common for GUI based programs) libxml2 provides apush +interface, too, as of version 1.8.3. Here are the interfacefunctions:

              xmlParserCtxtPtr xmlCreatePushParserCtxt(xmlSAXHandlerPtr sax,
                                                        void *user_data,
                                                        const char *chunk,
                                                        int size,
              @@ -54,17 +53,16 @@ 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, first +loadingthe document in memory and then building the tree itself. Reading a +documentwithout building the tree is possible using the SAX interfaces (see +SAX.h andJamesHenstridge's +documentation). 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 a +piece ofcode that produces the XML document used in the previous examples:

                  #include <libxml/tree.h>
                   xmlDocPtr doc;
                   xmlNodePtr tree, subtree;
               
              @@ -78,59 +76,59 @@ 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 elements +of the tree.The names should be somewhat simple like +parent,children, next, +prev,properties, etc... For example, still +with 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 "The +Linuxadventure".

              NOTE: XML allows PIs and commentsto +bepresent before the document root, so doc->childrenmay +pointto an element which is not the document Root Element; a +functionxmlDocGetRootElement()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.The + value 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, const + xmlChar*name);
              +

              This function returns a pointer to new copy of the + propertycontent. 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 associatedwith +elements:

              xmlNodePtr xmlStringGetNodeList(xmlDocPtr doc, const + xmlChar*value);
              +

              This function takes an "external" string and converts it to + onetext node or possibly to a list of entity and text nodes. + Allnon-predefined entity references like &Gnome; will be + storedinternally as entity nodes, hence the result of the function may + not 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 inverse + ofxmlStringGetNodeList(). It generates a new + stringcontaining the content of the text and entity nodes. Note the + extraargument inLine. If this argument is set to 1, the function will + expandentity references. For example, instead of returning the + &Gnome;XML encoding in the string, it will substitute it with its + value (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, the + compressioninterface 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 doing +file-basedaccesses. The level of compression on saves can be turned on either +globallyor 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 1affb28c..2dbf900e 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-refs.xml b/doc/libxml2-refs.xml index e4d63414..30a8bbd9 100644 --- a/doc/libxml2-refs.xml +++ b/doc/libxml2-refs.xml @@ -1193,6 +1193,7 @@ + @@ -3286,6 +3287,7 @@ + @@ -4693,6 +4695,7 @@ + @@ -6822,6 +6825,7 @@ + @@ -10313,6 +10317,7 @@ + @@ -12960,6 +12965,7 @@ + @@ -13803,6 +13809,7 @@ + @@ -14490,6 +14497,9 @@ + + + @@ -14821,6 +14831,7 @@ + @@ -16553,6 +16564,9 @@ + + + @@ -17683,6 +17697,7 @@ + @@ -17892,6 +17907,7 @@ + @@ -18445,6 +18461,9 @@ + + + @@ -19468,6 +19487,15 @@ + + + + + + + + + @@ -20627,6 +20655,7 @@ + @@ -20677,6 +20706,7 @@ + @@ -20938,6 +20968,9 @@ + + + @@ -21266,6 +21299,9 @@ + + + @@ -21499,6 +21535,9 @@ + + + @@ -21601,6 +21640,9 @@ + + + @@ -22396,6 +22438,7 @@ + @@ -22499,6 +22542,7 @@ + @@ -23650,6 +23694,7 @@ + @@ -24429,6 +24474,7 @@ + @@ -24566,6 +24612,9 @@ + + + @@ -25147,7 +25196,9 @@ + + @@ -25416,6 +25467,7 @@ + @@ -25725,6 +25777,7 @@ + @@ -27125,11 +27178,17 @@ + + + + + + @@ -27449,6 +27508,9 @@ + + + @@ -27565,6 +27627,7 @@ + @@ -27751,6 +27814,12 @@ + + + + + + @@ -28377,6 +28446,7 @@ + @@ -30698,6 +30768,9 @@ + + + diff --git a/doc/libxml2.xsa b/doc/libxml2.xsa index 65374b22..5dd19baa 100644 --- a/doc/libxml2.xsa +++ b/doc/libxml2.xsa @@ -8,51 +8,32 @@ libxml2 - 2.6.23 - Jan 5 2006 + 2.6.24 + Apr 28 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), + - Portability fixes: configure on Windows, testapi compile on + windows(Kasimier Buchcik, venkat naidu), Borland C++ 6 compile (Eric + Zurcher),HP-UX compiler workaround (Rick Jones), xml2-config bugfix, + gcc-4.1cleanups, Python detection scheme (Joseph Sacco), UTF-8 file paths + onWindows (Roland Schwingel). + - Improvements: xmlDOMWrapReconcileNamespaces xmlDOMWrapCloneNode + (KasimierBuchcik), XML catalog debugging (Rick Jones), update to Unicode + 4.01. + - Bug fixes: xmlParseChunk() problem in 2.6.23, xmlParseInNodeContext()on + HTML docs, URI behaviour on Windows (Rob Richards), comment streamingbug, + xmlParseComment (with William Brack), regexp bug fixes (DV &Youri + Golovanov), xmlGetNodePath on text/CDATA (Kasimier),one Relax-NG + interleave bug, xmllint --path and --valid,XSD bugfixes (Kasimier), + remove debugleft in Python bindings (Nic Ferrier), xmlCatalogAdd bug + (Martin Cole),xmlSetProp fixes (Rob Richards), HTML IDness (Rob + Richards), a largenumber of cleanups and small fixes based on Coverity + reports, bugin character ranges, Unicode tables const (Aivars Kalvans), + schemasfix (Stefan Kost), xmlRelaxNGParse error + deallocation,xmlSchemaAddSchemaDoc error deallocation, error handling on + unallowedcode point, ixmllint --nonet to never reach the net (Gary + Coady),line break in writer after end PI (Jason Viers). + - Documentation: man pages updates and cleanups (Daniel Leidert). + - New features: Relax NG structure error handlers. diff --git a/doc/namespaces.html b/doc/namespaces.html index 32c7787e..463bc48c 100644 --- a/doc/namespaces.html +++ b/doc/namespaces.html @@ -7,44 +7,44 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 namespacessupport +byrecognizing namespace constructs in the input, and does namespace +lookupautomatically when building the DOM tree. A namespace declaration +isassociated with an in-memory structure and all elements or attributes +withinthat namespace point to it. Hence testing the namespace is a simple and +fastequality operation at the user level.

              I suggest that people using libxml2 use a namespace, and declare it in +theroot element of their document as the default namespace. Then they don't +needto use the prefix in the content but we will have a basis for future +semanticrefinement and merging of data from different sources. This doesn't +increasethe size of the XML output significantly, but significantly increases +itsvalue in the long-term. Example:

              <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 have +topoint to any existing resource on the Web. It will bind all the element +andattributes with that URL. I suggest to use an URL within a domain +youcontrol, and that the URL should contain some kind of version information +ifpossible. For example, "http://www.gnome.org/gnumeric/1.0/"is +agood namespace scheme.

              Then when you load a file, make sure that a namespace carrying +theversion-independent prefix is installed on the root element of your +document,and if the version information don't match something you know, warn +the userand be liberal in what you accept as the input. Also do *not* try to +basenamespace checking on the prefix value. <foo:text> may be exactly +thesame as <bar:text> in another document. What really matters is the +URIassociated with the element or the attribute, not the prefix string (which +isjust a shortcut for the full URI). In libxml, element and attributes have +annsfield pointing to an xmlNs structure detailing the +namespaceprefix 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 validity +checking.I will try to make sure that using namespaces won't break validity +checking,so even if you plan to use or currently are using validation I +stronglysuggest adding namespaces to your document. A default namespace +schemexmlns="http://...."should not break validity even on +lessflexible parsers. Using namespaces to mix and differentiate content +comingfrom multiple DTDs will certainly break current validation schemes. To +checksuch documents one needs to use schema-validation, which is supported +inlibxml2 as well. See relagx-ngand w3c-schema.

              Daniel Veillard

              diff --git a/doc/news.html b/doc/news.html index a75db522..47fc8862 100644 --- a/doc/news.html +++ b/doc/news.html @@ -7,470 +7,483 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 wantto +help those

                • More testing on RelaxNG
                • +
                • Finishing up XMLSchemas
                • +

                The change logdescribes the recents commitsto +the CVScode base.

                There is the list of public releases:

                2.6.25: 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), various + XSD validation fixes (Kasimier), memory leak in pattern (Rob Richards and + Kasimier), attribute with colon in name (Rob Richards), XPath leak in + error reporting (Aleksey Sanin), XInclude text include of self + document.
                • +
                • improvements: Xpath optimizations (Kasimier), XPath object cache + (Kasimier),
                • +

                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.1cleanups, Python detection scheme (Joseph Sacco), UTF-8 file paths + onWindows (Roland Schwingel).
                • +
                • Improvements: xmlDOMWrapReconcileNamespaces xmlDOMWrapCloneNode + (KasimierBuchcik), XML catalog debugging (Rick Jones), update to Unicode + 4.01.
                • +
                • Bug fixes: xmlParseChunk() problem in 2.6.23, xmlParseInNodeContext()on + HTML docs, URI behaviour on Windows (Rob Richards), comment streamingbug, + xmlParseComment (with William Brack), regexp bug fixes (DV &Youri + Golovanov), xmlGetNodePath on text/CDATA (Kasimier),one Relax-NG + interleave bug, xmllint --path and --valid,XSD bugfixes (Kasimier), + remove debugleft in Python bindings (Nic Ferrier), xmlCatalogAdd bug + (Martin Cole),xmlSetProp fixes (Rob Richards), HTML IDness (Rob + Richards), a largenumber of cleanups and small fixes based on Coverity + reports, bugin character ranges, Unicode tables const (Aivars Kalvans), + schemasfix (Stefan Kost), xmlRelaxNGParse error + deallocation,xmlSchemaAddSchemaDoc error deallocation, error handling on + unallowedcode point, ixmllint --nonet to never reach the net (Gary + Coady),line break in writer after end PI (Jason Viers).
                • Documentation: man pages updates and cleanups (Daniel Leidert).
                • New features: Relax NG structure error handlers.
                • -

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

                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 fixon Solaris + (Albert Chin), don't use 'list' as parameter name reported bySamuel Diaz + Garcia, more old Unices portability fixes (Albert Chin),MinGW compilation + (Mark Junker), HP-UX compiler warnings (RickJones),
                • +
                • code cleanup: xmlReportError (Adrian Mouat), remove + xmlBufferClose(Geert Jansen), unreachable code (Oleksandr Kononenko), + refactoringparsing code (Bjorn Reese)
                • +
                • bug fixes: xmlBuildRelativeURI and empty path (William + Brack),combinatory explosion and performances in regexp code, leak + inxmlTextReaderReadString(), xmlStringLenDecodeEntities problem + (MassimoMorara), Identity Constraints bugs and a segfault (Kasimier + Buchcik),XPath pattern based evaluation bugs (DV & + Kasimier),xmlSchemaContentModelDump() memory leak (Kasimier), potential + leak inxmlSchemaCheckCSelectorXPath(), xmlTextWriterVSprintf() misuse + ofvsnprintf (William Brack), XHTML serialization fix (Rob Richards), + CRLFsplit problem (William), issues with non-namespaced attributes + inxmlAddChild() xmlAddNextSibling() and xmlAddPrevSibling() (Rob + Richards),HTML parsing of script, Python must not output to stdout (Nic + Ferrier),exclusive C14N namespace visibility (Aleksey Sanin), XSD + dataypetotalDigits bug (Kasimier Buchcik), error handling when writing to + anxmlBuffer (Rob Richards), runtest schemas error not reported + (HisashiFujinaka), signed/unsigned problem in date/time code (Albert + Chin), fixXSI driven XSD validation (Kasimier), parsing of xs:decimal + (Kasimier),fix DTD writer output (Rob Richards), leak in + xmlTextReaderReadInnerXml(Gary Coady), regexp bug affecting schemas + (Kasimier), configuration ofruntime debugging (Kasimier), + xmlNodeBufGetContent bug on entity refs(Oleksandr Kononenko), + xmlRegExecPushString2 bug (Sreeni Nair),compilation and build fixes + (Michael Day), removed dependancies onxmlSchemaValidError (Kasimier), bug + with <xml:foo/>, more XPathpattern based evaluation fixes + (Kasimier)
                • +
                • improvements: XSD Schemas redefinitions/restrictions (KasimierBuchcik), + node copy checks and fix for attribute (Rob Richards), countedtransition + bug in regexps, ctxt->standalone = -2 to indicate nostandalone + attribute was found, add xmlSchemaSetParserStructuredErrors()(Kasimier + Buchcik), add xmlTextReaderSchemaValidateCtxt() to API(Kasimier), handle + gzipped HTTP resources (Gary Coady), addhtmlDocDumpMemoryFormat. (Rob + Richards),
                • +
                • documentation: typo (Michael Day), libxml man page (Albert Chin), + savefunction to XML buffer (Geert Jansen), small doc fix (Aron Stansvik),
                • +

                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 someoutput formatting + for meta element (Rob Richards), script and styleXHTML1 serialization + (David Madore), Attribute derivation fixups in XSD(Kasimier Buchcik), + better IDC error reports (Kasimier Buchcik)
                • +
                • improvements: add XML_SAVE_NO_EMPTY xmlSaveOption (Rob Richards), + addXML_SAVE_NO_XHTML xmlSaveOption, XML Schemas improvements preparing + forderive (Kasimier Buchcik).
                • +
                • documentation: generation of gtk-doc like docs, integration + withdevhelp.
                • +

                2.6.21: Sep 4 2005

                • build fixes: Cygwin portability fixes (Gerrit P. Haase), + callingconvention problems on Windows (Marcus Boerger), cleanups based on + Linus'sparse tool, update of win32/configure.js (Rob Richards), remove + warningson Windows(Marcus Boerger), compilation without SAX1, detection + of thePython binary, use $GCC inestad of $CC = 'gcc' (Andrew W. + Nosenko),compilation/link with threads and old gcc, compile problem by + C370 onZ/OS,
                • +
                • bug fixes: http_proxy environments (Peter Breitenlohner), HTML UTF-8bug + (Jiri Netolicky), XPath NaN compare bug (William Brack),htmlParseScript + potential bug, Schemas regexp handling of spaces, Base64Schemas + comparisons NIST passes, automata build error xsd:all,xmlGetNodePath for + namespaced attributes (Alexander Pohoyda), xmlSchemasforeign namespaces + handling, XML Schemas facet comparison (KupriyanovAnatolij), + xmlSchemaPSimpleTypeErr error report (Kasimier Buchcik), xml:namespace + ahndling in Schemas (Kasimier), empty model group in Schemas(Kasimier), + wilcard in Schemas (Kasimier), URI composition (William),xs:anyType in + Schemas (Kasimier), Python resolver emmitting errormessages directly, + Python xmlAttr.parent (Jakub Piotr Clapa), trying tofix the file path/URI + conversion, xmlTextReaderGetAttribute fix (RobRichards), + xmlSchemaFreeAnnot memleak (Kasimier), HTML UTF-8serialization, streaming + XPath, Schemas determinism detection problem,XInclude bug, Schemas + context type (Dean Hill), validation fix (DerekPoon), + xmlTextReaderGetAttribute[Ns] namespaces (Rob Richards), Schemastype fix + (Kuba Nowakowski), UTF-8 parser bug, error in encoding + handling,xmlGetLineNo fixes, bug on entities handling, entity name + extraction inerror handling with XInclude, text nodes in HTML body tags + (Gary Coady),xml:id and IDness at the treee level fixes, XPath streaming + patternsbugs.
                • +
                • improvements: structured interfaces for schemas and RNG error + reports(Marcus Boerger), optimization of the char data inner loop + parsing(thanks to Behdad Esfahbod for the idea), schematron validation + thoughnot finished yet, xmlSaveOption to omit XML declaration, keyref + matcherror reports (Kasimier), formal expression handling code not + pluggedyet, more lax mode for the HTML parser, parser XML_PARSE_COMPACT + optionfor text nodes allocation.
                • +
                • documentation: xmllint man page had --nonet duplicated
                • +

                2.6.20: Jul 10 2005

                • build fixes: Windows build (Rob Richards), Mingw compilation + (IgorZlatkovic), Windows Makefile (Igor), gcc warnings (Kasimier + andandriy@google.com), use gcc weak references to pthread to avoid + thepthread dependancy on Linux, compilation problem (Steve Nairn), + compilingof subset (Morten Welinder), IPv6/ss_family compilation (William + Brack),compilation when disabling parts of the library, standalone + testdistribution.
                • +
                • bug fixes: bug in lang(), memory cleanup on errors (William Brack),HTTP + query strings (Aron Stansvik), memory leak in DTD (William), + integeroverflow in XPath (William), nanoftp buffer size, pattern "." apth + fixup(Kasimier), leak in tree reported by Malcolm Rowe, replaceNode + patch(Brent Hendricks), CDATA with NULL content (Mark Vakoc), xml:base + fixupon XInclude (William), pattern fixes (William), attribute bug + inexclusive c14n (Aleksey Sanin), xml:space and xml:lang with SAX2 + (RobRichards), namespace trouble in complex parsing (Malcolm Rowe), XSD + typeQNames fixes (Kasimier), XPath streaming fixups (William), RelaxNG + bug(Rob Richards), Schemas for Schemas fixes (Kasimier), removal of ID + (RobRichards), a small RelaxNG leak, HTML parsing in push mode bug + (JamesBursa), failure to detect UTF-8 parsing bugs in CDATA + sections,areBlanks() heuristic failure, duplicate attributes in DTD + bug(William).
                • +
                • improvements: lot of work on Schemas by Kasimier Buchcik both + onconformance and streaming, Schemas validation messages (Kasimier + Buchcik,Matthew Burgess), namespace removal at the python level + (BrentHendricks), Update to new Schemas regression tests from + W3C/Nist(Kasimier), xmlSchemaValidateFile() (Kasimier), implementation + ofxmlTextReaderReadInnerXml and xmlTextReaderReadOuterXml (James + Wert),standalone test framework and programs, new DOM import + APIsxmlDOMWrapReconcileNamespaces() xmlDOMWrapAdoptNode() + andxmlDOMWrapRemoveNode(), extension of xmllint capabilities for SAX + andSchemas regression tests, xmlStopParser() available in pull mode + too,ienhancement to xmllint --shell namespaces support, Windows port of + thestandalone testing tools (Kasimier and + William),xmlSchemaValidateStream() xmlSchemaSAXPlug() and + xmlSchemaSAXUnplug() SAXSchemas APIs, Schemas xmlReader support.
                • +

                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 breaks + with AIX5.3 compiler, fixed elfgcchack.h generation and PLT reduction + code onLinux/ELF/gcc4
                • +
                • bug fixes: schemas type decimal fixups (William Brack), xmmlint + returncode (Gerry Murphy), small schemas fixes (Matthew Burgess and + GUYFabrice), workaround "DAV:" namespace brokeness in c14n (Aleksey + Sanin),segfault in Schemas (Kasimier Buchcik), Schemas attribute + validation(Kasimier), Prop related functions and xmlNewNodeEatName (Rob + Richards),HTML serialization of name attribute on a elements, Python + error handlersleaks and improvement (Brent Hendricks), uninitialized + variable inencoding code, Relax-NG validation bug, potential crash + ifgnorableWhitespace is NULL, xmlSAXParseDoc and xmlParseDoc + signatures,switched back to assuming UTF-8 in case no encoding is given + atserialization time
                • +
                • improvements: lot of work on Schemas by Kasimier Buchcik on + facetschecking 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 + andxmlreader stopping on non-fatal errors, thread support for + dictionnariesreference counting (Gary Coady), internal subset and push + problem, URLsaved in xmlCopyDoc, various schemas bug fixes (Kasimier), + Python pathsfixup (Stephane Bidoul), xmlGetNodePath and namespaces, + xmlSetNsProp fix(Mike Hommey), warning should not count as error (William + Brack),xmlCreatePushParser empty chunk, XInclude parser flags (William), + cleanupFTP and HTTP code to reuse the uri parsing and IPv6 + (William),xmlTextWriterStartAttributeNS fix (Rob Richards), + XMLLINT_INDENT beingempty (William), xmlWriter bugs (Rob Richards), + multithreading on Windows(Rich Salz), xmlSearchNsByHref fix (Kasimier), + Python binding leak (BrentHendricks), aliasing bug exposed by gcc4 on + s390, xmlTextReaderNext bug(Rob Richards), Schemas decimal type fixes + (William Brack),xmlByteConsumed static buffer (Ben Maurer).
                • +
                • improvement: speedup parsing comments and DTDs, dictionnary support + forhash tables, Schemas Identity constraints (Kasimier), streaming + XPathsubset, xmlTextReaderReadString added (Bjorn Reese), Schemas + canonicalvalues handling (Kasimier), add xmlTextReaderByteConsumed + (AronStansvik),
                • 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-clean + dependency(William), build in a different directory(William), fixing + --with-minimum configure build (William), BeOS build(Marcin Konicki), + Python-2.4 detection (William), compilation on AIX (DanMcNichol)
                • +
                • bug fixes: xmlTextReaderHasAttributes (Rob Richards), + xmlCtxtReadFile()to use the catalog(s), loop on output (William Brack), + XPath memory leak,ID deallocation problem (Steve Shepard), debugDumpNode + crash (William),warning not using error callback (William), xmlStopParser + bug (William),UTF-16 with BOM on DTDs (William), namespace bug on empty + elements inpush mode (Rob Richards), line and col computations fixups + (AlekseySanin), xmlURIEscape fix (William), xmlXPathErr on bad range + (William),patterns with too many steps, bug in RNG choice optimization, + line numbersometimes missing.
                • +
                • improvements: XSD Schemas (Kasimier Buchcik), python + generator(William), xmlUTF8Strpos speedup (William), unicode Python + strings(William), XSD error reports (Kasimier Buchcik), Python __str__ + callserialize().
                • +
                • new APIs: added xmlDictExists(), GetLineNumber and GetColumnNumber + forthe xmlReader (Aleksey Sanin), Dynamic Shared Libraries APIs (mostly + JoelReed), error extraction API from regexps, new XMLSave option for + format(Phil Shafer)
                • +
                • 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 + newautomated 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 XPath + reported byMarkus Bertheau, catalog problem with NULL entries (William + Brack)
                • +
                • documentation: fix to xmllint man page, some API function + descritpionwere 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 outside + thesource 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 lookup + fix(Malcolm), save back <group> in catalogs (William), tree + buildfixes (DV and Rob Richards), Schemas memory bug, structured error + handleron Python 64bits, thread local memory deallocation, memory leak + reportedby Volker Roth, xmlValidateDtd in the presence of an internal + subset,entities and _private problem (William), xmlBuildRelativeURI + error(William).
                • +
                • improvements: better XInclude error reports (William), tree + debuggingmodule and tests, convenience functions at the Reader API + (GrahamBennett), add support for PI in the HTML parser.
                • +

                2.6.14: Sep 29 2004

                • build fixes: configure paths for xmllint and xsltproc, + compilationwithout HTML parser, compilation warning cleanups (William + Brack &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 cleanup + and fixes(Kasimier), ChangeLog cleanup (Stepan Kasal), memory fixes (Mark + Vakoc),handling of failed realloc(), out of bound array adressing in + Schemasdate handling, Python space/tabs cleanups (Malcolm Tredinnick), + NMTOKENSE20 validation fix (Malcolm),
                • +
                • improvements: added W3C XML Schemas testsuite (Kasimier Buchcik), + addxmlSchemaValidateOneElement (Kasimier), Python exception + hierearchy(Malcolm Tredinnick), Python libxml2 driver improvement + (MalcolmTredinnick), Schemas support for + xsi:schemaLocation,xsi:noNamespaceSchemaLocation, xsi:type (Kasimier + Buchcik)
                • +

                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 + Brackand Julius Mittenzwei), Schemas facet check (Kasimier), default + namespaceproblem (William), Schemas hexbinary empty values, encoding + error 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 space + mixes(William), wrapper generator fixes (William), Cygwin support (Gerrit + P.Haase), node wrapper fix (Marc-Antoine Parent), XML Schemas + support(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 (Peter + Breitenlohner),xmlReader state after attribute reading (William), + structured errorhandler (William), XInclude generated xml:base fixup + (William), Windowsmemory reallocation problem (Steve Hay), Out of Memory + conditionshandling (William and Olivier Andrieu), htmlNewDoc() charset + bug,htmlReadMemory init (William), a posteriori validation DTD + base(William), notations serialization missing, xmlGetNodePath + (Dodji),xmlCheckUTF8 (Diego Tartara), missing line numbers on + entity(William)
                • +
                • improvements: DocBook catalog build scrip (William), xmlcatalog + tool(Albert Chin), xmllint --c14n option, no_proxy environment (Mike + Hommey),xmlParseInNodeContext() addition, extend xmllint --shell, allow + XIncludeto not generate start/end nodes, extend xmllint --version to + include CVStag (William)
                • +
                • 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 + forattributes, 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), + Catalogpath 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), + testSAXproperly initialize the library (William), empty node set in + XPath(William), xmlSchemas errors (William), invalid charref problem + pointedby Morus Walter, XInclude xml:base generation (William), Relax-NG + bugwith div processing (William), XPointer and xml:base + problem(William),Reader and entities, xmllint return code for schemas + (William), readerstreaming problem (Steve Ball), DTD serialization + problem (William),libxml.m4 fixes (Mike Hommey), do not provide + destructors as methods onPython classes, xmlReader buffer bug, Python + bindings memory interfacesimprovement (with Stéphane Bidoul), Fixed the + push parser to be back tosynchronous behaviour.
                • +
                • improvement: custom per-thread I/O enhancement (Rob Richards), + registernamespace in debug shell (Stefano Debenedetti), Python based + regressiontest for non-Unix users (William), dynamically increase the + number ofXPath extension functions in Python and fix a memory leak + (Marc-AntoineParent and William)
                • +
                • performance: hack done with Arjan van de Ven to reduce ELF footprintand + generated code on Linux, plus use gcc runtime profiling to optimizethe + code generated in the RPM packages.

                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++ do + notuse "list" as parameter name, make tests work with Python 1.5 + (EdDavis),
                • +
                • improvements: made xmlTextReaderMode public, small buffers + resizing(Morten Welinder), add --maxmem option to xmllint, + addxmlPopInputCallback() for Matt Sergeant, refactoring of + serializationescaping, added escaping customization
                • +
                • bugfixes: xsd:extension (Taihei Goi), assorted regexp bugs + (WilliamBrack), xmlReader end of stream problem, node deregistration with + reader,URI escaping and filemanes, XHTML1 formatting (Nick Wellnhofer), + regexptransition reduction (William), various XSD Schemas fixes + (KasimierBuchcik), XInclude fallback problem (William), weird problems + with DTD(William), structured error handler callback context (William), + reversexmlEncodeSpecialChars() behaviour back to escaping '"'

                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), XInclude + duplicatefallback (William), external DTD encoding detection (William), a + DTDvalidation bug (William), xmlReader Close() fix, recusive + extentionschemas
                • +
                • improvements: use xmlRead* APIs in test tools (Mark Vakoc), + indentingsave optimization, better handle IIS broken HTTP redirect + behaviour (IanHummel), HTML parser frameset (James Bursa), libxml2-python + RPMdependancy, XML Schemas union support (Kasimier Buchcik), warning + removalclanup (William), keep ChangeLog compressed when installing from + RPMs
                • +
                • documentation: examples and xmlDocDumpMemory docs (John Fleck), + newexample (load, xpath, modify, save), xmlCatalogDump() comments,
                • +
                • Windows: Borland C++ builder (Eric Zurcher), work around + Microsoftcompiler 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 datatype + facets.
                • 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 and + WilliamBrack), no ID errors if using HTML_PARSE_NOERROR, xmlcatalog + fallbacks toURI on SYSTEM lookup failure, XInclude parse flags + inheritance (William),XInclude and XPointer fixes for entities (William), + XML parser bugreported by Holger Rauch, nanohttp fd leak (William), + regexps chargroups '-' handling (William), dictionnary reference counting + problems,do not close stderr.
                • 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, catalog + cleanups(Peter Breitenlohner), MingW patch (Roland Schwingel), + cross-compilationto Windows (Christophe de Vienne), --with-html-dir + fixup (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/Perl + interface.
                • 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 (Igor + andWilliam) 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 OlegParaschenko), XInclude empty fallback (William), HTML warnings + (William),XPointer in XInclude (William), Python namespace + serialization,isolat1ToUTF8 bound error (Alfred Mickautsch), output of + parameterentities in internal subset (William), internal subset bug in + push mode,<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.
                • 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 offest + ininput.
                • +

                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 + withnamespace, memory leak (William), SAX1 cleanup and minimal options + fixes(Mark Vadoc), parser context reset on error (Shaun McCance), XPath + unionevaluation problem (William) , xmlReallocLoc with NULL (Aleksey + Sanin),XML Schemas double free (Steve Ball), XInclude with no href, + argumentcallbacks order for XPath callbacks (Frederic Peters)
                • +
                • Documentation: python scripts (William Brack), xslt stylesheets + (JohnFleck), 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 + dictionnaryreferences (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 for + futureXSLT 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), example + fix(Lucas Brasilino)
                • +
                • bugfixes: xmlTextReaderExpand() with xmlReaderWalker, XPath handling + ofNULL strings (William Brack) , API building reader or parser + fromfiledescriptor should not close it, changed XPath sorting to be + stableagain (William Brack), xmlGetNodePath() generating '(null)' + (WilliamBrack), DTD validation and namespace bug (William Brack), XML + Schemasdouble inclusion behaviour

                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(Daniel + Schulman)
                • +
                • XInclude bugfix, new APIs and update to the last version including + thenamespace change.
                • +
                • XML Schemas improvements: include (Robert Stepanek), import + andnamespace handling, fixed the regression tests troubles, added + examplesbased on Eric van der Vlist book, regexp fixes
                • +
                • preliminary pattern support for streaming (needed for + schemasconstraints), added xmlTextReaderPreservePattern() to collect + subdocumentwhen 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 +495,116 @@ 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 the + XMLserializer)

                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), warnings + cleanup(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(Stephane + Bidoul)
                • 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, serializingDocument + 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 + lotof 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 + smalltext nodes from the dictionnary
                • +
                • Switch to a SAX2 like parser rewrote most of the XML parser + core,provides namespace resolution and defaulted attributes, minimize + memoryallocations and copies, namespace checking and specific error + handling,immutable buffers, make predefined entities static structures, + etc...
                • +
                • rewrote all the error handling in the library, all errors can + beintercepted at a structured level, with precise + informationavailable.
                • +
                • New simpler and more generic XML and HTML parser APIs, allowing + toeasilly modify the parsing options and reuse parser context for + multipleconsecutive documents.
                • +
                • Similar new APIs for the xmlReader, for options and reuse, provided + newfunctions to access content as const strings, use them for + Pythonbindings
                • +
                • a lot of other smaller API improvements: xmlStrPrintf (Aleksey + Sanin),Walker i.e. reader on a document tree based on Alfred Mickautsch + code,make room in nodes for line numbers, reference counting and future + PSVIextensions, generation of character ranges to be checked with + fasteralgorithm (William), xmlParserMaxDepth (Crutcher Dunnavant), + bufferaccess
                • 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 the + Mime-Typeand charset informations if available.
                • +
                • Relax-NG: bug fixes including the one reported by Martijn Faassen + andzeroOrMore, better error reporting.
                • +
                • Python bindings (Stéphane Bidoul), never use stdout for + errorsoutput
                • +
                • Portability: all the headers have macros for export and + callingconvention definitions (Igor Zlatkovic), VMS update (Craig A. + Berry),Windows: threads (Jesse Pelton), Borland compiler (Eric Zurcher, + Igor),Mingw (Igor), typos (Mark Vakoc), beta version (Stephane + Bidoul),warning cleanups on AIX and MIPS compilers (William Brack), BeOS + (Marcin'Shard' Konicki)
                • +
                • Documentation fixes and README (William Brack), search fix + (William),tutorial updates (John Fleck), namespace docs (Stefan Kost)
                • +
                • Bug fixes: xmlCleanupParser (Dave Beckett), threading + uninitializedmutexes, HTML doctype lowercase, SAX/IO (William), + compression detectionand restore (William), attribute declaration in DTDs + (William), namespaceon attribute in HTML output (William), input filename + (Rob Richards),namespace DTD validation, xmlReplaceNode (Chris Ryland), + I/O callbacks(Markus Keim), CDATA serialization (Shaun McCance), + xmlReader (PeterDerr), high codepoint charref like &#x10FFFF;, buffer + access in pushmode (Justin Fletcher), TLS threads on Windows (Jesse + Pelton), XPath bug(William), xmlCleanupParser (Marc Liyanage), CDATA + output (William), HTTPerror handling.
                • +
                • xmllint options: --dtdvalidfpi for Tobias Reif, --sax1 for + compattesting, --nodict for building without tree dictionnary, --nocdata + toreplace CDATA by text, --nsclean to remove surperfluous + namespacedeclarations
                • 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 patch + forxmlSearchNs() by Luca Padovani. The xmlReader should do far + lessallocation and it speed should get closer to SAX. Chris Anderson + workedon speeding and cleaning up repetitive checking code.
                • 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 the + XMLparser 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, Mingwon + Windows (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), Windows + build(Wiliam Brake, Jesse Pelton, Igor), Schemas (Peter Sobisch), + threading(Rob Richards), hexBinary type (), UTF-16 BOM (Dodji + Seketeli),xmlReader, Relax-NG schemas compilation, namespace handling, + EXSLT (SeanGriffin), HTML parsing problem (William Brack), DTD validation + for mixedcontent + namespaces, HTML serialization, library + initialization,progressive HTML parser
                • 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 +612,123 @@ 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 (William + Brack),PI related memleak, compilation without schemas or without xpath + (JoergSchmitz-Linneweber/Garry Pennington), xmlUnlinkNode problem with + DTDs,rpm problem on , i86_64, removed a few compilation problems from + 2.5.7,xmlIOParseDTD, and xmlSAXParseDTD (Malcolm Tredinnick)
                • 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), and + method/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 of + thexmlReader 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 Duration + fixes(Charles Bozeman), DTD and namespaces (Brent Hendricks), HTML push + parserand zero bytes handling, some missing Windows file path + conversions,behaviour of the parser and validator in the presence of "out + of memory"error conditions
                • +
                • extended the API to be able to plug a garbage collecting + memoryallocator, added xmlMallocAtomic() and modified the + allocationsaccordingly.
                • +
                • Performances: removed excessive malloc() calls, speedup of the push + andxmlReader 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 except + forbinHex and base64 which are not supported yet.
                • +
                • bug fixes: non-ASCII IDs, HTML output, XInclude on large docs + andXInclude entities handling, encoding detection on external subsets, + XMLSchemas bugs and memory leaks, HTML parser (James Bursa)
                • 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, Relax + NGerrors
                • +

                2.5.5: Mar 24 2003

                • Lot of fixes on the Relax NG implementation. More testing + includingDocBook 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 and + XIncludeimplementation
                • 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 checking + onnamespaces, +

                  2 serialization bugs, node info generation problems, a DTD + regexpgeneration 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 a + firstversion of RelaxNG Python bindings
                • +
                • Fixes: XLink (Sean Chittenden), XInclude (Sean Chittenden), API fix + forserializing 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 and + entities,delegateURI in XML Catalogs, HTML parser, XML reader (Stéphane + Bidoul),XPath parser and evaluation, UTF8ToUTF8 serialization, XML + reader memoryconsumption, HTML parser, HTML serialization in the presence + ofnamespaces
                • 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éphane + Bidoul)
                • 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éphane + Bidoul),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 man + update(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 minor + codefixes.
                • +

                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
                • 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, fixed + XHTML1dump
                • 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 and + savesmore 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 +737,40 @@ 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 (Brian + Stafford), 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() ,HTML + serialization, 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, small + fixand 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 and + regexpAPIs
                • 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 +780,97 @@ 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 fix + fromPeter Jacobi
                • +
                • a number of bug fixes: XPath (William Brack, Richard Jinks), XML + andHTML 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 (Christian + Cornelssen),indentation, URI parsing
                • +
                • Optimizations for XMLSec, fixing and making public some of the + networkprotocol 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 XML + Schemasdatatypes
                • +

                2.4.21: Apr 29 2002

                This release is both a bug fix release and also contains the early +XMLSchemas structuresand datatypescode, beware, +allinterfaces are likely to change, there is huge holes, it is clearly a work +inprogress and don't even think of putting this code in a production +system,it's actually not compiled in by default. The real fixes are:

                • 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, python + bindings,libxml.m4
                • +

                2.4.19: Mar 25 2002

                • bug fixes: half a dozen XPath bugs, Validation, ISO-Latin to + UTF8encoder
                • 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 parents + inXPath"
                • +
                • fixed/improved the Python wrappers, added more examples and + moreregression tests, XPath extension functions can now return + node-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 XML + Testsuitefrom OASIS and W3C. Compliance has been significantly + improved.
                • 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 MITLicensebasically + for integration in XFree86 codebase, and removingconfusion around the + previous dual-licensing
                • +
                • added Python bindings, beta software but should already be + quitecomplete
                • +
                • a large number of fixes and cleanups, especially for all + treemanipulations
                • +
                • cleanup of the headers, generation of a reference API definition + inXML

                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 and + SergueiNarojnyi
                • 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 (Geert + Kloosterman),XML parser (Robin Berjon), XPointer (Danny Jamshy), I/O + cleanups(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, some + codecleanups
                • 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, updated + xmlcatalogtool
                • 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 configure + optionand regression tests
                • removed an HTML parser bug
                • fixed a couple of potentially serious validation bugs
                • integrated the SGML DocBook support in xmllint
                • @@ -873,12 +886,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 someversion + of Netscape can't handle hexadecimal ones
                  • +

                  1.8.16: Sep 14 2001

                  • maintenance release of the old libxml1 branch, couple of bug + andportability 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 +908,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 to + theregression 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 requirement + whensubstituting them
                    • +
                    • lots of improvements in the XPath queries interpreter can + besubstantially faster
                    • Makefiles and configure cleanups
                    • Fixes to XPath variable eval, and compare on empty node set
                    • HTML tag closing bug fixed
                    • @@ -916,37 +928,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 for + theoptimizer on Tru64
                      • +
                      • incorporated Yon Derek and Igor Zlatkovic fixes and improvements + forcompilation 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 some + portabilityproblems (alpha)
                      • +
                      • fixed some HTML serialization problems (pre, script, and + block/inlinehandling), added encoding aware APIs, cleanup of this + code
                      • 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 DocBook + SGMLparser
                      • +
                      • some XPath fixes (-Infinity, / as a function parameter and + namespacesnode 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,XInclude + processing
                      • 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 +970,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 the + floatingpoint portability issue
                        • +
                        • Speed improvement (8M/s for SAX, 3M/s for DOM, 1.5M/s forDOM+validation + using the XML REC as input and a 700MHz celeron).
                        • incorporated more Windows cleanup
                        • added xmlSaveFormatFile()
                        • fixed problems in copying nodes with entities references (gdome)
                        • @@ -975,32 +988,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, found + andcleared 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. used + thetrio library code to provide the one needed when the platform is + missingthem
                          • +
                          • 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 XPath + expressions,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 default + buffersize to be application tunable.
                          • +
                          • Some cleanup in the validation code, still a bug left and this + partshould probably be rewritten to support ambiguous content model + :-\
                          • +
                          • Fix a couple of serious bugs introduced or raised by changes in + 2.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 that + theyare 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 +1024,18 @@ 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 DOM + gdome2implementation
                            • 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 reporting + forXSLT
                            • 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-devel + andlibxml2-devel
                            • the example Makefile is now fixed
                            • added HTML to the RPM packages
                            • tree copying bugfixes
                            • @@ -1038,8 +1052,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 +1063,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 structure + tothose
                                • 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 buildand + release
                                • Late validation fixes
                                • Integrated a lot of contributed patches
                                • added memory management docs
                                • @@ -1072,115 +1085,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 has + beenchecked too
                                  • +
                                  • Far better handling of larges Dtd. Validating against DocBook XML + Dtdworks 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 memoryallocation + routines

                                  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 now + alwaysencoded 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 libxml + Internationalizationsupport

                                  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 to + solverpmfind 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 libxml2 + accordingto new instructions. It fixes a nasty + problemabout &#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 and + namespacerelated 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 a + goodidea to check the 1.x to 2.x upgrade instructions. NOTE: while + initiallyscheduled for Apr 3 the release occurred only on Apr 12 due to + massiveworkload.
                                  • +
                                  • The include are now located under $prefix/include/libxml (instead + of$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 be + overloadeddynamically by using xmlMemSetup()
                                  • +
                                  • The previously CVS only tool tester has been + renamedxmllintand is now installed as part of the + libxml2package
                                  • +
                                  • The I/O interface has been revamped. There is now ways to plug + inspecific I/O modules, either at the URI scheme detection level + usingxmlRegisterInputCallbacks() or by passing I/O functions when + creating aparser context using xmlCreateIOParserCtxt()
                                  • +
                                  • there is a C preprocessor macro LIBXML_VERSION providing the + versionnumber of the libxml module in use
                                  • +
                                  • a number of optional features of libxml can now be excluded atconfigure + time (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 as + libxml2-2.0.0beta and available as tar andRPMs
                                  • +
                                  • This version is now the head in the Gnome CVS base, the old one + isavailable under the tag LIB_XML_1_X
                                  • +
                                  • This includes a very large set of changes. From a programmatic pointof + view 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 testagainst + theOASIS testsuite (except the Japanese tests since I don't support + thatencoding yet). This URL is rebuilt every couple of hours using the + CVShead version.

                                    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 used + bylibxml-1.x, a new function xmlKeepBlanksDefault(0) will allow this. + Notethat for adherence to XML spec, this behaviour will be disabled + bydefault in 2.x . The same function will allow to keep compatibility + forold code.
                                    • +
                                    • 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.6compilation on some platforms has been fixed
                                    • +
                                    • nanoftp.c nanohttp.c: Fixed '#' and '?' stripping when + processingURIs
                                    • +

                                    1.8.6: Jan 31 2000

                                    • added a nanoFTP transport module, debugged until the new version of rpmfindcan + useit without troubles
                                    • +

                                    1.8.5: Jan 21 2000

                                    • adding APIs to parse a well balanced chunk of XML (production [43] contentof theXML + spec)
                                    • 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 patch + tryingto solve the zlib checks problems
                                    • +
                                    • The current state in gnome CVS base is expected to ship as 1.8.5 + withgnumeric 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 +1202,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 it + usesxmlLoadExternalEntity(), some fix on entities processing were + added
                                      • 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 is + fixedfor good this time
                                      • +
                                      • Added a few tree modification functions: + xmlReplaceNode,xmlAddPrevSibling, xmlAddNextSibling, xmlNodeSetName + andxmlDocSetRootElement
                                      • 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 namespace + processing,and more specifically the Dia application
                                      • +
                                      • fixed a posteriori validation (validation after parsing, or by using + aDtd 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, it + shouldnot crash, whatever the input !
                                      • +
                                      • Integrated various patches, especially a speedup improvement for + largedataset from Carl + Nygard,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 on + systemwere it's not available, fixed
                                      • +

                                      1.7.1: Sep 24 1999

                                      • The basic type for strings manipulated by libxml has been renamed + in1.7.1 from CHARto xmlChar. The + reasonis that CHAR was conflicting with a predefined type on Windows. + Howeveron non WIN32 environment, compatibility is provided by the way of + a#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 simple + printflike 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 5910766f..7d451c57 100644 --- a/doc/python.html +++ b/doc/python.html @@ -7,73 +7,69 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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 to +get updates to this list or to discuss the specific topic of libxml2or +libxslt 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
                  +  
                • LibxmlJisan + effort to create a 100% JAXP-compatible Java wrapper for libxml2 + andlibxslt as part of GNU ClasspathX project.
                • +
                • Patrick McPhee provides Rexx bindings fof libxml2 and libxslt, look + forRexxXML.
                • +
                • Satimageprovides + XMLLibosax. + This is an osax for Mac OS X with a set of commands toimplement in + AppleScript the XML DOM, XPATH and XSLT. Also includescommands for + Property-lists (Apple's fast lookup table XML format.)
                • +
                • Francesco Montorsi developped wxXml2wrappers + that interface libxml2, allowing wxWidgets applications toload/save/edit + XML instances.
                • +

                  The distribution includes a set of Python bindings, which are guaranteedto +be maintained as part of the library in the future, though the +Pythoninterface have not yet reached the completeness of the C API.

                  Note that some of the Python purist dislike the default set of +Pythonbindings, rather than complaining I suggest they have a look at lxml the more pythonic bindings for +libxml2and libxsltand help +MartijnFaassencomplete those.

                  Stéphane +Bidoulmaintains a +Windows portof the Python bindings.

                  Note to people interested in building bindings, the API is formalized asan XML API description filewhich allows toautomate +a large part of the Python bindings, this includes functiondescriptions, +enums, structures, typedefs, etc... The Python script used tobuild the +bindings is python/generator.py in the source distribution.

                  To install the Python bindings there are 2 options:

                  • If you use an RPM based distribution, simply install the libxml2-pythonRPM(and + if needed the libxslt-pythonRPM).
                  • +
                  • Otherwise use the libxml2-pythonmodule + distributioncorresponding to your installed version oflibxml2 and + libxslt. Note that to install it you will need both libxml2and libxslt + installed and run "python setup.py build install" in themodule tree.
                  • +

                  The distribution includes a set of examples and regression tests for +thepython bindings in the python/testsdirectory. Here are +someexcerpts 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 +83,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 equivalent +ofxmlParseFile (most of the bindings are automatically generated, and the +xmlprefix is removed and the casing convention are kept). All node seen at +thebinding level share the same subset of accessors:

                  • name: returns the node name
                  • +
                  • type: returns a string indicating the node type
                  • +
                  • content: returns the content of the node, it is based + onxmlNodeGetContent() 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 +tofunction properly, and rather than risk memory leaks if not +implementedcorrectly it sounds safer to have an explicit function to free a +tree. Thewrapper python objects like doc, root or child are them +automatically garbagecollected.

                  validate.py:

                  This test check the validation interfaces and redirection of +errormessages:

                  import libxml2
                   
                   #deactivate error messages from the validation
                   def noerr(ctx, str):
                  @@ -119,27 +116,28 @@ doc = ctxt.doc()
                   valid = ctxt.isValid()
                   doc.freeDoc()
                   if valid != 0:
                  -    print "validity check failed"

                  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(), itdefines +a new error handler global to the library. It is used to avoid seeingthe +error messages when trying to validate the invalid document.

                  The main interest of that test is the creation of a parser context +withcreateFileParserCtxt() and how the behaviour can be changed before +callingparseDocument() . Similarly the informations resulting from the +parsing phaseare also available using context methods.

                  Contexts like nodes are defined as class and the libxml2 wrappers maps +theC function interfaces in terms of objects method as much as possible. +Thebest to get a complete view of what methods are supported is to look at +thelibxml2.py module containing all the wrappers.

                  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 on +thexmlCreatePushParser() from the C library. The first argument is an +optionalSAX callback object, then the initial set of data, the length and the +name ofthe resource in case URI-References need to be computed by the +parser.

                  Then the data are pushed using the parseChunk() method, the last +callsetting the third argument terminate to 1.

                  pushSAX.py:

                  this test show the use of the event based parsing interfaces. In this +casethe parser does not build a document, but provides callback information +asthe parser makes progresses analyzing the data being provided:

                  import libxml2
                   log = ""
                   
                   class callback:
                  @@ -187,15 +185,15 @@ reference = "startDocument:startElement foo {'url': 'tst'}:" + \
                               "characters: bar:endElement foo:endDocument:"
                   if log != reference:
                       print "Error got: %s" % log
                  -    print "Expected: %s" % reference

                  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 of +entrypoints which can be called by the parser as it makes progresses to +indicatethe information set obtained. The full set of callback is larger than +whatthe callback class in that specific example implements (see the +SAXdefinition for a complete list). The wrapper will only call those supplied +bythe object when activated. The startElement receives the names of the +elementand a dictionary containing the attributes carried by this element.

                  Also note that the reference string generated from the callback shows +asingle character call even though the string "bar" is passed to the +parserfrom 2 different call to parseChunk()

                  xpath.py:

                  This is a basic test of XPath wrappers support

                  import libxml2
                   
                   doc = libxml2.parseFile("tst.xml")
                   ctxt = doc.xpathNewContext()
                  @@ -207,14 +205,15 @@ if res[0].name != "doc" or res[1].name != "foo":
                       print "xpath query: wrong node set value"
                       sys.exit(1)
                   doc.freeDoc()
                  -ctxt.xpathFreeContext()

                  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 evaluate +XPathexpression on it. The xpathEval() method execute an XPath query and +returnsthe result mapped in a Python way. String and numbers are natively +converted,and node sets are returned as a tuple of libxml2 Python nodes +wrappers. Likethe document, the XPath context need to be freed explicitly, +also not thatthe result of the XPath query may point back to the document +tree and hencethe document must be freed after the result of the query is +used.

                  xpathext.py:

                  This test shows how to extend the XPath engine with functions written +inpython:

                  import libxml2
                   
                   def foo(ctx, x):
                       return x + 1
                  @@ -226,9 +225,9 @@ res = ctxt.xpathEval("foo(1)")
                   if res != 2:
                       print "xpath extension failure"
                   doc.freeDoc()
                  -ctxt.xpathFreeContext()

                  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 (but +thatpart 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 +extensionfunction 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 work +at 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 where +allallocated block in the library are tracked. The prologue then cleans up +thelibrary state and checks that all allocated memory has been freed. If not +itcalls dumpMemory() which saves that list in a .memdumpfile.

                  Daniel Veillard

                diff --git a/doc/threads.html b/doc/threads.html index 8082dbd8..09a2b229 100644 --- a/doc/threads.html +++ b/doc/threads.html @@ -7,15 +7,17 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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't +testedseriously.

                Daniel Veillard

                diff --git a/doc/tree.html b/doc/tree.html index 65566379..8cf4c0f3 100644 --- a/doc/tree.html +++ b/doc/tree.html @@ -7,22 +7,23 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -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. The +valuereturned is an xmlDocPtr(i.e., a pointer to +anxmlDocstructure). This structure contains information +suchas the file name, the document type, and a +childrenpointerwhich is the root of the document (or more +exactly the first child under theroot which is the document). The tree is +made of xmlNodes,chained in double-linked lists of siblings +and with a children<->parentrelationship. An xmlNode can also carry +properties (a chain of xmlAttrstructures). An attribute may have a value +which is a list of TEXT orENTITY_REF nodes.

                Here is an example (erroneous with respect to the XML spec since +thereshould be only one ELEMENT under the root):

                 structure.gif

                In the source package there is a small program (not installed by +default)called xmllintwhich parses XML files given as +argument andprints them back as parsed. This is useful for detecting errors +both in XMLcode and in the XML parser itself. It has an option +--debugwhich prints the actual in-memory structure of the +document; here is theresult with the examplegiven +before:

                DOCUMENT
                 version=1.0
                 standalone=true
                   ELEMENT EXAMPLE
                diff --git a/doc/upgrade.html b/doc/upgrade.html
                index 59815ba0..b44ca96c 100644
                --- a/doc/upgrade.html
                +++ b/doc/upgrade.html
                @@ -7,100 +7,102 @@ H1 {font-family: Verdana,Arial,Helvetica}
                 H2 {font-family: Verdana,Arial,Helvetica}
                 H3 {font-family: Verdana,Arial,Helvetica}
                 A:link, A:visited, A:active { text-decoration: underline }
                -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. -
                3. 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+
                4. -
                5. 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.
                6. -
                7. 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. -
                  3. 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.
                  4. -

                  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 serious +backwardincompatible changes. The main goals were:

                  • a general cleanup. A number of mistakes inherited from the very + earlyversions couldn't be changed due to compatibility constraints. + Examplethe "childs" element in the nodes.
                  • +
                  • Uniformization of the various nodes, at least for their header and + linkparts (doc, parent, children, prev, next), the goal is a + simplerprogramming model and simplifying the task of the DOM + implementors.
                  • +
                  • better conformances to the XML specification, for example version + 1.xhad an heuristic to try to detect ignorable white spaces. As a result + theSAX event generated were ignorableWhitespace() while the spec + requirescharacter() in that case. This also mean that a number of DOM + nodecontaining blank text may populate the DOM tree which were not + presentbefore.
                  • +

                  How to fix libxml-1.x code:

                  So client code of libxml designed to run with version 1.x may have to +bechanged to compile against version 2.x of libxml. Here is a list of +changesthat I have collected, they may not be sufficient, so in case you find +otherchange which are required, drop +me amail:

                  1. The package name have changed from libxml to libxml2, the library + nameis now -lxml2 . There is a new xml2-config script which should be + used toselect the right parameters libxml2
                  2. +
                  3. Node childsfield has been + renamedchildrenso s/childs/children/g should be + applied(probability of having "childs" anywhere else is close to 0+
                  4. +
                  5. The document don't have anymore a rootelement it + hasbeen replaced by childrenand usually you will get + alist of element here. For example a Dtd element for the internal + subsetand it's declaration may be found in that list, as well as + processinginstructions or comments found before or after the document + root element.Use xmlDocGetRootElement(doc)to get the + root element ofa document. Alternatively if you are sure to not reference + DTDs nor havePIs or comments before or after the root + elements/->root/->children/g will probably do it.
                  6. +
                  7. The white space issue, this one is more complex, unless special case + ofvalidating parsing, the line breaks and spaces usually used for + indentingand formatting the document content becomes significant. So they + arereported by SAX and if your using the DOM tree, corresponding nodes + aregenerated. Too approach can be taken: +
                    1. lazy one, use the compatibility + callxmlKeepBlanksDefault(0)but be aware that you + arerelying on a special (and possibly broken) set of heuristics + oflibxml to detect ignorable blanks. Don't complain if it breaks + ormake your application not 100% clean w.r.t. to it's input.
                    2. +
                    3. the Right Way: change you code to accept possibly + insignificantblanks characters, or have your tree populated with + weird blank textnodes. You can spot them using the commodity + functionxmlIsBlankNode(node)returning 1 for such + blanknodes.
                    4. +

                    Note also that with the new default the output functions don't add + anyextra indentation when saving a tree in order to be able to round + trip(read and save) without inflating the document with extra + formattingchars.

                  8. -
                  9. 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 +
                  10. The include path has changed to $prefix/libxml/ and the + includesthemselves uses this new prefix in includes instructions... If + you 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 out + ofthe box

                  11. -
                  12. xmlDetectCharEncoding takes an extra argument indicating the length in - byte of the head of the document available for character detection.
                  13. -

                  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. -
                  3. similar identifiers defined via macros for the child and root fields: - respectively xmlChildrenNode and - xmlRootNode
                  4. -
                  5. a new macro LIBXML_TEST_VERSION which should be - inserted once in the client code
                  6. -

                  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. -
                  3. find all occurrences where the xmlDoc root field is - used and change it to xmlRootNode
                  4. -
                  5. similarly find all occurrences where the xmlNode - childs field is used and change it to - xmlChildrenNode
                  6. -
                  7. add a LIBXML_TEST_VERSION macro somewhere in your - main() or in the library init entry point
                  8. +
                  9. xmlDetectCharEncoding takes an extra argument indicating the length + inbyte of the head of the document available for character detection.
                  10. +

                  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 +releasedto allow smooth upgrade of existing libxml v1code while +retainingcompatibility. They offers the following:

                  1. similar include naming, one should + use#include<libxml/...>in both cases.
                  2. +
                  3. similar identifiers defined via macros for the child and root + fields:respectively + xmlChildrenNodeandxmlRootNode
                  4. +
                  5. a new macro LIBXML_TEST_VERSIONwhich should beinserted + once in the client code
                  6. +

                  So the roadmap to upgrade your existing libxml applications is +thefollowing:

                  1. install the libxml-1.8.8 (and libxml-devel-1.8.8) packages
                  2. +
                  3. find all occurrences where the xmlDoc rootfield isused + and change it to xmlRootNode
                  4. +
                  5. similarly find all occurrences where the + xmlNodechildsfield is used and change it + toxmlChildrenNode
                  6. +
                  7. add a LIBXML_TEST_VERSIONmacro somewhere in + yourmain()or in the library init entry point
                  8. Recompile, check compatibility, it should still work
                  9. -
                  10. 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.
                  11. -
                  12. 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)
                  13. -
                  14. remove your config.cache, relaunch your configuration mechanism, and - recompile, if steps 2 and 3 were done right it should compile as-is
                  15. -
                  16. 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).
                  17. -

                  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

                  +
                8. Change your configure script to look first for xml2-config and fallback + using xml-config . Use the --cflags and --libs output of the commandas + the Include and Linking parameters needed to use libxml.
                9. +
                10. install libxml2-2.3.x and libxml2-devel-2.3.x (libxml-1.8.y + andlibxml-devel-1.8.y can be kept simultaneously)
                11. +
                12. remove your config.cache, relaunch your configuration mechanism, + andrecompile, if steps 2 and 3 were done right it should compile + as-is
                13. +
                14. Test that your application is still running correctly, if not this + maybe due to extra empty nodes due to formating spaces being kept in + libxml2contrary to libxml1, in that case insert xmlKeepBlanksDefault(1) + in yourcode before calling the parser (next + toLIBXML_TEST_VERSIONis a fine place).
                15. +

                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 +fromlibxml 1.x to 2.x than the ones you may have to patch for. The overall +codehas been considerably cleaned up and the conformance to the XML +specificationhas been drastically improved too. Don't take those changes as +an excuse tonot upgrade, it may cost a lot on the long term ...

                Daniel Veillard

                diff --git a/doc/xml.html b/doc/xml.html index e013dcc2..ab68aa37 100644 --- a/doc/xml.html +++ b/doc/xml.html @@ -3,42 +3,41 @@ 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

                +style="text-align: right; font-style: italic; font-size: 10pt">"Programmingwith +libxml2 is like the thrilling embrace of an exotic stranger." MarkPilgrim

                -

                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 the XML C parser and toolkit developed for the Gnome +project(but usable outside of the Gnome platform), it is free software +availableunder the MITLicense. +XML itself is a metalanguage to design markup languages, i.e.text language +where semantic and structure are added to the content usingextra "markup" +information enclosed between angle brackets. HTML is the mostwell-known +markup language. Though the library is written in C a +variety of language bindingsmake it available inother 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 is known to be very portable, the library should build and +workwithout serious troubles on a variety of systems (Linux, Unix, +Windows,CygWin, MacOS, MacOS X, RISC Os, OS/2, VMS, QNX, MVS, ...)

                -

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

                +

                Libxml2 implements a number of existing standards related to +markuplanguages:

                -

                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 arelatively +strictly compliant way. As of release 2.4.16, libxml2 passed all1800+ tests +from the OASIS XML +TestsSuite.

                -

                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 following +additionalspecifications 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/the + document model, but it doesn't implement the API itself, gdome2 doesthis + 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 + compatiblewith 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 make +anyconformance statement about it at the moment.

                Separate documents: