elena 2003/07/30 13:47:01 Modified: java/docs dom3.xml faq-dom.xml faq-general.xml readme.xml Log: Preparation for the new Xerces release: update docs Revision Changes Path 1.10 +17 -40 xml-xerces/java/docs/dom3.xml Index: dom3.xml =================================================================== RCS file: /home/cvs/xml-xerces/java/docs/dom3.xml,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- dom3.xml 26 Mar 2003 00:01:24 -0000 1.9 +++ dom3.xml 30 Jul 2003 20:47:01 -0000 1.10 @@ -11,7 +11,7 @@ The <jump href="http://www.w3.org/DOM/DOMTR#DOML3">DOM Level 3</jump> specification is at the stage of - <strong>Working Draft</strong>, which represents work in progress and thus may be + <strong>Working Draft in Last Call</strong>, which represents work in progress and thus may be updated, replaced, or obsoleted by other documents at any time. @@ -23,8 +23,8 @@ <s2 title="Introduction"> <p> The &ParserNameLong; &ParserVersion; contains an implementation of - the Document Object Model Level 3 <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-Core-20030226/">Core</jump> - and Document Object Model Level 3 <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-LS-20030226/">Load and Save</jump> Working drafts. + the Document Object Model Level 3 <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-Core-20030609/">Core</jump> + and Document Object Model Level 3 <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-LS-20030619/">Load and Save</jump> Working drafts. To learn how to program with the DOM Level 3 see <jump href="samples-dom.html#DOM3">dom.DOM3</jump> sample. </p> <p> @@ -41,42 +41,15 @@ </s2> <s2 title='Implementation of DOM Level 3 Core'> - <p>All of the DOM Level 3 Core functionality is implemented, including:</p> - - <ul> - <li> - <strong>DOMImplementationRegistry</strong> - <jump href="http://www.w3.org/TR/2002/WD-DOM-Level-3-Core-20030226/core.html#Bootstrap">Bootstrapping</jump> - -- lets an application find an implementation, based on the specific features it requires. - </li> - - <li> - <strong>DOMConfiguration</strong> - -- using configuration users can set different parameters for the Document. - </li> - <li> - <strong>Element</strong> setIdAttribute, setIdAttributeNS, setIdAttributeNode - -- allows to set an <code>ID</code> attribute for the current element. - </li> - <li> - <strong>TypeInfo</strong> - -- exposes type information in the DOM tree. - </li> - <li> - <strong>Node</strong> <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-Core-20030226/core.html#Node3-compareDocumentPosition">compareDocumentPosition</jump> - -- compares a node with this node with regard to their position in the tree and according to the document order. - - </li> - <li> - <em>DOMError</em>, <em>DOMErrorHandler</em>, <em>DOMLocator</em>, <em>UserDataHandler</em> - -- users can register error and user data handlers. - </li> - </ul> + <p>Missing functionality:</p> + <ul> + <li><strong>DOMConfiguration "infoset"</strong> parameter - value "true" is not supported. </li> + <li><strong>DOMConfiguration "well-formed"</strong> parameter - value "true" is not supported.</li> + </ul> + <p> - The - <code>parameters</code> - supported are: + The <code>parameters</code> supported are: </p> <ul> <li> @@ -88,7 +61,7 @@ <li> <strong>entity-resolver</strong> [ - <em>DOMEntityResolver</em> + <em>DOMResourceResolver</em> ] </li> <li> @@ -200,6 +173,9 @@ To access the information, cast dom.Element to org.apache.xerces.xni.psvi.ElementPSVI and dom.Attr to org.apache.xerces.xni.psvi.AttributePSVI. </li> + + + </ul> </s2> @@ -208,11 +184,12 @@ <ul> <li> - <strong>DOMBuilder</strong> <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-LS-20030226/load-save.html#LS-DOMBuilder-parseWithContext"> + <strong>DOMParser</strong> <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-LS-20030226/load-save.html#LS-DOMBuilder-parseWithContext"> parserWithContext</jump> -- not supported. </li> - <li><strong>DOMImplementationLS</strong> <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-LS-20030226/load-save.html#LS-DOMIMplementationLS-MODE_SYNC"> + <li><strong>DocumentLS, ElementLS</strong> - convenience interfaces are not supported.</li> + <li><strong>DOMImplementationLS</strong> <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-LS-20030226/load-save.html#LS-DOMIMplementationLS-MODE_SYNC"> MODE_ASYNCHRONOUS</jump> -- not supported. </li> 1.8 +1 -0 xml-xerces/java/docs/faq-dom.xml Index: faq-dom.xml =================================================================== RCS file: /home/cvs/xml-xerces/java/docs/faq-dom.xml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- faq-dom.xml 26 Mar 2003 00:01:24 -0000 1.7 +++ faq-dom.xml 30 Jul 2003 20:47:01 -0000 1.8 @@ -63,6 +63,7 @@ <a> <anchor name="dom3-run"/> <p>Use the <jump href="http://java.sun.com/j2se/1.4/docs/guide/standards/"> Endorsed Standards Override Mechanism</jump> to specify dom3-xml-apis.jar. + More complete description is available <jump href="http://xml.apache.org/xalan-j/faq.html#faq-N100CB">here</jump>. </p> </a> </faq> 1.35 +7 -0 xml-xerces/java/docs/faq-general.xml Index: faq-general.xml =================================================================== RCS file: /home/cvs/xml-xerces/java/docs/faq-general.xml,v retrieving revision 1.34 retrieving revision 1.35 diff -u -r1.34 -r1.35 --- faq-general.xml 16 Jul 2003 16:22:28 -0000 1.34 +++ faq-general.xml 30 Jul 2003 20:47:01 -0000 1.35 @@ -1,6 +1,13 @@ <?xml version='1.0' encoding='UTF-8'?> <!DOCTYPE faqs SYSTEM 'dtd/faqs.dtd'> <faqs title='General FAQs'> + <faq title="Querying Xerces Version"> + <q>How do I find out which Xerces version I am using?</q> + <a> <p>To find out the release version of Xerces, execute the following: + <code>java org.apache.xerces.impl.Version</code>. + </p> + </a> + </faq> <faq title="Bugzilla"> <q>How do I use Bugzilla to report bugs?</q> <a> <p> 1.37 +8 -8 xml-xerces/java/docs/readme.xml Index: readme.xml =================================================================== RCS file: /home/cvs/xml-xerces/java/docs/readme.xml,v retrieving revision 1.36 retrieving revision 1.37 diff -u -r1.36 -r1.37 --- readme.xml 26 Mar 2003 00:09:50 -0000 1.36 +++ readme.xml 30 Jul 2003 20:47:01 -0000 1.37 @@ -18,18 +18,17 @@ <link idref='xni'>XNI Manual</link>. </p> <p> - Xerces 2 is a <jump href='http://www.w3.org/TR/xmlschema-1/#key-fullyConforming'> + Xerces2 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='xml-schema'> XML Schema</link> page. </p> <p> - Xerces 2 also provides an experimental implementation of the Document Object Model Level 3 - Core and Load/Save Working Drafts. - For more information, refer to the <link idref='dom3'>DOM Level 3 Implementation</link> page. + Xerces2 also provides an <link idref='dom3'>experimental implementation</link> of the Document Object Model Level 3 Core and Load/Save Working Drafts and provides a <link idref='faq-xinclude'>partial implementation</link> of the XML Inclusions (XInclude) W3C Candidate Recommendation. </p> - <p>Xerces is now able to parse documents written according to the + + <p>Xerces2 is now able to parse documents written according to the <jump href="http://www.w3.org/TR/xml11/"> XML 1.1 Candidate Recommendation</jump>, except that it does not yet provide an option to enable normalization checking as described @@ -41,6 +40,7 @@ 3 load/save API's are in use. </p> + </s2> <s2 title='Features of This Release'> <p> @@ -100,12 +100,12 @@ <s2 title='Changes from Previous Release'> <p> - The &ParserNameLong; &ParserVersion; fixes bugs and changes the XNI as follows: + The &ParserNameLong; &ParserVersion; fixes bugs and adds the following functionality: </p> <ul> - <li>Added set/getNamespace methods to the xni.XMLResourceIdentifier interface.</li> - <li>Added getEncoding method to the xni.XMLLocator interface.</li> + <li>Added partial implementation for W3C XInclude specification.</li> + <li>Added implementation for exposing XML Schema annotations.</li> </ul> <p>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]