diff options
Diffstat (limited to 'lib/xmerl/doc/src/notes.xml')
| -rw-r--r-- | lib/xmerl/doc/src/notes.xml | 680 |
1 files changed, 680 insertions, 0 deletions
diff --git a/lib/xmerl/doc/src/notes.xml b/lib/xmerl/doc/src/notes.xml new file mode 100644 index 0000000000..115c81a806 --- /dev/null +++ b/lib/xmerl/doc/src/notes.xml @@ -0,0 +1,680 @@ +<?xml version="1.0" encoding="latin1" ?> +<!DOCTYPE chapter SYSTEM "chapter.dtd"> + +<chapter> + <header> + <copyright> + <year>2004</year><year>2009</year> + <holder>Ericsson AB. All Rights Reserved.</holder> + </copyright> + <legalnotice> + The contents of this file are subject to the Erlang Public License, + Version 1.1, (the "License"); you may not use this file except in + compliance with the License. You should have received a copy of the + Erlang Public License along with this software. If not, it can be + retrieved online at http://www.erlang.org/. + + Software distributed under the License is distributed on an "AS IS" + basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See + the License for the specific language governing rights and limitations + under the License. + + </legalnotice> + + <title>Xmerl Release Notes</title> + <prepared>otp_appnotes</prepared> + <docno>nil</docno> + <date>nil</date> + <rev>nil</rev> + <file>notes.xml</file> + </header> + <p>This document describes the changes made to the Xmerl application.</p> + + + + +<section><title>Xmerl 1.2.3</title> + + <section><title>Fixed Bugs and Malfunctions</title> + <list> + <item> + <p> + A continuation clause of <c>parse_reference/3</c> had + it's parameters in wrong order.</p> + <p> + Own Id: OTP-8251 Aux Id: seq11429 </p> + </item> + </list> + </section> + + + <section><title>Improvements and New Features</title> + <list> + <item> + <p> + A new option to turn off the parsing of an external DTD + is added to <c>xmerl_sax_parser:file/2</c> and + <c>xmerl_sax_parser:stream/2</c> + (<c>skip_external_dtd</c>).</p> + <p> + Own Id: OTP-8252 Aux Id: seq11432 </p> + </item> + <item> + <p> + The documentation is now built with open source tools + (xsltproc and fop) that exists on most platforms. One + visible change is that the frames are removed.</p> + <p> + Own Id: OTP-8253</p> + </item> + </list> + </section> + +</section> + +<section><title>Xmerl 1.2.2</title> + + <section><title>Fixed Bugs and Malfunctions</title> + <list> + <item> + <p> + <c>xmerl_sax_parse:stream/2</c> failed with + <c>{fatal_error,_, "Continuation function undefined, and + more data needed",_,_}</c> when no continuation function + was defined even though it was a complete document as + input.</p> + <p> + Own Id: OTP-8213</p> + </item> + <item> + <p> + The namespace URI supplied on unprefixed attributes in + startElement tuples is the same as the URI for the + default namespace. According to the standard the + namespace for an unprefixed attribute should always has + no value.</p> + <p> + Own Id: OTP-8214</p> + </item> + </list> + </section> + +</section> + +<section><title>Xmerl 1.2.1</title> + + <section><title>Fixed Bugs and Malfunctions</title> + <list> + <item> + <p> + <c>xmerl/include/xmerl.hrl</c> contained internal debug + macros (<c>dbg/2</c> and <c>DBG/0</c>) which now is moved + to <c>xmerl_internal.hrl</c>. + </p> + <p> + Own Id: OTP-8084 + </p> + </item> + <item> + <p> + The function <c>xmerl_uri:parse/1</c> couldn't handle FTP + URIs containing username and password. The default FTP + port constant was also wrong. (Thanks to Steve Vinoski) + </p> + <p> + Own Id: OTP-8156 + </p> + </item> + </list> + </section> + + + <section><title>Improvements and New Features</title> + <list> + <item> + <p> + The SAX parser couldn't handle consecutive documents on + the same stream. The return values are now changed so + they return a rest value instead of giving an error about + "erranous information after the end tag". + </p> + <p> + This means that + the functions <c>file/2</c> and <c>stream/2</c> now + returns <c>{ok, EventState, Rest}</c> when the parsing is + correct. The rest can then be used as input to a new call + to <c>xmerl_sax_parse:stream/2</c>. If one know that it's + just one document the rest value in the result tuple can + be matched against <c><<>></c> or <c>[]</c> + depending on if the input is in binary form or not. + </p> + <p> + Own Id: OTP-8153 Aux Id: seq11388 + </p> + </item> + </list> + </section> + +</section> + + +<section><title>Xmerl 1.2</title> + <section><title>Improvements and New Features</title> + <p> + In xmerl-1.2 we have added the first Beta version of the new + SAX parser (module: xmerl_sax_parser), it supports XML 1.0. + We call it Beta due to that the validation part is not ready yet and that the + parser still has some known limitations (mostly in the DTD area). + </p> + <p> + Known limitations: + </p> + <list type="bulleted"> + <item>the external DTD in the DOCTYPE declaration is handled but other external entities are not supported.</item> + <item>the general entity values are just checked in the structure after replacement.</item> + <item> + parsed entities are supported on markup declaration level (e.g. partly replacement of markup + declaration with PEReference is not supported). + </item> + <item>conditionalSect in external DTD's are not supported.</item> + <item>recursive loops in entity declarations are not detected.</item> + </list> + <p> + The version is increased from 1.1.12 to 1.2 is due to that the new parser + is dependent on the Unicode support that was added in OTP R13B. The old xmerl + functionality is not changed. + </p> + <p> + Own Id: OTP-6635 + </p> + </section> +</section> + +<section><title>Xmerl 1.1.12</title> + + <section><title>Improvements and New Features</title> + <list> + <item> + <p> + Updated copyright notice in source files</p> + <p> + Own Id: OTP-7847</p> + </item> + </list> + </section> + +</section> + +<section><title>Xmerl 1.1.11</title> + + <section><title>Fixed Bugs and Malfunctions</title> + <list> + <item> + <p> + An empty element with a complexType and simpleContent was + not properly validated. This error is now corrected.</p> + <p> + Own Id: OTP-7736</p> + </item> + </list> + </section> + +</section> + +<section><title>Xmerl 1.1.10</title> + + <section><title>Fixed Bugs and Malfunctions</title> + <list> + <item> + <p> + Changed the examples in Customization Functions Tutorial + to correct Erlang code. + </p> + <p> + Own Id: OTP-6053 + </p> + </item> + <item> + <p> + Some XPath errors solved, typo in compare function '!=', + error in <c>id()</c> function.</p> + <p> + Own Id: OTP-6792 Aux Id: seq10570 </p> + </item> + <item> + <p> + The XPath function <c>contains()</c> now implemented. See + XPath 1.0 section 4.2.</p> + <p> + Own Id: OTP-6873</p> + </item> + <item> + <p> + Fixed that xmerl_xsd:process_schema/2 with {xsdbase, Dirname} failed with enoent + and a number of inor documentation bugs in xmerl_xsd reference manual. + </p> + <p> + Own Id: OTP-7165 + </p> + </item> + <item> + <p> + Fixed xmerl_scan's problem with numeric character references + followed by UTF-8 characters in the contents. + </p> + <p> + Own Id: OTP-7430 + </p> + </item> + <item> + <p> + Fixed an incorrect guard for xmerl_scan:to_ucs/2. + </p> + <p> + Own Id: OTP-7473 + </p> + </item> + <item> + <p> + Some bug corrections of xmerl XPath implementation, most + provided by Matthew Dempsky.</p> + <p> + Own Id: OTP-7496</p> + </item> + <item> + <p> + Now with <c>string()</c> and <c>name()</c> all XPath + functions are implemented. The string representation of + QName by <c>name()</c> is "{Namespace URI}local-name".</p> + <p> + Own Id: OTP-7510</p> + </item> + + </list> + </section> + +</section> + + +<section><title>Xmerl 1.1.9</title> + + <section><title>Fixed Bugs and Malfunctions</title> + <list> + <item> + <p> + A number of minor scanner faults have got more clear error messages. + </p> + <p> + Own Id: OTP-5998, Aux Id: seq9803 + </p> + </item> + <item> + <p> + An example error in the Xmerl Users Guide is corrected. + </p> + <p> + Own Id: OTP-6947 + </p> + </item> + <item> + <p> + When xmerl_xsd:validate was executed the schema table in the state + was deleted and next execution would fail. This is now corrected. + </p> + <p> + Own Id: OTP-7288 + </p> + </item> + </list> + </section> + +</section> + + +<section><title>Xmerl 1.1.8</title> + + <section><title>Fixed Bugs and Malfunctions</title> + <list> + <item> + <p> + A Kleene Closure child in a sequence consumed all + following children. This problem has been fixed.</p> + <p> + Own Id: OTP-7211</p> + </item> + <item> + <p> + Now validating xhtml1-transitional.dtd. A certain + contentspec with a succeeding choice, that didn't match + all content, followed by other child elements caused a + failure. This is now corrected.</p> + <p> + Own Id: OTP-7214</p> + </item> + </list> + </section> + +</section> + +<section><title>Xmerl 1.1.7</title> + + <section><title>Improvements and New Features</title> + <list> + <item> + <p> + xmerl's schema validation now takes default facets into + account</p> + <p> + Own Id: OTP-7190</p> + </item> + </list> + </section> + +</section> + +<section><title>Xmerl 1.1.6</title> + + <section><title>Fixed Bugs and Malfunctions</title> + <list> + <item> + <p> + Parsing XML with option <c>{validation,schema}</c> is now + corrected.</p> + <p> + Own Id: OTP-6773</p> + </item> + <item> + <p> + union type is now supported</p> + <p> + Own Id: OTP-6877 Aux Id: seq10755 </p> + </item> + <item> + <p> + Now xmerl validates as expected when a sequence has a + present group member and a following element.</p> + <p> + Own Id: OTP-6910</p> + </item> + </list> + </section> + +</section> + + <section> + <title>Xmerl 1.1.5</title> + + <section> + <title>Fixed Bugs and Malfunctions</title> + <list type="bulleted"> + <item> + <p>The head of a substitutionGroup may have type anyType and + thus allow members of any type. This was an oversight, but is + now corrected.</p> + <p>Own Id: OTP-6720</p> + </item> + <item> + <p>A recursive group reference in a redefine refers to the + definition in the redefined schema. See 4.2.2 in + XMLSchema part1 "Schema Representation Constraint: + Individual Component Redefinition" bullet 2.</p> + <p>Own Id: OTP-6739</p> + </item> + <item> + <p>Solved some content model problems, for instance in some + cases failed when more than one choice.</p> + <p>Own Id: OTP-6752</p> + </item> + </list> + </section> + </section> + + <section> + <title>Xmerl 1.1.4</title> + + <section> + <title>Improvements and New Features</title> + <list type="bulleted"> + <item> + <p>An additional format is possible for the simple syntax: + <c>{Fun, State}</c>. The fun should retrieve the + replacement in simple syntax format. The semantics of + fun: <c>fun(State) -> code that creates replacement, then returns {SimpleSyntax,NewState} | done </c></p> + <p>Own Id: OTP-6679</p> + </item> + </list> + </section> + </section> + + <section> + <title>Xmerl 1.1.3</title> + + <section> + <title>Improvements and New Features</title> + <list type="bulleted"> + <item> + <p>Memory consumption decreased: moved transforming from + utf-8 to unicode from an extra pass of the document to + the occasion when a character is parsed. Removed use of + lists:subtract. Those changes also speeds up parsing in + some scenarios.</p> + <p>Own Id: OTP-6599 Aux Id: seq10552 </p> + </item> + </list> + </section> + </section> + + <section> + <title>Xmerl 1.1.2</title> + + <section> + <title>Fixed Bugs and Malfunctions</title> + <list type="bulleted"> + <item> + <p>Schema processor reprocessed schemas that already were + processed, using process_schemas on a system of schemas + with circular dependencies.</p> + <p>Own Id: OTP-6460 Aux Id: seq10564 </p> + </item> + </list> + </section> + + <section> + <title>Improvements and New Features</title> + <list type="bulleted"> + <item> + <p>Dialyzer warnings now removed, i.e. dead code have been + removed.</p> + <p>Own Id: OTP-6507</p> + </item> + </list> + </section> + </section> + + <section> + <title>Xmerl 1.1.1</title> + + <section> + <title>Fixed Bugs and Malfunctions</title> + <list type="bulleted"> + <item> + <p>Bug in xmerl removed so that simple syntax element + content is exported correctly.</p> + <p>Own Id: OTP-6402 Aux Id: OTP-6099</p> + </item> + </list> + </section> + </section> + + <section> + <title>Xmerl 1.1</title> + + <section> + <title>Fixed Bugs and Malfunctions</title> + <list type="bulleted"> + <item> + <p>Xmerl failed to parse and export with the sax_file + front-end. Therefore hook function calls were added in the + parser and handling of text content were changed.</p> + <p>Own Id: OTP-6043</p> + </item> + <item> + <p>Bug in xmerl removed so that simple syntax element + content is exported correctly.</p> + <p>Own Id: OTP-6099</p> + </item> + </list> + </section> + + <section> + <title>Improvements and New Features</title> + <list type="bulleted"> + <item> + <p>xmerl now supports XMLSchema validation. Documentation in + reference manual for xmerl. The release of XMLSchema + validation should be considered as a beta release. The + user interface may still be adjusted in a coming + release. Opinions and evaluations are welcome.</p> + <p>Own Id: OTP-6401</p> + </item> + </list> + </section> + </section> + + <section> + <title>xmerl 1.0.5</title> + + <section> + <title>Fixed Bugs and Malfunctions</title> + <list type="bulleted"> + <item> + <p>Code that caused compiler warnings has been reviewed.</p> + </item> + </list> + </section> + </section> + + <section> + <title>xmerl 1.0.4</title> + + <section> + <title>Fixed Bugs and Malfunctions</title> + <list type="bulleted"> + <item> + <p>xmerl behaved strange parsing a XML-document with a + copyright sign in a comment.</p> + <p>Own Id: OTP-5599</p> + </item> + <item> + <p>Line count for error messages in DTD improved, still + problem because of ENTITY expansions. Didn't delete + digraphs after recursion test. Now correctly parsing of + declaration separators [28a-b].</p> + <p>Own Id: OTP-5718</p> + </item> + <item> + <p>Failed to validate a XML file with a content spec that + had a choice of which one element was a sequence with + optional elements, and all elements of that sequence were + missing</p> + <p>Own Id: OTP-5734</p> + </item> + <item> + <p>Location paths for document root and attributes is now + working as expected.</p> + <p>Own Id: OTP-5895</p> + </item> + <item> + <p>Now has the last() predicate in the XPATH modules the + properties specified in ch 2.4 in the XPATH spec, i.e. if + last() evaluates to a number other than the context + position it is false, otherwise true.</p> + <p>Own Id: OTP-5902</p> + </item> + <item> + <p>The location path of a single wildcard now only selects + element nodes.</p> + <p>Own Id: OTP-5905</p> + </item> + </list> + </section> + </section> + + <section> + <title>Xmerl 1.0.3</title> + + <section> + <title>Fixed Bugs and Malfunctions</title> + <list type="bulleted"> + <item> + <p>Removed call of undefined function in xmerl_lib.</p> + <p>Own Id: OTP-5587</p> + </item> + </list> + </section> + </section> + + <section> + <title>Xmerl 1.0.2</title> + + <section> + <title>Fixed Bugs and Malfunctions</title> + <list type="bulleted"> + <item> + <p>Better identification of errors in xml code.</p> + <p>Own Id: OTP-5498 Aux Id: seq9803 </p> + </item> + <item> + <p>Some minor bugs fixed.</p> + <p>Own Id: OTP-5500</p> + </item> + <item> + <p>Parser failed on PE reference as EnumeratedType AttType, + now corrected.</p> + <p>Own Id: OTP-5531</p> + </item> + </list> + </section> + </section> + + <section> + <title>Xmerl 1.0.1</title> + + <section> + <title>Fixed Bugs and Malfunctions</title> + <list type="bulleted"> + <item> + <p>Fixed bug in xmerl_xpath. Xpath expressions that select + nodes of type text() didn't work, like "context/text()", + "child::text()", "descendant::text()".</p> + <p>Own Id: OTP-5268 Aux Id: seq9656 </p> + </item> + <item> + <p>Minor bugs fixed.</p> + <p>Own Id: OTP-5301</p> + </item> + </list> + </section> + <!-- p>There are also release notes for <url href="notes_history.html">older versions</url>.</p --> + </section> + + <section> + <title>Xmerl 1.0</title> + + <section> + <title>Improvements and New Features</title> + <list type="bulleted"> + <item> + <p>The OTP release of xmerl 1.0 is mainly the same as + xmerl-0.20 of http://sowap.sourceforge.net/. It is + capable of parsing XML 1.0. There have only been minor + improvements: Some bugs that caused an unexpected crash + when parsing bad XML. Failure report that also tells + which file that caused an error.</p> + <p>Own Id: OTP-5174</p> + </item> + </list> + </section> + </section> +</chapter> + |