You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xerces.apache.org by mr...@apache.org on 2010/05/31 22:39:50 UTC

svn commit: r949857 - /xerces/java/trunk/docs/faq-xs.xml

Author: mrglavas
Date: Mon May 31 20:39:50 2010
New Revision: 949857

URL: http://svn.apache.org/viewvc?rev=949857&view=rev
Log:
Some wording improvements to the new XML Schema 1.1 / XPath 2.0 FAQ.

Modified:
    xerces/java/trunk/docs/faq-xs.xml

Modified: xerces/java/trunk/docs/faq-xs.xml
URL: http://svn.apache.org/viewvc/xerces/java/trunk/docs/faq-xs.xml?rev=949857&r1=949856&r2=949857&view=diff
==============================================================================
--- xerces/java/trunk/docs/faq-xs.xml (original)
+++ xerces/java/trunk/docs/faq-xs.xml Mon May 31 20:39:50 2010
@@ -63,35 +63,35 @@ v.validate(new StreamSource(args[0]));
     </a>
   </faq>
   <faq title="XPath 2.0 support for XML Schema 1.1 validation">
-  	<q>How Xerces-J uses an XPath 2.0 engine, for XML Schema 1.1 assertions and type-alternatives?</q>
+  	<q>How Xerces-J uses an XPath 2.0 engine for XML Schema 1.1 assertions and type alternatives?</q>
   	<a>
-  	   <p>XML Schema 1.1 'assertions' and 'type-alternatives' requires an <jump href="http://www.w3.org/TR/xpath20/">XPath 2.0</jump> 
+  	   <p>XML Schema 1.1 'assertions' and 'type alternatives' require an <jump href="http://www.w3.org/TR/xpath20/">XPath 2.0</jump> 
   	   processor for evaluation. 
-  	   For XSD 1.1 assertions, a full XPath 2.0 support is mandatory to use. For XSD 1.1 type-alternatives, 
-  	   XML schema engines can provide full XPath 2.0 support or, can implement a smaller XPath 2.0 subset, as
+  	   For XSD 1.1 assertions, full XPath 2.0 support is required. For XSD 1.1 type alternatives, 
+  	   XML schema engines can provide full XPath 2.0 support or they can implement a smaller XPath 2.0 subset, as
   	   defined by the XSD 1.1 language.
-  	   For type-alternatives implementation, Xerces first attempts to compile the XPath expression with a 
+  	   Within the type alternatives implementation, Xerces-J first attempts to compile the XPath expression with a 
   	   native Xerces "XPath subset" parser.
-  	   If parsing with the native Xerces "XPath subset" parser fails, Xerces transparently switches to full XPath 2.0 parsing 
-  	   and evaluation. Using the native Xerces "XPath subset" parsing for type-alternatives is likely to be efficient, than full XPath 2.0 
-  	   evaluation, in many cases.  	   
-  	   For full XPath 2.0 evaluation (for XSD 1.1 'assertions', and optionally for 'type-alternatives'), 
-  	   Xerces uses the <jump href="http://wiki.eclipse.org/PsychoPathXPathProcessor">Eclipse/PsychoPath XPath 2.0 engine</jump>.
+  	   If parsing with the native Xerces "XPath subset" parser fails, Xerces-J transparently switches over to another processor which 
+  	   supports all of XPath 2.0. The native processor in Xerces-J was written for efficiency, so you will likely get better
+  	   performance if your XPath expressions fall within the minimum subset defined by the XML Schema 1.1 specification.
+  	   For full XPath 2.0 evaluation (for XSD 1.1 'assertions', and optionally for 'type alternatives'), 
+  	   Xerces-J uses the <jump href="http://wiki.eclipse.org/PsychoPathXPathProcessor">Eclipse/PsychoPath XPath 2.0 engine</jump>.
   	   </p>
   	   <p>
-  	   Xerces-J bundles a JDK 1.4 compliant PsychoPath XPath 2.0 JAR. Users must be aware that, the PsychoPath XPath 2.0 JAR that's bundled 
-  	   with Apache Xerces-J, has somewhat less XPath 2.0 language compliance for W3C XPath 2.0 language. For a better XPath 2.0 build, for using 
-  	   with Xerces XML Schema 1.1 processing, users may choose to download the latest PsychoPath XPath 2.0 JAR from following locations:
+  	   Xerces-J bundles a PsychoPath XPath 2.0 jar (which requires JDK 1.4 or later). Users should be aware that more recent releases of PsychoPath
+  	   have better conformance to the W3C XPath 2.0 language than the PsychoPath XPath 2.0 jar that's bundled with Apache Xerces-J. Builds of the 
+  	   PsychoPath XPath 2.0 jar are available for download from the following locations:
   	   </p>
   	   <ul>
   	     <li><jump href="http://www.eclipse.org/webtools/">Eclipse Web Tools Platform (WTP) Project</jump>. The latest 'Released' or a 'Stable milestone' 
-  	     WTP version could be downloaded from here (from which PsychoPath XPath 2.0 JAR could be extracted).
+  	     WTP version can be downloaded from here (from which the PsychoPath XPath 2.0 jar can be extracted).
   	     </li>
   	     <li><jump href="https://build.eclipse.org/hudson/view/WTP/job/cbi-wtp-wst.xsl.psychopath/">Eclipse/PsychoPath continuous build server</jump>. 
-  	     The most latest successful PsychoPath XPath 2.0 developer build could be downloaded from here.</li>
+  	     The most recent PsychoPath XPath 2.0 developer build can be downloaded from here.</li>
   	   </ul>
   	   <p>
-  	   The latest PsychoPath XPath 2.0 engine builds at Eclipse, require a minimum JDK level of 1.5.
+  	   The latest PsychoPath XPath 2.0 engine builds at Eclipse require a minimum JDK level of 1.5.
   	   </p>
   	</a>
   </faq>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xerces.apache.org
For additional commands, e-mail: commits-help@xerces.apache.org