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 2003/07/30 22:47:01 UTC

cvs commit: xml-xerces/java/docs dom3.xml faq-dom.xml faq-general.xml readme.xml

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: xerces-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xerces-cvs-help@xml.apache.org