You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xerces.apache.org by ne...@apache.org on 2001/01/31 22:26:50 UTC
cvs commit: xml-xerces/java/docs/dtd entities.ent
neilg 01/01/31 13:26:50
Modified: java/docs releases.xml schema.xml
java/docs/dtd entities.ent
Log:
documentation changes for Xerces 1.3.0
Revision Changes Path
1.41 +20 -9 xml-xerces/java/docs/releases.xml
Index: releases.xml
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/releases.xml,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- releases.xml 2001/01/25 07:58:45 1.40
+++ releases.xml 2001/01/31 21:26:47 1.41
@@ -2,8 +2,16 @@
<!DOCTYPE s1 SYSTEM "./dtd/document.dtd">
<s1 title="Releases">
- <s2 title='TBD'>
+ <s2 title='January 31, 2001 (version 1.3.0)'>
<ul>
+ <li>Upgraded schema support to the schema CR drafts at a
+ similar level to that which had existed for the WD schema
+ specifications.[elena, lmartin, neilg]</li>
+ <li>Implemented schema union simple type
+ definition.[elena]</li>
+ <li>Implemented many attribute and element declaration
+ schema-validation constraints, as well as
+ use=prohibited.[neilg]</li>
<li>Implemented basic support for XML Schema identity constraints [andyc]</li>
<li>Fixed bug in Deferred DOM with multiple IDs on same element [andyc]</li>
<li>Updates to improve DFA build-time performance. [ATOZAWA@jp.ibm.com]</li>
@@ -12,13 +20,16 @@
<li>Optimized DOM normalize operation. [Jay Cain + Arnaud Le Hors]</li>
</ul>
</s2>
- <s2 title='December 06, 2000'>
+ <s2 title='December 06, 2000 (version 1.2.3)'>
<ul>
<li>Fixed Memory leak bug was reported by Tosiki IGA where parser runs out of memory [ericye]</li>
<li>Rampant object creation even when not validating fix patch send by Elena Litani[Elena Litani]</li>
<li>ListDatatypeValidator enumeration bug fix by Elena Litani[Elena Litani]</li>
<li>Optimization in validator to only instantiate objects needed in the case of DTD vs. Schemas[jeffreyr]</li>
<li>Fixed misc. Schema Structures miscelaneous bugs since last release [ericye]</li>
+ <li>improved implementation of <all> schema construct
+ to handle 8 elements instead of 6; also increased
+ validation speed [Neil Graham, ericye]</li>
<li>Fixed DOM misc. bugs and other patches since last release [lehors]</li>
<li>Miscelaneous DOM patches by Lynn Monson [Lynn Monson]</li>
<li>Added new 'load-external-dtd' feature, so that when non
@@ -26,7 +37,7 @@
all [Arnaud Le Hors]</li>
</ul>
</s2>
- <s2 title='November 22, 2000'>
+ <s2 title='November 22, 2000 (version 1.2.2)'>
<ul>
<li>DOM 2 Recommendation release support update[lehors]</li>
<li>Fixed FAQ section submitted by Tony Montgomery Smith[jeffreyr,Tony Montgomery]</li>
@@ -40,7 +51,7 @@
</ul>
</s2>
- <s2 title='October 19, 2000'>
+ <s2 title='October 19, 2000 (version 1.2.1)'>
<ul>
<li>This is a bug fix release</li>
<li>Added Mark Swinkels datatype list refactoring [mark swinkels, jeffreyr]</li>
@@ -51,7 +62,7 @@
</ul>
</s2>
- <s2 title='August 28, 2000'>
+ <s2 title='August 28, 2000 (version 1.2.0)'>
<ul>
<li>Merged redundant Attribute validators inner classes with the data type validators. [jeffreyr]</li>
<li>Fixed namespaces bugs for endElement method in SAX. [jeffreyr]</li>
@@ -64,7 +75,7 @@
<li>Fixed misc. Schema Structures bugs. [ericye]</li>
</ul>
</s2>
- <s2 title='July 26, 2000'>
+ <s2 title='July 26, 2000 (version 1.1.3)'>
<ul>
<li>Added "anyAttribute" support for Schema. [ericye]</li>
<li>Added "xsi:type" support for Schema. [ericye]</li>
@@ -87,7 +98,7 @@
<li>Fixed bug reported by Michael Brundage in StringReader. [jeffreyr]</li>
</ul>
</s2>
- <s2 title='June 21, 2000'>
+ <s2 title='June 21, 2000 (version 1.1.2)'>
<ul>
<li>Added "any" element content support for Schema [andyc]</li>
<li>Fixed adjacent text nodes bug in deferred DOM [andyc]</li>
@@ -110,7 +121,7 @@
<li>Fixed lots of Schema bugs [ericye]</li>
</ul>
</s2>
- <s2 title='June 5, 2000'>
+ <s2 title='June 5, 2000 (version 1.1.1)'>
<ul>
<li>Added Schema include/import [ericye]</li>
<li>Performance tuning [ericye, andyc]</li>
@@ -126,7 +137,7 @@
<li>Fixed a bug in cloning default attribute</li>
</ul>
</s2>
- <s2 title='May 19, 2000'>
+ <s2 title='May 19, 2000 (version 1.1.0)'>
<ul>
<li>Reworked internals for XML Schema support [andyc, ericye,
jeffreyr]</li>
1.12 +45 -19 xml-xerces/java/docs/schema.xml
Index: schema.xml
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/schema.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- schema.xml 2000/07/21 03:42:43 1.11
+++ schema.xml 2001/01/31 21:26:47 1.12
@@ -5,15 +5,17 @@
<p>This package contains an implementation of the W3C XML
Schema language. This implementation is experimental. The
<jump href="http://www.w3.org/XML/Group/Schemas.html">XML Schema</jump>
- language is still in working draft stage: you
- should not consider this implementation complete or correct.
+ language is in candidate recommendation stage: it is still
+ possible that some changes in the specification could
+ occur. You should also not necessarily
+ consider this implementation complete or correct.
The limitations of this implementation are detailed below.
Please read this document before using this package.</p>
</s2>
<s2 title="Introduction">
<p>This package contains an implementation of a subset of the
- W3C XML Schema Language as specified in the 7 April 2000
- Working Drafts for <jump
+ W3C XML Schema Language as specified in the 24 October 2000
+ Candidate Recommendations for <jump
href="http://www.w3.org/TR/xmlschema-1/">Structures</jump> and
<jump
href="http://www.w3.org/TR/xmlschema-2/">Datatypes</jump>. The
@@ -26,14 +28,14 @@
design and on representing an XML document's grammar
as part of the document's DOM tree. We intend to update
this package until it implements all of the functionality
- of the then current XML Schema Working Draft. If you are
+ of the then current XML Schema Draft. If you are
interested in a particular unimplemented feature, we welcome
your feedback on the &javaparsername; mailing list.</p>
</s2>
<s2 title="Limitations">
<p>The XML Schema implementation in this package is a
- subset of the features defined in the 7 April 2000
- XML Schema Working Drafts.</p>
+ subset of the features defined in the 24 October 2000
+ XML Schema Candidate Recommendations.</p>
</s2>
<s2 title='Components Supported'>
<ul>
@@ -46,13 +48,16 @@
<li>Complex type definitions</li>
<li>Wildcards: any</li>
<li>Wildcards: anyAttribute</li>
+ <li>import and include</li>
+ <li>Identity constraints: unique, key, keyref
+ (experimental)</li>
</ul>
</s2>
<s2 title='Components NOT Supported'>
<ul>
- <li>Identity constraints: unique, key, keyref</li>
<li>Notation declaration</li>
<li>Annotation (ignored)</li>
+ <li>Redefine</li>
</ul>
</s2>
<s2 title='Features Supported'>
@@ -62,9 +67,9 @@
<li>Nested element declaration</li>
<li>Separate symbol spaces for elements, types, groups, and
attribute groups</li>
- <li>Equivalency classes</li>
+ <li>Substitution Groups</li>
<li>Target namespace</li>
- <li>"xsi:schemaLocation" and "xsl:noNamespacesSchemaLocation"</li>
+ <li>"xsi:schemaLocation" and "xsi:noNamespaceSchemaLocation"</li>
<li>Include</li>
<li>Import</li>
<li>"xsi:type"</li>
@@ -72,19 +77,22 @@
</s2>
<s2 title='Features NOT Supported'>
<ul>
- <li>Constraints in Chapter 5</li>
+ <li>Constraints in Chapter 5 and elsewhere in the
+ specifications</li>
<li>Nullable</li>
- <li>Block</li>
- <li>Abstract</li>
+ <li>Block and final</li>
+ <li>Abstract for both types and elements</li>
+ <li>Fixed and default values of elements</li>
+ <li>Attribute normalization</li>
</ul>
</s2>
<s2 title='Datatypes Supported'>
<ul>
<li>Built-in simple types (primitive, derived)</li>
- <li>Simple type derivation (restriction, list)</li>
+ <li>Simple type derivation (restriction, list, union)</li>
<li>Regular expressions</li>
<li>Binary (base64, hex)</li>
- <li>Constraining facets</li>
+ <li>Constraining facets (except for whiteSpace)</li>
</ul>
</s2>
<s2 title='Datatypes NOT Supported'>
@@ -97,8 +105,26 @@
xsi:noNamespaceSchemaLocation attribute on the root
element of the document. The xsi prefix must be bound to the
Schema document instance namespace, as specified by the
- working draft specification. See the sample provided in the
+ candidate recommendation specification. See the sample provided in the
Usage section.</p>
+ <p>We also emphasize that support for schema ID constraints is
+ highly experimental. Some of the limitations of this support
+ are:
+ <ul>
+ <li>Very little error-checking has been performed.</li>
+ <li>Identity constraints will not work if the schema under
+ consideration has a targetNamespace.</li>
+ <li>The XPath expressions used for specifying selectors and
+ fields are
+ a subset of XPath. Currently, only the self, child, and
+ attribute axes are supported.</li>
+ <li>Field values are currently compared in the lexical space.
+ Therefore, the values "1" and "1.0" are NOT equal for a
+ field of type "decimal" (even though they should be).</li>
+ </ul>
+ </p>
+ <p>Finally, note that in all model groups fewer than 8 elements must
+ be used.</p>
</s2>
<s2 title="Usage">
<p>In this release, schema validation has been integrated with the
@@ -108,16 +134,16 @@
grammar using an xsi:schemaLocation attribute attached to the root / top-level element
in the document. Here is an example with no target namspace: </p>
<source><document
- xmlns:xsi='http://www.w3.org/1999/XMLSchema-instance'
+ xmlns:xsi='http://www.w3.org/2000/10/XMLSchema-instance'
xsi:noNamespaceSchemaLocation='document.xsd'>
...
</document></source>
<p>Here is an example with a target namespace. Note that it is an
error to specify a different namespace than the target namespace
- defined in Schema.</p>
+ defined in the Schema.</p>
<source><document
xmlns='NS'
- xmlns:xsi='http://www.w3.org/1999/XMLSchema-instance'
+ xmlns:xsi='http://www.w3.org/2000/10/XMLSchema-instance'
xsi:schemaLocation='NS document.xsd'>
...
</document></source>
1.9 +2 -2 xml-xerces/java/docs/dtd/entities.ent
Index: entities.ent
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/dtd/entities.ent,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- entities.ent 2000/12/06 00:01:33 1.8
+++ entities.ent 2001/01/31 21:26:49 1.9
@@ -2,6 +2,6 @@
<!ENTITY javaparsernamelong "Xerces Java Parser">
<!ENTITY javaparsername "Xerces-J">
-<!ENTITY javaparserversion "1.2.3">
-<!ENTITY javaparserdirectory "xerces-1_2_3">
+<!ENTITY javaparserversion "1.3.0">
+<!ENTITY javaparserdirectory "xerces-1_3_0">
<!ENTITY javaparserdistname "Xerces-J-bin"> <!-- name of binaries -->