[prev in list] [next in list] [prev in thread] [next in thread]
List: xerces-cvs
Subject: cvs commit: xml-xerces/java/docs dom3.xml faq-write.xml readme.xml releases.xml xni-config.xml
From: elena () apache ! org
Date: 2002-01-29 17:13:08
[Download RAW message or body]
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
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic