diff options
| author | Daniel Veillard <veillard@src.gnome.org> | 2006-01-05 15:29:44 +0000 |
|---|---|---|
| committer | Daniel Veillard <veillard@src.gnome.org> | 2006-01-05 15:29:44 +0000 |
| commit | 6795260135a78da60182504a2d7efb4e3177eb57 (patch) | |
| tree | 084d0f43c676fd0f4544d8e2064dbdda056404c0 /doc/xml.html | |
| parent | bb2074e8ff3d80bb7e6fa6c7ca3ead5a23243ab7 (diff) | |
| download | libxml2-6795260135a78da60182504a2d7efb4e3177eb57.tar.gz | |
upated the news regenerated the docs, preparing for release of 2.6.23LIBXML2_2_6_23
* NEWS configure.in libxml.spec.in testapi.c doc/*: upated the news
regenerated the docs, preparing for release of 2.6.23
* pattern.c xmlschemas.c: fixed some comments
Daniel
Diffstat (limited to 'doc/xml.html')
| -rw-r--r-- | doc/xml.html | 500 |
1 files changed, 280 insertions, 220 deletions
diff --git a/doc/xml.html b/doc/xml.html index 7f5dec64..6ecd81cf 100644 --- a/doc/xml.html +++ b/doc/xml.html @@ -3,14 +3,15 @@ <html> <head> <title>The XML C parser and toolkit of Gnome</title> - <meta name="GENERATOR" content="amaya 5.1"> + <meta name="GENERATOR" content="amaya 8.5, see http://www.w3.org/Amaya/"> <meta http-equiv="Content-Type" content="text/html"> </head> <body bgcolor="#ffffff"> <h1 align="center">The XML C parser and toolkit of Gnome</h1> -<h1>Note: this is the flat content of the <a href="index.html">web site</a></h1> +<h1>Note: this is the flat content of the <a href="index.html">web +site</a></h1> <h1 style="text-align: center">libxml, a.k.a. gnome-xml</h1> @@ -123,7 +124,6 @@ benchmark</a> on sourceforge February 2004 (smaller is better):</p> alt="benchmark results for Expat Xerces libxml2 Oracle and Sun toolkits"></p> --------------> - <p>Logo designed by <a href="mailto:liyanage@access.ch">Marc Liyanage</a>.</p> <h2><a name="Introducti">Introduction</a></h2> @@ -314,41 +314,49 @@ libxml2</p> <p><code>CFLAGS=`xml2-config --cflags`</code></p> <p><code>LIBS=`xml2-config --libs`</code></p> </li> - <li><em>I want to install my own copy of libxml2 in my home directory and link - my programs against it, but it doesn't work</em> + <li><em>I want to install my own copy of libxml2 in my home directory and + link my programs against it, but it doesn't work</em> <p>There are many different ways to accomplish this. Here is one way to - do this under Linux. Suppose your home directory is <code>/home/user. - </code>Then:</p> - <ul><li>Create a subdirectory, let's call it <code>myxml</code></li> + do this under Linux. Suppose your home directory is <code>/home/user. + </code>Then:</p> + <ul> + <li>Create a subdirectory, let's call it <code>myxml</code></li> <li>unpack the libxml2 distribution into that subdirectory</li> - <li>chdir into the unpacked distribution (<code>/home/user/myxml/libxml2 - </code>)</li> + <li>chdir into the unpacked distribution + (<code>/home/user/myxml/libxml2 </code>)</li> <li>configure the library using the "<code>--prefix</code>" switch, - specifying an installation subdirectory in <code>/home/user/myxml</code>, - e.g. - <p><code>./configure --prefix /home/user/myxml/xmlinst</code> {other - configuration options}</p></li> + specifying an installation subdirectory in + <code>/home/user/myxml</code>, e.g. + <p><code>./configure --prefix /home/user/myxml/xmlinst</code> {other + configuration options}</p> + </li> <li>now run <code>make</code> followed by <code>make install</code></li> <li>At this point, the installation subdirectory contains the complete - "private" include files, library files and binary program files (e.g. - xmllint), located in - <p> <code>/home/user/myxml/xmlinst/lib, /home/user/myxml/xmlinst/include - </code> and <code> /home/user/myxml/xmlinst/bin</code></p> - respectively.</li> - <li>In order to use this "private" library, you should first add it - to the beginning of your default PATH (so that your own private - program files such as xmllint will be used instead of the normal - system ones). To do this, the Bash command would be - <p><code>export PATH=/home/user/myxml/xmlinst/bin:$PATH</code></p></li> + "private" include files, library files and binary program files (e.g. + xmllint), located in + <p><code>/home/user/myxml/xmlinst/lib, + /home/user/myxml/xmlinst/include </code> and <code> + /home/user/myxml/xmlinst/bin</code></p> + respectively.</li> + <li>In order to use this "private" library, you should first add it to + the beginning of your default PATH (so that your own private program + files such as xmllint will be used instead of the normal system + ones). To do this, the Bash command would be + <p><code>export PATH=/home/user/myxml/xmlinst/bin:$PATH</code></p> + </li> <li>Now suppose you have a program <code>test1.c</code> that you would - like to compile with your "private" library. Simply compile it - using the command <p><code>gcc `xml2-config --cflags --libs` -o test - test.c</code></p> Note that, because your PATH has been set with <code> - /home/user/myxml/xmlinst/bin</code> at the beginning, the - xml2-config program which you just installed will be used instead of - the system default one, and this will <em>automatically</em> get the - correct libraries linked with your program.</li></ul> - </li><p/> + like to compile with your "private" library. Simply compile it using + the command + <p><code>gcc `xml2-config --cflags --libs` -o test test.c</code></p> + Note that, because your PATH has been set with <code> + /home/user/myxml/xmlinst/bin</code> at the beginning, the xml2-config + program which you just installed will be used instead of the system + default one, and this will <em>automatically</em> get the correct + libraries linked with your program.</li> + </ul> + </li> + + <p></p> <li><em>xmlDocDump() generates output on one line.</em> <p>Libxml2 will not <strong>invent</strong> spaces in the content of a document since <strong>all spaces in the content of a document are @@ -662,14 +670,17 @@ href="http://xmlsoft.org/sources/win32/">win32</a> directory.</p> maintainer of the Windows port, <a href="http://www.zlatkovic.com/projects/libxml/index.html">he provides binaries</a>.</li> - <li>Blastwave provides - <a href="http://www.blastwave.org/packages.php/libxml2">Solaris binaries</a>.</li> + <li>Blastwave provides <a + href="http://www.blastwave.org/packages.php/libxml2">Solaris + binaries</a>.</li> <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a> provides <a href="http://www.explain.com.au/oss/libxml2xslt.html">Mac Os X binaries</a>.</li> <li>The HP-UX porting center provides <a href="http://hpux.connect.org.uk/hppd/hpux/Gnome/">HP-UX binaries</a></li> - <li>Bull provides precompiled <a href="http://gnome.bullfreeware.com/new_index.html">RPMs for AIX</a> as patr of their GNOME packages</li> + <li>Bull provides precompiled <a + href="http://gnome.bullfreeware.com/new_index.html">RPMs for AIX</a> as + patr of their GNOME packages</li> </ul> <p>If you know other supported binary ports, please <a @@ -715,176 +726,223 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p> <p>There is the list of public releases:</p> +<h3>2.6.23: Jan 5 2006</h3> +<ul> + <li>portability fixes: Windows (Rob Richards), getaddrinfo on Windows + (Kolja Nowak, Rob Richards), icc warnings (Kjartan Maraas), + --with-minimum compilation fixes (William Brack), error case handling fix + on Solaris (Albert Chin), don't use 'list' as parameter name reported by + Samuel Diaz Garcia, more old Unices portability fixes (Albert Chin), + MinGW compilation (Mark Junker), HP-UX compiler warnings (Rick Jones), + </li> + <li>code cleanup: xmlReportError (Adrian Mouat), remove xmlBufferClose + (Geert Jansen), unreachable code (Oleksandr Kononenko), refactoring + parsing code (Bjorn Reese)</li> + <li>bug fixes: xmlBuildRelativeURI and empty path (William Brack), + combinatory explosion and performances in regexp code, leak in + xmlTextReaderReadString(), xmlStringLenDecodeEntities problem (Massimo + Morara), Identity Constraints bugs and a segfault (Kasimier Buchcik), + XPath pattern based evaluation bugs (DV & 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)</li> + <li>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), </li> + <li>documentation: typo (Michael Day), libxml man page (Albert Chin), save + function to XML buffer (Geert Jansen), small doc fix (Aron Stansvik), + </li> +</ul> + <h3>2.6.22: Sep 12 2005</h3> <ul> <li>build fixes: compile without schematron (Stéphane Bidoul)</li> <li>bug fixes: xmlDebugDumpNode on namespace node (Oleg Paraschenko)i, - CDATA push parser bug, xmlElemDump problem with XHTML1 doc, - XML_FEATURE_xxx clash with expat headers renamed XML_WITH_xxx, - fix some output formatting for meta element (Rob Richards), - script and style XHTML1 serialization (David Madore), Attribute - derivation fixups in XSD (Kasimier Buchcik), better IDC error - reports (Kasimier Buchcik) - </li> - <li>improvements: add XML_SAVE_NO_EMPTY xmlSaveOption (Rob Richards), - add XML_SAVE_NO_XHTML xmlSaveOption, XML Schemas improvements - preparing for derive (Kasimier Buchcik).</li> + CDATA push parser bug, xmlElemDump problem with XHTML1 doc, + XML_FEATURE_xxx clash with expat headers renamed XML_WITH_xxx, fix some + output formatting for meta element (Rob Richards), script and style + XHTML1 serialization (David Madore), Attribute derivation fixups in XSD + (Kasimier Buchcik), better IDC error reports (Kasimier Buchcik)</li> + <li>improvements: add XML_SAVE_NO_EMPTY xmlSaveOption (Rob Richards), add + XML_SAVE_NO_XHTML xmlSaveOption, XML Schemas improvements preparing for + derive (Kasimier Buchcik).</li> <li>documentation: generation of gtk-doc like docs, integration with - devhelp.</li> + devhelp.</li> </ul> + <h3>2.6.21: Sep 4 2005</h3> <ul> <li>build fixes: Cygwin portability fixes (Gerrit P. Haase), calling - convention problems on Windows (Marcus Boerger), cleanups based on - Linus' sparse tool, update of win32/configure.js (Rob Richards), - remove warnings on Windows(Marcus Boerger), compilation without SAX1, - detection of the Python binary, use $GCC inestad of $CC = 'gcc' (Andrew - W. Nosenko), compilation/link with threads and old gcc, compile - problem by C370 on Z/OS, </li> + convention problems on Windows (Marcus Boerger), cleanups based on Linus' + sparse tool, update of win32/configure.js (Rob Richards), remove warnings + on Windows(Marcus Boerger), compilation without SAX1, detection of the + Python binary, use $GCC inestad of $CC = 'gcc' (Andrew W. Nosenko), + compilation/link with threads and old gcc, compile problem by C370 on + Z/OS,</li> <li>bug fixes: http_proxy environments (Peter Breitenlohner), HTML UTF-8 - bug (Jiri Netolicky), XPath NaN compare bug (William Brack), - htmlParseScript potential bug, Schemas regexp handling of spaces, - Base64 Schemas comparisons NIST passes, automata build error xsd:all, - xmlGetNodePath for namespaced attributes (Alexander Pohoyda), - xmlSchemas foreign namespaces handling, XML Schemas facet comparison - (Kupriyanov Anatolij), xmlSchemaPSimpleTypeErr error report (Kasimier - Buchcik), xml: namespace ahndling in Schemas (Kasimier), empty model - group in Schemas (Kasimier), wilcard in Schemas (Kasimier), URI - composition (William), xs:anyType in Schemas (Kasimier), Python resolver - emmitting error messages directly, Python xmlAttr.parent (Jakub Piotr - Clapa), trying to fix the file path/URI conversion, - xmlTextReaderGetAttribute fix (Rob Richards), xmlSchemaFreeAnnot memleak - (Kasimier), HTML UTF-8 serialization, streaming XPath, Schemas determinism - detection problem, XInclude bug, Schemas context type (Dean Hill), - validation fix (Derek Poon), xmlTextReaderGetAttribute[Ns] namespaces - (Rob Richards), Schemas type fix (Kuba Nowakowski), UTF-8 parser bug, - error in encoding handling, xmlGetLineNo fixes, bug on entities handling, - entity name extraction in error handling with XInclude, text nodes - in HTML body tags (Gary Coady), xml:id and IDness at the treee level - fixes, XPath streaming patterns bugs.</li> + bug (Jiri Netolicky), XPath NaN compare bug (William Brack), + htmlParseScript potential bug, Schemas regexp handling of spaces, Base64 + Schemas comparisons NIST passes, automata build error xsd:all, + xmlGetNodePath for namespaced attributes (Alexander Pohoyda), xmlSchemas + foreign namespaces handling, XML Schemas facet comparison (Kupriyanov + Anatolij), xmlSchemaPSimpleTypeErr error report (Kasimier Buchcik), xml: + namespace ahndling in Schemas (Kasimier), empty model group in Schemas + (Kasimier), wilcard in Schemas (Kasimier), URI composition (William), + xs:anyType in Schemas (Kasimier), Python resolver emmitting error + messages directly, Python xmlAttr.parent (Jakub Piotr Clapa), trying to + fix the file path/URI conversion, xmlTextReaderGetAttribute fix (Rob + Richards), xmlSchemaFreeAnnot memleak (Kasimier), HTML UTF-8 + serialization, streaming XPath, Schemas determinism detection problem, + XInclude bug, Schemas context type (Dean Hill), validation fix (Derek + Poon), xmlTextReaderGetAttribute[Ns] namespaces (Rob Richards), Schemas + type fix (Kuba Nowakowski), UTF-8 parser bug, error in encoding handling, + xmlGetLineNo fixes, bug on entities handling, entity name extraction in + error handling with XInclude, text nodes in HTML body tags (Gary Coady), + xml:id and IDness at the treee level fixes, XPath streaming patterns + bugs.</li> <li>improvements: structured interfaces for schemas and RNG error reports - (Marcus Boerger), optimization of the char data inner loop parsing - (thanks to Behdad Esfahbod for the idea), schematron validation - though not finished yet, xmlSaveOption to omit XML declaration, - keyref match error reports (Kasimier), formal expression handling - code not plugged yet, more lax mode for the HTML parser, - parser XML_PARSE_COMPACT option for text nodes allocation.</li> + (Marcus Boerger), optimization of the char data inner loop parsing + (thanks to Behdad Esfahbod for the idea), schematron validation though + not finished yet, xmlSaveOption to omit XML declaration, keyref match + error reports (Kasimier), formal expression handling code not plugged + yet, more lax mode for the HTML parser, parser XML_PARSE_COMPACT option + for text nodes allocation.</li> <li>documentation: xmllint man page had --nonet duplicated</li> </ul> + <h3>2.6.20: Jul 10 2005</h3> <ul> - <li> build fixes: Windows build (Rob Richards), Mingw compilation (Igor - Zlatkovic), Windows Makefile (Igor), gcc warnings (Kasimier and - andriy@google.com), use gcc weak references to pthread to avoid the - pthread dependancy on Linux, compilation problem (Steve Nairn), - compiling of subset (Morten Welinder), IPv6/ss_family compilation - (William Brack), compilation when disabling parts of the library, - standalone test distribution. - </li> - <li> bug fixes: bug in lang(), memory cleanup on errors (William Brack), - HTTP query strings (Aron Stansvik), memory leak in DTD (William), - integer overflow in XPath (William), nanoftp buffer size, pattern - "." apth fixup (Kasimier), leak in tree reported by Malcolm Rowe, - replaceNode patch (Brent Hendricks), CDATA with NULL content - (Mark Vakoc), xml:base fixup on XInclude (William), pattern - fixes (William), attribute bug in exclusive c14n (Aleksey Sanin), - xml:space and xml:lang with SAX2 (Rob Richards), namespace - trouble in complex parsing (Malcolm Rowe), XSD type QNames fixes - (Kasimier), XPath streaming fixups (William), RelaxNG bug (Rob Richards), - Schemas for Schemas fixes (Kasimier), removal of ID (Rob Richards), - a small RelaxNG leak, HTML parsing in push mode bug (James Bursa), - failure to detect UTF-8 parsing bugs in CDATA sections, areBlanks() - heuristic failure, duplicate attributes in DTD bug (William). - </li> - <li> improvements: lot of work on Schemas by Kasimier Buchcik both on - conformance and streaming, Schemas validation messages (Kasimier - Buchcik, Matthew Burgess), namespace removal at the python level - (Brent Hendricks), Update to new Schemas regression tests from - W3C/Nist (Kasimier), xmlSchemaValidateFile() (Kasimier), implementation - of xmlTextReaderReadInnerXml and xmlTextReaderReadOuterXml (James Wert), - standalone test framework and programs, new DOM import APIs - xmlDOMWrapReconcileNamespaces() xmlDOMWrapAdoptNode() and - xmlDOMWrapRemoveNode(), extension of xmllint capabilities for - SAX and Schemas regression tests, xmlStopParser() available in - pull mode too, ienhancement to xmllint --shell namespaces support, - Windows port of the standalone testing tools (Kasimier and William), - xmlSchemaValidateStream() xmlSchemaSAXPlug() and xmlSchemaSAXUnplug() - SAX Schemas APIs, Schemas xmlReader support. - </li> + <li>build fixes: Windows build (Rob Richards), Mingw compilation (Igor + Zlatkovic), Windows Makefile (Igor), gcc warnings (Kasimier and + andriy@google.com), use gcc weak references to pthread to avoid the + pthread dependancy on Linux, compilation problem (Steve Nairn), compiling + of subset (Morten Welinder), IPv6/ss_family compilation (William Brack), + compilation when disabling parts of the library, standalone test + distribution.</li> + <li>bug fixes: bug in lang(), memory cleanup on errors (William Brack), + HTTP query strings (Aron Stansvik), memory leak in DTD (William), integer + overflow in XPath (William), nanoftp buffer size, pattern "." apth fixup + (Kasimier), leak in tree reported by Malcolm Rowe, replaceNode patch + (Brent Hendricks), CDATA with NULL content (Mark Vakoc), xml:base fixup + on XInclude (William), pattern fixes (William), attribute bug in + exclusive c14n (Aleksey Sanin), xml:space and xml:lang with SAX2 (Rob + Richards), namespace trouble in complex parsing (Malcolm Rowe), XSD type + QNames fixes (Kasimier), XPath streaming fixups (William), RelaxNG bug + (Rob Richards), Schemas for Schemas fixes (Kasimier), removal of ID (Rob + Richards), a small RelaxNG leak, HTML parsing in push mode bug (James + Bursa), failure to detect UTF-8 parsing bugs in CDATA sections, + areBlanks() heuristic failure, duplicate attributes in DTD bug + (William).</li> + <li>improvements: lot of work on Schemas by Kasimier Buchcik both on + conformance and streaming, Schemas validation messages (Kasimier Buchcik, + Matthew Burgess), namespace removal at the python level (Brent + Hendricks), Update to new Schemas regression tests from W3C/Nist + (Kasimier), xmlSchemaValidateFile() (Kasimier), implementation of + xmlTextReaderReadInnerXml and xmlTextReaderReadOuterXml (James Wert), + standalone test framework and programs, new DOM import APIs + xmlDOMWrapReconcileNamespaces() xmlDOMWrapAdoptNode() and + xmlDOMWrapRemoveNode(), extension of xmllint capabilities for SAX and + Schemas regression tests, xmlStopParser() available in pull mode too, + ienhancement to xmllint --shell namespaces support, Windows port of the + standalone testing tools (Kasimier and William), + xmlSchemaValidateStream() xmlSchemaSAXPlug() and xmlSchemaSAXUnplug() SAX + Schemas APIs, Schemas xmlReader support.</li> </ul> + <h3>2.6.19: Apr 02 2005</h3> <ul> - <li> build fixes: drop .la from RPMs, --with-minimum build fix (William - Brack), use XML_SOCKLEN_T instead of SOCKLEN_T because it breaks with - AIX 5.3 compiler, fixed elfgcchack.h generation and PLT reduction - code on Linux/ELF/gcc4</li> - <li> bug fixes: schemas type decimal fixups (William Brack), xmmlint return - code (Gerry Murphy), small schemas fixes (Matthew Burgess and - GUY Fabrice), workaround "DAV:" namespace brokeness in c14n (Aleksey - Sanin), segfault in Schemas (Kasimier Buchcik), Schemas attribute - validation (Kasimier), Prop related functions and xmlNewNodeEatName - (Rob Richards), HTML serialization of name attribute on a elements, - Python error handlers leaks and improvement (Brent Hendricks), - uninitialized variable in encoding code, Relax-NG validation bug, - potential crash if gnorableWhitespace is NULL, xmlSAXParseDoc and - xmlParseDoc signatures, switched back to assuming UTF-8 in case - no encoding is given at serialization time</li> - <li> improvements: lot of work on Schemas by Kasimier Buchcik on facets - checking and also mixed handling.</li> + <li>build fixes: drop .la from RPMs, --with-minimum build fix (William + Brack), use XML_SOCKLEN_T instead of SOCKLEN_T because it breaks with AIX + 5.3 compiler, fixed elfgcchack.h generation and PLT reduction code on + Linux/ELF/gcc4</li> + <li>bug fixes: schemas type decimal fixups (William Brack), xmmlint return + code (Gerry Murphy), small schemas fixes (Matthew Burgess and GUY + Fabrice), workaround "DAV:" namespace brokeness in c14n (Aleksey Sanin), + segfault in Schemas (Kasimier Buchcik), Schemas attribute validation + (Kasimier), Prop related functions and xmlNewNodeEatName (Rob Richards), + HTML serialization of name attribute on a elements, Python error handlers + leaks and improvement (Brent Hendricks), uninitialized variable in + encoding code, Relax-NG validation bug, potential crash if + gnorableWhitespace is NULL, xmlSAXParseDoc and xmlParseDoc signatures, + switched back to assuming UTF-8 in case no encoding is given at + serialization time</li> + <li>improvements: lot of work on Schemas by Kasimier Buchcik on facets + checking and also mixed handling.</li> <li></li> </ul> + <h3>2.6.18: Mar 13 2005</h3> <ul> - <li> build fixes: warnings (Peter Breitenlohner), testapi.c generation, - Bakefile support (Francesco Montorsi), Windows compilation (Joel Reed), - some gcc4 fixes, HP-UX portability fixes (Rick Jones).</li> - <li> bug fixes: xmlSchemaElementDump namespace (Kasimier Buchcik), push and - xmlreader stopping on non-fatal errors, thread support for dictionnaries - reference counting (Gary Coady), internal subset and push problem, - URL saved in xmlCopyDoc, various schemas bug fixes (Kasimier), Python - paths fixup (Stephane Bidoul), xmlGetNodePath and namespaces, - xmlSetNsProp fix (Mike Hommey), warning should not count as error - (William Brack), xmlCreatePushParser empty chunk, XInclude parser - flags (William), cleanup FTP and HTTP code to reuse the uri parsing - and IPv6 (William), xmlTextWriterStartAttributeNS fix (Rob Richards), - XMLLINT_INDENT being empty (William), xmlWriter bugs (Rob Richards), - multithreading on Windows (Rich Salz), xmlSearchNsByHref fix (Kasimier), - Python binding leak (Brent Hendricks), aliasing bug exposed by gcc4 - on s390, xmlTextReaderNext bug (Rob Richards), Schemas decimal type - fixes (William Brack), xmlByteConsumed static buffer (Ben Maurer).</li> - <li> improvement: speedup parsing comments and DTDs, dictionnary support for - hash tables, Schemas Identity constraints (Kasimier), streaming XPath - subset, xmlTextReaderReadString added (Bjorn Reese), Schemas canonical - values handling (Kasimier), add xmlTextReaderByteConsumed (Aron - Stansvik), </li> - <li> Documentation: Wiki support (Joel Reed) + <li>build fixes: warnings (Peter Breitenlohner), testapi.c generation, + Bakefile support (Francesco Montorsi), Windows compilation (Joel Reed), + some gcc4 fixes, HP-UX portability fixes (Rick Jones).</li> + <li>bug fixes: xmlSchemaElementDump namespace (Kasimier Buchcik), push and + xmlreader stopping on non-fatal errors, thread support for dictionnaries + reference counting (Gary Coady), internal subset and push problem, URL + saved in xmlCopyDoc, various schemas bug fixes (Kasimier), Python paths + fixup (Stephane Bidoul), xmlGetNodePath and namespaces, xmlSetNsProp fix + (Mike Hommey), warning should not count as error (William Brack), + xmlCreatePushParser empty chunk, XInclude parser flags (William), cleanup + FTP and HTTP code to reuse the uri parsing and IPv6 (William), + xmlTextWriterStartAttributeNS fix (Rob Richards), XMLLINT_INDENT being + empty (William), xmlWriter bugs (Rob Richards), multithreading on Windows + (Rich Salz), xmlSearchNsByHref fix (Kasimier), Python binding leak (Brent + Hendricks), aliasing bug exposed by gcc4 on s390, xmlTextReaderNext bug + (Rob Richards), Schemas decimal type fixes (William Brack), + xmlByteConsumed static buffer (Ben Maurer).</li> + <li>improvement: speedup parsing comments and DTDs, dictionnary support for + hash tables, Schemas Identity constraints (Kasimier), streaming XPath + subset, xmlTextReaderReadString added (Bjorn Reese), Schemas canonical + values handling (Kasimier), add xmlTextReaderByteConsumed (Aron + Stansvik),</li> + <li>Documentation: Wiki support (Joel Reed)</li> </ul> + <h3>2.6.17: Jan 16 2005</h3> <ul> - <li>build fixes: Windows, warnings removal (William Brack), - maintainer-clean dependency(William), build in a different directory - (William), fixing --with-minimum configure build (William), BeOS - build (Marcin Konicki), Python-2.4 detection (William), compilation - on AIX (Dan McNichol)</li> + <li>build fixes: Windows, warnings removal (William Brack), + maintainer-clean dependency(William), build in a different directory + (William), fixing --with-minimum configure build (William), BeOS build + (Marcin Konicki), Python-2.4 detection (William), compilation on AIX (Dan + McNichol)</li> <li>bug fixes: xmlTextReaderHasAttributes (Rob Richards), xmlCtxtReadFile() - to use the catalog(s), loop on output (William Brack), XPath memory leak, - ID deallocation problem (Steve Shepard), debugDumpNode crash (William), - warning not using error callback (William), xmlStopParser bug (William), - UTF-16 with BOM on DTDs (William), namespace bug on empty elements - in push mode (Rob Richards), line and col computations fixups (Aleksey - Sanin), xmlURIEscape fix (William), xmlXPathErr on bad range (William), - patterns with too many steps, bug in RNG choice optimization, line - number sometimes missing. - </li> - <li>improvements: XSD Schemas (Kasimier Buchcik), python generator (William), - xmlUTF8Strpos speedup (William), unicode Python strings (William), - XSD error reports (Kasimier Buchcik), Python __str__ call serialize(). - </li> - <li>new APIs: added xmlDictExists(), GetLineNumber and GetColumnNumber - for the xmlReader (Aleksey Sanin), Dynamic Shared Libraries APIs - (mostly Joel Reed), error extraction API from regexps, new XMLSave - option for format (Phil Shafer)</li> - <li>documentation: site improvement (John Fleck), FAQ entries (William).</li> + to use the catalog(s), loop on output (William Brack), XPath memory leak, + ID deallocation problem (Steve Shepard), debugDumpNode crash (William), + warning not using error callback (William), xmlStopParser bug (William), + UTF-16 with BOM on DTDs (William), namespace bug on empty elements in + push mode (Rob Richards), line and col computations fixups (Aleksey + Sanin), xmlURIEscape fix (William), xmlXPathErr on bad range (William), + patterns with too many steps, bug in RNG choice optimization, line number + sometimes missing.</li> + <li>improvements: XSD Schemas (Kasimier Buchcik), python generator + (William), xmlUTF8Strpos speedup (William), unicode Python strings + (William), XSD error reports (Kasimier Buchcik), Python __str__ call + serialize().</li> + <li>new APIs: added xmlDictExists(), GetLineNumber and GetColumnNumber for + the xmlReader (Aleksey Sanin), Dynamic Shared Libraries APIs (mostly Joel + Reed), error extraction API from regexps, new XMLSave option for format + (Phil Shafer)</li> + <li>documentation: site improvement (John Fleck), FAQ entries + (William).</li> </ul> <h3>2.6.16: Nov 10 2004</h3> @@ -898,7 +956,7 @@ to the <a href="http://cvs.gnome.org/viewcvs/libxml2/">CVS</a> code base.</p> <li>documentation: fix to xmllint man page, some API function descritpion were updated.</li> <li>improvements: DTD validation APIs provided at the Python level (Brent - Hendricks) </li> + Hendricks)</li> </ul> <h3>2.6.15: Oct 27 2004</h3> @@ -2442,10 +2500,9 @@ or libxslt wrappers or bindings:</p> <li>Uwe Fechner also provides <a href="http://sourceforge.net/projects/idom2-pas/">idom2</a>, a DOM2 implementation for Kylix2/D5/D6 from Borland.</li> - <li>There is <a - href="http://rubyforge.org/projects/xml-tools/">bindings for Ruby</a> and - libxml2 bindings are also available in Ruby through the <a - href="http://libgdome-ruby.berlios.de/">libgdome-ruby</a> module + <li>There is <a href="http://rubyforge.org/projects/xml-tools/">bindings + for Ruby</a> and libxml2 bindings are also available in Ruby through the + <a href="http://libgdome-ruby.berlios.de/">libgdome-ruby</a> module maintained by Tobias Peters.</li> <li>Steve Ball and contributors maintains <a href="http://tclxml.sourceforge.net/">libxml2 and libxslt bindings for @@ -2456,14 +2513,15 @@ or libxslt wrappers or bindings:</p> libxslt as part of GNU ClasspathX project.</li> <li>Patrick McPhee provides Rexx bindings fof libxml2 and libxslt, look for <a href="http://www.interlog.com/~ptjm/software.html">RexxXML</a>.</li> - <li><a href="http://www.satimage.fr/software/en/xml_suite.html">Satimage</a> + <li><a + href="http://www.satimage.fr/software/en/xml_suite.html">Satimage</a> provides <a href="http://www.satimage.fr/software/en/downloads_osaxen.html">XMLLib osax</a>. This is an osax for Mac OS X with a set of commands to implement in AppleScript the XML DOM, XPATH and XSLT. Also includes commands for Property-lists (Apple's fast lookup table XML format.)</li> - <li>Francesco Montorsi developped -<a href="https://sourceforge.net/project/showfiles.php?group_id=51305&package_id=45182">wxXml2</a> + <li>Francesco Montorsi developped <a + href="https://sourceforge.net/project/showfiles.php?group_id=51305&package_id=45182">wxXml2</a> wrappers that interface libxml2, allowing wxWidgets applications to load/save/edit XML instances.</li> </ul> @@ -2473,10 +2531,11 @@ to be maintained as part of the library in the future, though the Python interface have not yet reached the completeness of the C API.</p> <p>Note that some of the Python purist dislike the default set of Python -bindings, rather than complaining I suggest they have a look at -<a href="http://codespeak.net/lxml/">lxml the more pythonic bindings for libxml2 and libxslt</a> and -<a href="http://codespeak.net/mailman/listinfo/lxml-dev">help Martijn Faassen</a> -complete those.</p> +bindings, rather than complaining I suggest they have a look at <a +href="http://codespeak.net/lxml/">lxml the more pythonic bindings for libxml2 +and libxslt</a> and <a +href="http://codespeak.net/mailman/listinfo/lxml-dev">help Martijn +Faassen</a> complete those.</p> <p><a href="mailto:stephane.bidoul@softwareag.com">Stéphane Bidoul</a> maintains <a href="http://users.skynet.be/sbi/libxml-python/">a Windows port @@ -3250,12 +3309,13 @@ of a number of things:</p> is I18N) , Unicode, characters and glyphs, I suggest you read a <a href="http://www.tbray.org/ongoing/When/200x/2003/04/06/Unicode">presentation</a> by Tim Bray on Unicode and why you should care about it.</p> + <p>If you don't understand why <b>it does not make sense to have a string -without knowing what encoding it uses</b>, then as Joel Spolsky said -<a href="http://www.joelonsoftware.com/articles/Unicode.html">please do -not write another line of code until you finish reading that article.</a>. -It is a prerequisite to understand this page, and avoid a lot of problems -with libxml2, XML or text processing in general.</p> +without knowing what encoding it uses</b>, then as Joel Spolsky said <a +href="http://www.joelonsoftware.com/articles/Unicode.html">please do not +write another line of code until you finish reading that article.</a>. It is +a prerequisite to understand this page, and avoid a lot of problems with +libxml2, XML or text processing in general.</p> <p>Table of Content:</p> <ol> @@ -3451,7 +3511,7 @@ encoding:</p> <trčs>lŕ</trčs> ~/XML -> ./xmllint --encode UTF-8 isolat1 <?xml version="1.0" encoding="UTF-8"?> -<très>lĂ </très> +<très>lĂ </très> ~/XML -> </pre> <p>The same processing is applied (and reuse most of the code) for HTML I18N @@ -3480,13 +3540,14 @@ set of encodings supported by iconv can be instantly be used by libxml. On a linux machine with glibc-2.1 the list of supported encodings and aliases fill 3 full pages, and include UCS-4, the full set of ISO-Latin encodings, and the various Japanese ones.</p> + <p>To convert from the UTF-8 values returned from the API to another encoding -then it is possible to use the function provided from -<a href="html/libxml-encoding.html">the encoding module</a> like -<a href="html/libxml-encoding.html#UTF8Toisolat1">UTF8Toisolat1</a>, or -use the POSIX -<a href="http://www.opengroup.org/onlinepubs/009695399/functions/iconv.html" ->iconv()</a> API directly.</p> +then it is possible to use the function provided from <a +href="html/libxml-encoding.html">the encoding module</a> like <a +href="html/libxml-encoding.html#UTF8Toisolat1">UTF8Toisolat1</a>, or use the +POSIX <a +href="http://www.opengroup.org/onlinepubs/009695399/functions/iconv.html">iconv()</a> +API directly.</p> <h4>Encoding aliases</h4> @@ -3672,19 +3733,19 @@ new output handler with the closing call deactivated:</p> the file: <pre>xmlOutputBufferPtr xmlOutputBufferCreateOwn(FILE *file, xmlCharEncodingHandlerPtr encoder) { - xmlOutputBufferPtr ret; - - if (xmlOutputCallbackInitialized == 0) - xmlRegisterDefaultOutputCallbacks(); - - if (file == NULL) return(NULL); - ret = xmlAllocOutputBuffer(encoder); - if (ret != NULL) { - ret->context = file; - ret->writecallback = xmlFileWrite; - ret->closecallback = NULL; /* No close callback */ - } - return(ret); + xmlOutputBufferPtr ret; + + if (xmlOutputCallbackInitialized == 0) + xmlRegisterDefaultOutputCallbacks(); + + if (file == NULL) return(NULL); + ret = xmlAllocOutputBuffer(encoder); + if (ret != NULL) { + ret->context = file; + ret->writecallback = xmlFileWrite; + ret->closecallback = NULL; /* No close callback */ + } + return(ret); } </pre> </li> <li>And then use it to save the document: @@ -4850,10 +4911,9 @@ Gnome CVS base under gnome-xml/example</p> <a href="http://www.w3.org/Signature/">XML Canonicalization and XML Digital Signature</a> <a href="http://www.aleksey.com/xmlsec/">implementations for libxml2</a></li> - <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a> - and contributors maintain <a - href="http://tclxml.sourceforge.net/">tcl bindings for libxml2 and - libxslt</a>, as well as <a + <li><a href="mailto:Steve.Ball@explain.com.au">Steve Ball</a> and + contributors maintain <a href="http://tclxml.sourceforge.net/">tcl + bindings for libxml2 and libxslt</a>, as well as <a href="http://tclxml.sf.net/tkxmllint.html">tkxmllint</a> a GUI for xmllint and <a href="http://tclxml.sf.net/tkxsltproc.html">tkxsltproc</a> a GUI for xsltproc.</li> |