You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xerces.apache.org by el...@apache.org on 2002/01/29 18:13:08 UTC
cvs commit: xml-xerces/java/docs dom3.xml faq-write.xml readme.xml releases.xml xni-config.xml
elena 02/01/29 09:13:08
Modified: java/docs dom3.xml faq-write.xml readme.xml releases.xml
xni-config.xml
Log:
update docs
Revision Changes Path
1.3 +1 -1 xml-xerces/java/docs/dom3.xml
Index: dom3.xml
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/dom3.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- dom3.xml 28 Jan 2002 23:11:00 -0000 1.2
+++ dom3.xml 29 Jan 2002 17:13:07 -0000 1.3
@@ -7,7 +7,7 @@
Level 3. This implementation is experimental. The DOM Level 3 specification is
still in working draft stage: you should not consider this implementation complete or correct.
The limitations of this implementation are detailed below.
-Please, read this document before using dom3 package.
+Please, read this document before using org.apache.xerces.dom3 package.
</p>
</s2>
<s2 title="Introduction">
1.13 +3 -4 xml-xerces/java/docs/faq-write.xml
Index: faq-write.xml
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/faq-write.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- faq-write.xml 23 Aug 2001 00:35:14 -0000 1.12
+++ faq-write.xml 29 Jan 2002 17:13:07 -0000 1.13
@@ -152,16 +152,15 @@
</q>
<a>
<p>
- The feature
- <code>http://apache.org/xml/features/dom/create-entity-ref-nodes</code>
- controls how entities appear in the DOM tree. When this feature
+ The DOM Level 3 feature <code>create-entity-ref-nodes</code> (or corresponding Xerces <code>http://apache.org/xml/features/dom/create-entity-ref-nodes</code> feature)
+ control how entities appear in the DOM tree. When one of those features
is set to true (the default), an occurance of an entity reference
in the XML document will be represented by a subtree with an
EntityReference node at the root whose children represent the
entity expansion.
</p>
<p>
- If the property is false, an entity reference in the XML document
+ If the feature is false, an entity reference in the XML document
is represented by only the nodes that represent the entity
expansion.
</p>
1.23 +11 -5 xml-xerces/java/docs/readme.xml
Index: readme.xml
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/readme.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- readme.xml 28 Jan 2002 23:11:00 -0000 1.22
+++ readme.xml 29 Jan 2002 17:13:07 -0000 1.23
@@ -18,7 +18,7 @@
<link idref='xni'>XNI Manual</link>.
</p>
<p>
- Xerces 2 is a fully conforming XML Schema processor.
+ Xerces 2 is a <jump href='http://www.w3.org/TR/xmlschema-1/#key-fullyConforming'>fully conforming</jump> XML Schema processor.
For more information, refer to the <link idref='limitations-schema'>XML Schema Implementation</link> page.
</p>
<p>
@@ -34,6 +34,9 @@
<jump href='http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Xerces2-J'>BugZilla</jump>
to report any bugs that you find.
</p>
+ <p>You can find the latest Xerces 2 jars
+ <jump href='http://gump.covalent.net/jars/latest/xml-xerces2/'>here</jump>.
+ </p>
</s2>
<s2 title='Features of This Release'>
<p>
@@ -88,18 +91,21 @@
The &ParserNameLong; &ParserVersion; introduced some changes to the Xerces Native
Interface. The following list enumerates the important changes:
</p>
+
<ul>
- <li>The <code>Augmentations</code> interface was added to the core XNI interfaces.
+ <li>Added an interface, <code>XMLResourceIdentifier</code>, for describing the physical location of XML resources to the core XNI interfaces.
+ This interface is used in grammar caching and entity resulution.
</li>
<li>
- The <code>XMLDocumentHandler</code> interface was modified to include <code>Augmentations</code> as an extra parameter for parser events. Getter methods were added to the <code>XMLAttributes</code> to query the <code>Augmentations</code>.
+ Updated <code>XMLEntityResolver</code>, <code>XMLLocator</code>, <code>XMLDocumentHandler</code>, <code>XMLDocumentFragmentHandler</code>, and <code>XMLDTDHandler</code> to use <code>XMLResourceIdentifier</code> interface.
</li>
<li>
- The PSVI interfaces were added as an extention to the core XNI (still under development).
- </li>
+ Added <code>Augmentations</code> to <code>XMLDTDHandler</code>, <code>XMLDocumentFragmentHandler</code>, and the <code>XMLDTDContentModelHandler</code> interfaces
+ </li>
</ul>
<p>
+
For a more complete list of changes, refer to the
<link idref='releases'>Release Information</link> page.
</p>
1.104 +15 -22 xml-xerces/java/docs/releases.xml
Index: releases.xml
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/releases.xml,v
retrieving revision 1.103
retrieving revision 1.104
diff -u -r1.103 -r1.104
--- releases.xml 29 Jan 2002 16:48:03 -0000 1.103
+++ releases.xml 29 Jan 2002 17:13:07 -0000 1.104
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding='UTF-8'?>
-<!-- $Id: releases.xml,v 1.103 2002/01/29 16:48:03 neeraj Exp $ -->
+<!-- $Id: releases.xml,v 1.104 2002/01/29 17:13:07 elena Exp $ -->
<!DOCTYPE releases SYSTEM 'dtd/releases.dtd'>
<releases>
<release version='Xerces 2.0.0'>
@@ -50,7 +50,7 @@
<add>
<note>Added support for warn-on-duplicate-attdef xerces feature
- http://apache.org/xml/features/validation/warn-on-duplicate-attdef
+ validation/warn-on-duplicate-attdef
</note>
<submitter name='Neeraj Bajaj'/>
</add>
@@ -98,7 +98,7 @@
</update>
<update>
- <note>provided support for fundamental facets in DV implementation </note>
+ <note>Provided support for fundamental facets in DV implementation </note>
<submitter name='Neeraj Bajaj, Sandy Gao'/>
</update>
@@ -121,11 +121,17 @@
<fix>
<note>
- Fixed DOM L2 bug: synchronization for entity reference nodes,
- cloning of attribute node, report of event phases.
-
+ Fixed DOM L2 bugs: synchronization for entity reference nodes,
+ cloning of attribute node, report of event phases.
</note>
<submitter name="Arnaud Le Hors, Elena Litani"/>
+ </fix>
+
+ <fix>
+ <note>
+ Fixed a bug in XMLDocumentFragmentScannerImpl occuring when a ] is encountered at the end of an entity.
+ </note>
+ <submitter name="Arnaud Le Hors"/>
</fix>
@@ -143,26 +149,19 @@
<fix>
- <note>Javadoc fixes.
+ <note>Massive Javadoc fixes.
</note>
- <submitter name="Ted Leung"/>
+ <submitter name="Ted Leung, Neeraj Bajaj, Rahul Srivastava"/>
</fix>
-
<fix>
<note>Fixed external-schemaLocation and external-noNamespaceSchemalocation
- properties related bug (bug id 5768)
+ properties related bug (# 5768)
</note>
<submitter name="Gopal Sharma"/>
</fix>
-
- <fix>
- <note>XNI related Javadoc fixes.
- </note>
- <submitter name="Neeraj Bajaj, Rahul Srivastava"/>
- </fix>
<fix>
<note>Fixed namespaces and namespace-prefixes related SAX bug.
@@ -176,12 +175,6 @@
<submitter name="Rahul Srivastava"/>
</fix>
-
- <fix>
- <note>Corrected features documentation for string-interning feature.
- </note>
- <submitter name="Rahul Srivastava"/>
- </fix>
<fix>
<note>Fixed the bug in which duplicate attribute definitions were not ignored
1.6 +41 -6 xml-xerces/java/docs/xni-config.xml
Index: xni-config.xml
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/xni-config.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- xni-config.xml 2 Oct 2001 06:07:17 -0000 1.5
+++ xni-config.xml 29 Jan 2002 17:13:07 -0000 1.6
@@ -291,6 +291,7 @@
parser instance to add recognized features and properties that
the parser configuration will store.
</p>
+ <!--
<table>
<tr>
<th>
@@ -425,6 +426,7 @@
<tr><td><code>public void setLocale(java.util.Locale);</code></td></tr>
<tr><td><code>public Locale getLocale();</code></td></tr>
</table>
+ -->
</s3>
<anchor name='pull-parser-configuration'/>
<s3 title='Interface XMLPullParserConfiguration'>
@@ -463,18 +465,19 @@
<anchor name='entity-resolver'/>
<s3 title='Interface XMLEntityResolver'>
<p>
- This interface allows resolution of the external DTD subset and
- external parsed entities appearing in the document instance.
- </p>
+ This interface is used to resolve external parsed entities. The
+ application can register an object that implements this interface
+ with the parser configuration in order to intercept entities and
+ resolve them explicitly. If the registered entity resolver cannot
+ resolve the entity, it should return <code>null</code> so that the
+ parser will try to resolve the entity using a default mechanism. </p>
<table>
<tr><th>Methods</th></tr>
<tr>
<td>
<code>
public <link anchor='input-source'>XMLInputSource</link> resolveEntity(
- String publicId,
- String systemId,
- String baseSystemId
+ <link anchor='resource-identifier'>XMLResourceIdentifier</link> resourceIdentifier
) throws java.io.IOException, <link anchor='parse-exception'>XMLParseException</link>;
</code>
</td>
@@ -483,6 +486,11 @@
</s3>
<anchor name='error-handler'/>
<s3 title='Interface XMLErrorHandler'>
+ <p>
+ An interface for handling errors. If the application is interested
+ in error notifications, then it can register an error handler object
+ that implements this interface with the parser configuration.
+ </p>
<table>
<tr><th>Methods</th></tr>
<tr>
@@ -522,6 +530,14 @@
</s3>
<anchor name='input-source'/>
<s3 title='Class XMLInputSource'>
+ <p>
+ This class represents an input source for an XML document. The
+ basic properties of an input source are the following:
+ public identifier,
+ system identifier,
+ byte stream or character stream.
+ </p>
+ <!--
<table>
<tr><th>Constructors</th></tr>
<tr>
@@ -575,9 +591,27 @@
<tr><td><code>public void setEncoding(String encoding);</code></td></tr>
<tr><td><code>public String getEncoding();</code></td></tr>
</table>
+ -->
</s3>
+
+ <anchor name='resource-identifier'/>
+ <s3 title='Class XMLResourceIdentifier'>
+ <p>
+ This represents the basic physical description of the location of any
+ XML resource (a Schema grammar, a DTD, a general entity etc.)
+ </p>
+ </s3>
+
+
<anchor name='parse-exception'/>
<s3 title='Class XMLParseException'>
+ <p>
+
+ A parsing exception. This exception is different from the standard
+ XNI exception in that it stores the location in the document (or
+ its entities) where the exception occurred.
+ </p>
+ <!--
<table>
<tr>
<th>
@@ -613,6 +647,7 @@
<tr><td><code>public int getLineNumber();</code></td></tr>
<tr><td><code>public int getColumnNumber();</code></td></tr>
</table>
+ -->
</s3>
</s2>
<anchor name='pipelines'/>
---------------------------------------------------------------------
To unsubscribe, e-mail: xerces-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xerces-cvs-help@xml.apache.org