aboutsummaryrefslogtreecommitdiffstats
path: root/lib/xmerl/doc/src/notes.xml
diff options
context:
space:
mode:
Diffstat (limited to 'lib/xmerl/doc/src/notes.xml')
-rw-r--r--lib/xmerl/doc/src/notes.xml680
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>&lt;&lt;&gt;&gt;</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>
+