diff options
author | Daniel Veillard <veillard@src.gnome.org> | 2003-10-21 00:05:38 +0000 |
---|---|---|
committer | Daniel Veillard <veillard@src.gnome.org> | 2003-10-21 00:05:38 +0000 |
commit | 3e35f8e65884103baf7876039c7a2e78af0537fa (patch) | |
tree | 1e0be15896ad5d668c53fe3351203d1fccd49aca /doc | |
parent | 1d211e227372e5ed75a69fbad5f50d185d0af936 (diff) | |
download | libxml2-3e35f8e65884103baf7876039c7a2e78af0537fa.tar.gz |
preparing libxml2-2.6.0 updated and regenerated the docs and API moved the
* configure.in NEWS doc/libxml2.xsa: preparing libxml2-2.6.0
* doc/*: updated and regenerated the docs and API
* SAX2.c error.c tree.c: moved the line number to their proper
field in elements now.
Daniel
Diffstat (limited to 'doc')
-rw-r--r-- | doc/libxml2.xsa | 71 | ||||
-rw-r--r-- | doc/namespaces.html | 14 | ||||
-rw-r--r-- | doc/news.html | 64 | ||||
-rw-r--r-- | doc/xml.html | 84 |
4 files changed, 211 insertions, 22 deletions
diff --git a/doc/libxml2.xsa b/doc/libxml2.xsa index 93834bf0..abc669cf 100644 --- a/doc/libxml2.xsa +++ b/doc/libxml2.xsa @@ -8,9 +8,74 @@ </vendor> <product id="libxml2"> <name>libxml2</name> - <version>2.5.11</version> - <last-release> Sep 9 2003</last-release> + <version>2.6.0</version> + <last-release> Oct 20 2003</last-release> <info-url>http://xmlsoft.org/</info-url> - <changes>A bugfix only release:</changes> + <changes> - 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 + - 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 + - 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. + - 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. + +</changes> </product> </xsa> diff --git a/doc/namespaces.html b/doc/namespaces.html index 6f15c5fd..37f28e1a 100644 --- a/doc/namespaces.html +++ b/doc/namespaces.html @@ -34,21 +34,17 @@ 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 <code>ns</code> field pointing to an xmlNs structure detailing the namespace -prefix and its URI.</p><p>@@Interfaces@@</p><pre> -xmlNodePtr node; +prefix and its URI.</p><p>@@Interfaces@@</p><pre>xmlNodePtr node; if(!strncmp(node->name,"mytag",5) && node->ns && !strcmp(node->ns->href,"http://www.mysite.com/myns/1.0")) { ... -} -</pre><p>Usually people object to using namespaces together with validity checking. +}</pre><p>Usually people object to using namespaces together with validity checking. I will try to make sure that using namespaces won't break validity checking, so even if you plan to use or currently are using validation I strongly suggest adding namespaces to your document. A default namespace scheme <code>xmlns="http://...."</code> should not break validity even on less flexible parsers. Using namespaces to mix and differentiate content coming -from multiple DTDs will certainly break current validation schemes. -To check such documents one needs to use schema-validation, which is supported -in libxml2 as well. See <a href="http://www.relaxng.org/">relagx-ng</a> and -<a href="http://www.w3c.org/XML/Schema">w3c-schema</a>. -</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> +from multiple DTDs will certainly break current validation schemes. To check +such documents one needs to use schema-validation, which is supported in +libxml2 as well. See <a href="http://www.relaxng.org/">relagx-ng</a> and <a href="http://www.w3c.org/XML/Schema">w3c-schema</a>.</p><p><a href="bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html> diff --git a/doc/news.html b/doc/news.html index a3b56fd2..ce9367a5 100644 --- a/doc/news.html +++ b/doc/news.html @@ -12,6 +12,70 @@ for a really accurate description</h3><p>Items not finished and worked on, get i to test those</p><ul><li>More testing on RelaxNG</li> <li>Finishing up <a href="http://www.w3.org/TR/xmlschema-1/">XML Schemas</a></li> +</ul><h3>2.6.0: Oct 20 2003</h3><ul><li>Major revision release: should be API and ABI compatible but got a lot + of change</li> + <li>Increased the library modularity, far more options can be stripped out, + a --with-minimum configuration will weight around 160KBytes</li> + <li>Use per parser and per document dictionnary, allocate names and small + text nodes from the dictionnary</li> + <li>Switch to a SAX2 like parser rewrote most of the XML parser core, + provides namespace resolution and defaulted attributes, minimize memory + allocations and copies, namespace checking and specific error handling, + immutable buffers, make predefined entities static structures, etc...</li> + <li>rewrote all the error handling in the library, all errors can be + intercepted at a structured level, with precise information + available.</li> + <li>New simpler and more generic XML and HTML parser APIs, allowing to + easilly modify the parsing options and reuse parser context for multiple + consecutive documents.</li> + <li>Similar new APIs for the xmlReader, for options and reuse, provided new + functions to access content as const strings, use them for Python + bindings</li> + <li>a lot of other smaller API improvements: xmlStrPrintf (Aleksey Sanin), + Walker i.e. reader on a document tree based on Alfred Mickautsch code, + make room in nodes for line numbers, reference counting and future PSVI + extensions, generation of character ranges to be checked with faster + algorithm (William), xmlParserMaxDepth (Crutcher Dunnavant), buffer + access</li> + <li>New xmlWriter API provided by Alfred Mickautsch</li> + <li>Schemas: base64 support by Anthony Carrico</li> + <li>Parser<->HTTP integration fix, proper processing of the Mime-Type + and charset informations if available.</li> + <li>Relax-NG: bug fixes including the one reported by Martijn Faassen and + zeroOrMore, better error reporting.</li> + <li>Python bindings (Stéphane Bidoul), never use stdout for errors + output</li> + <li>Portability: all the headers have macros for export and calling + convention definitions (Igor Zlatkovic), VMS update (Craig A. Berry), + Windows: threads (Jesse Pelton), Borland compiler (Eric Zurcher, Igor), + Mingw (Igor), typos (Mark Vakoc), beta version (Stephane Bidoul), + warning cleanups on AIX and MIPS compilers (William Brack), BeOS (Marcin + 'Shard' Konicki)</li> + <li>Documentation fixes and README (William Brack), search fix (William), + tutorial updates (John Fleck), namespace docs (Stefan Kost)</li> + <li>Bug fixes: xmlCleanupParser (Dave Beckett), threading uninitialized + mutexes, HTML doctype lowercase, SAX/IO (William), compression detection + and restore (William), attribute declaration in DTDs (William), namespace + on attribute in HTML output (William), input filename (Rob Richards), + namespace DTD validation, xmlReplaceNode (Chris Ryland), I/O callbacks + (Markus Keim), CDATA serialization (Shaun McCance), xmlReader (Peter + Derr), high codepoint charref like &#x10FFFF;, buffer access in push + mode (Justin Fletcher), TLS threads on Windows (Jesse Pelton), XPath bug + (William), xmlCleanupParser (Marc Liyanage), CDATA output (William), HTTP + error handling.</li> + <li>xmllint options: --dtdvalidfpi for Tobias Reif, --sax1 for compat + testing, --nodict for building without tree dictionnary, --nocdata to + replace CDATA by text, --nsclean to remove surperfluous namespace + declarations</li> + <li>added xml2-config --libtool-libs option from Kevin P. Fleming</li> + <li>a lot of profiling and tuning of the code, speedup patch for + xmlSearchNs() by Luca Padovani. The xmlReader should do far less + allocation and it speed should get closer to SAX. Chris Anderson worked + on speeding and cleaning up repetitive checking code.</li> + <li>cleanup of "make tests"</li> + <li>libxml-2.0-uninstalled.pc from Malcolm Tredinnick</li> + <li>deactivated the broken docBook SGML parser code and plugged the XML + parser instead.</li> </ul><h3>2.5.11: Sep 9 2003</h3><p>A bugfix only release:</p><ul><li>risk of crash in Relax-NG</li> <li>risk of crash when using multithreaded programs</li> </ul><h3>2.5.10: Aug 15 2003</h3><p>A bugfixes only release</p><ul><li>Windows Makefiles (William Brack)</li> diff --git a/doc/xml.html b/doc/xml.html index f7fcdaaf..07b545fe 100644 --- a/doc/xml.html +++ b/doc/xml.html @@ -661,6 +661,74 @@ to test those</p> Schemas</a></li> </ul> +<h3>2.6.0: Oct 20 2003</h3> +<ul> + <li>Major revision release: should be API and ABI compatible but got a lot + of change</li> + <li>Increased the library modularity, far more options can be stripped out, + a --with-minimum configuration will weight around 160KBytes</li> + <li>Use per parser and per document dictionnary, allocate names and small + text nodes from the dictionnary</li> + <li>Switch to a SAX2 like parser rewrote most of the XML parser core, + provides namespace resolution and defaulted attributes, minimize memory + allocations and copies, namespace checking and specific error handling, + immutable buffers, make predefined entities static structures, etc...</li> + <li>rewrote all the error handling in the library, all errors can be + intercepted at a structured level, with precise information + available.</li> + <li>New simpler and more generic XML and HTML parser APIs, allowing to + easilly modify the parsing options and reuse parser context for multiple + consecutive documents.</li> + <li>Similar new APIs for the xmlReader, for options and reuse, provided new + functions to access content as const strings, use them for Python + bindings</li> + <li>a lot of other smaller API improvements: xmlStrPrintf (Aleksey Sanin), + Walker i.e. reader on a document tree based on Alfred Mickautsch code, + make room in nodes for line numbers, reference counting and future PSVI + extensions, generation of character ranges to be checked with faster + algorithm (William), xmlParserMaxDepth (Crutcher Dunnavant), buffer + access</li> + <li>New xmlWriter API provided by Alfred Mickautsch</li> + <li>Schemas: base64 support by Anthony Carrico</li> + <li>Parser<->HTTP integration fix, proper processing of the Mime-Type + and charset informations if available.</li> + <li>Relax-NG: bug fixes including the one reported by Martijn Faassen and + zeroOrMore, better error reporting.</li> + <li>Python bindings (Stéphane Bidoul), never use stdout for errors + output</li> + <li>Portability: all the headers have macros for export and calling + convention definitions (Igor Zlatkovic), VMS update (Craig A. Berry), + Windows: threads (Jesse Pelton), Borland compiler (Eric Zurcher, Igor), + Mingw (Igor), typos (Mark Vakoc), beta version (Stephane Bidoul), + warning cleanups on AIX and MIPS compilers (William Brack), BeOS (Marcin + 'Shard' Konicki)</li> + <li>Documentation fixes and README (William Brack), search fix (William), + tutorial updates (John Fleck), namespace docs (Stefan Kost)</li> + <li>Bug fixes: xmlCleanupParser (Dave Beckett), threading uninitialized + mutexes, HTML doctype lowercase, SAX/IO (William), compression detection + and restore (William), attribute declaration in DTDs (William), namespace + on attribute in HTML output (William), input filename (Rob Richards), + namespace DTD validation, xmlReplaceNode (Chris Ryland), I/O callbacks + (Markus Keim), CDATA serialization (Shaun McCance), xmlReader (Peter + Derr), high codepoint charref like &#x10FFFF;, buffer access in push + mode (Justin Fletcher), TLS threads on Windows (Jesse Pelton), XPath bug + (William), xmlCleanupParser (Marc Liyanage), CDATA output (William), HTTP + error handling.</li> + <li>xmllint options: --dtdvalidfpi for Tobias Reif, --sax1 for compat + testing, --nodict for building without tree dictionnary, --nocdata to + replace CDATA by text, --nsclean to remove surperfluous namespace + declarations</li> + <li>added xml2-config --libtool-libs option from Kevin P. Fleming</li> + <li>a lot of profiling and tuning of the code, speedup patch for + xmlSearchNs() by Luca Padovani. The xmlReader should do far less + allocation and it speed should get closer to SAX. Chris Anderson worked + on speeding and cleaning up repetitive checking code.</li> + <li>cleanup of "make tests"</li> + <li>libxml-2.0-uninstalled.pc from Malcolm Tredinnick</li> + <li>deactivated the broken docBook SGML parser code and plugged the XML + parser instead.</li> +</ul> + <h3>2.5.11: Sep 9 2003</h3> <p>A bugfix only release:</p> @@ -3757,15 +3825,12 @@ just a shortcut for the full URI). In libxml, element and attributes have an prefix and its URI.</p> <p>@@Interfaces@@</p> - -<pre> -xmlNodePtr node; +<pre>xmlNodePtr node; if(!strncmp(node->name,"mytag",5) && node->ns && !strcmp(node->ns->href,"http://www.mysite.com/myns/1.0")) { ... -} -</pre> +}</pre> <p>Usually people object to using namespaces together with validity checking. I will try to make sure that using namespaces won't break validity checking, @@ -3773,11 +3838,10 @@ so even if you plan to use or currently are using validation I strongly suggest adding namespaces to your document. A default namespace scheme <code>xmlns="http://...."</code> should not break validity even on less flexible parsers. Using namespaces to mix and differentiate content coming -from multiple DTDs will certainly break current validation schemes. -To check such documents one needs to use schema-validation, which is supported -in libxml2 as well. See <a href="http://www.relaxng.org/">relagx-ng</a> and -<a href="http://www.w3c.org/XML/Schema">w3c-schema</a>. -</p> +from multiple DTDs will certainly break current validation schemes. To check +such documents one needs to use schema-validation, which is supported in +libxml2 as well. See <a href="http://www.relaxng.org/">relagx-ng</a> and <a +href="http://www.w3c.org/XML/Schema">w3c-schema</a>.</p> <h2><a name="Upgrading">Upgrading 1.x code</a></h2> |