ilene       2003/02/03 11:44:29

  Modified:    java/xdocs/sources/xalan resources.xml faq.xml
  Log:
  Updates to the FAQ for bugzilla#15586 and #14856
  
  Revision  Changes    Path
  1.30      +2 -2      xml-xalan/java/xdocs/sources/xalan/resources.xml
  
  Index: resources.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/resources.xml,v
  retrieving revision 1.29
  retrieving revision 1.30
  diff -u -r1.29 -r1.30
  --- resources.xml     31 Oct 2002 15:06:43 -0000      1.29
  +++ resources.xml     3 Feb 2003 19:44:29 -0000       1.30
  @@ -105,8 +105,8 @@
               title="Java API for XML Parsing 1.0" 
               location="http://java.sun.com/xml/docs/api/index.html"/>
     <resource id="jaxp11" 
  -            title="Java API for XML Processing 1.1 Public Review 2" 
  -            
location="http://java.sun.com/aboutJava/communityprocess/review/jsr063/jaxp-pd2.pdf"/>
  +            title="Java API for XML Processing 1.1" 
  +            location="http://java.sun.com/xml/jaxp/dist/1.1/jaxp-1_1-spec.pdf"/>
     <resource id="jsr063"
               title="Java Specification Request 63"
               
location="http://java.sun.com/aboutJava/communityprocess/review/jsr063"/>
  
  
  
  1.27      +30 -2     xml-xalan/java/xdocs/sources/xalan/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/faq.xml,v
  retrieving revision 1.26
  retrieving revision 1.27
  diff -u -r1.26 -r1.27
  --- faq.xml   27 Jan 2003 18:45:36 -0000      1.26
  +++ faq.xml   3 Feb 2003 19:44:29 -0000       1.27
  @@ -82,6 +82,7 @@
       <faq title='TrAX and JAXP'>
         <q>What are TrAX and JAXP, and are they related?</q>
         <a>
  +             <p><anchor name="trax"/></p>
           <p>TrAX is the Transformation API for XML. In November 2000, TrAX was 
revised and incorporated into JAXP, the JAVA API for XML
       Processing. JAXP (including TrAX) provides users a standard, vendor-neutral API 
for working with (and transforming) XML documents. 
       You can use this API to build applications that are not bound to the particular 
implementation details of a given XML parser or XSL
  @@ -146,12 +147,13 @@
         <q>How do I run applications that use the Xalan-Java version 1 API with 
Xalan-Java 2</q>
         <a>
           <p>The Xalan-Java 1 compatibility API has been deprecated and now purged, 
so you must use the Xalan-Java 2 API. We strongly encourage you to
  -   use the JAVAX 1.1/TrAX API. For more information ,see the next FAQ.</p>
  +   use the JAVAX 1.1/TrAX API. For more information ,see the FAQ on <link 
anchor='trax'>TrAX and JAXP.</link></p>
         </a>
       </faq>
       <faq title='Issues running Xalan-Java on JDK 1.3'>
         <q>I'm having a problem building or running Xalan-Java on the JDK 1.3.</q>
         <a>
  +        <p><anchor name='jdk13'/></p>
           <p>The JDK 1.3 automatically places everything in the lib/ext directory in 
front of everything you place on the classpath. If this directory contains a version 
of DOM, JAXP, or Xerces that predates the Xalan-Java distribution you are using, you 
may have problems!</p>
           <p>The IBM JDK 1.3 includes an earlier version of xerces.jar in the lib/ext 
directory, a version that does not implement the JAXP 1.1 interfaces and therefore 
does not work with the current Xalan-Java release. Accordingly, you must either purge 
the xerces.jar that is in that directory or replace it with the xercesImpl.jar that is 
included with the Xalan-Java distribution.</p>
           <p>The SUN JDK 1.3 includes a pre-1.1 version of the JAXP in crimson.jar. 
Either purge the crimson.jar in that directory or overwrite it with a newer 
crimson.jar that includes and implements the JAXP 1.1 interfaces.</p>
  @@ -160,6 +162,7 @@
       <faq title='Issues running Xalan-Java on JDK 1.4'>
         <q>I'm having a problem running Xalan-Java on the JDK 1.4.</q>
         <a>
  +        <p><anchor name='jdk14'/></p>      
           <p>The Sun JDK 1.4 is packaged with an old version (2.2D11) of Xalan-Java. 
The JDK 1.4 will attempt to use this version instead of any on the classpath. 
Unfortunately, this causes problems when attempting to use a newer version of 
Xalan-Java with the Sun JDK 1.4.</p>
           <p>You can always determine which version of Xalan-Java you are running by 
using the
             <link anchor='environmentcheck'>EnvironmentCheck</link> class or by using 
the xalan:checkEnvironment extension function. It is highly recommended that you use 
this method to verify the version of Xalan-Java you are running, especially before 
opening a bug report.
  @@ -205,6 +208,7 @@
           the pgp.com site. Once you have a version of PGP installed, you
           should be able to 'verify the signature' of the .sig file, which basically 
verifies that the corresponding 
           .zip or tar.gz file has not been changed since we signed it.</p>
  +        <p>The PGP key can be found in <jump 
href='http://cvs.apache.org/viewcvs.cgi/xml-xalan/java/KEYS'>CVS.</jump></p>
         </a>
       </faq>
     </group>
  @@ -271,6 +275,21 @@
           </ul>
         </a>
       </faq>
  +    <faq title="JAXP factory lookup procedure">
  +      <q>What is the JAXP factory lookup procedure and does it affect 
performance?</q>
  +      <a>
  +      <p>JAXP uses an ordered lookup procedure to find factory implementations, 
such as
  +         an implementation of javax.xml.transform.TransformerFactory.  For 
information
  +         on this procedure, refer to Section 3 Plugability in <resource-ref 
idref='jaxp11'/>.  
  +       </p>
  +       <p>In most cases, Factory classes need only be looked up once for an 
application, so
  +          performance is not an issue.  However, there may be scenarios where the 
lookup
  +          procedure executes multiple times which could impact performance.  In 
these cases,
  +          users may want to set system properties or populate the jaxp.properties 
file in order
  +          to shorten the time spent in the lookup procedure.
  +       </p>   
  +      </a>
  +    </faq>
     </group>
     <group title='Namespace Related'>
       <faq title='Retrieving nodes in the default namespace'>
  @@ -460,6 +479,16 @@
           <p>For a slightly more detailed example, see 
org.apache.xml.utils.SystemIDResolver.</p>
         </a>
       </faq>
  +    <faq title="No more DTM IDs are available">
  +       <q>What does: "XSLT Error (javax.xml.transform.TransformerException): 
org.apache.xml.dtm.DTMException: No more DTM IDs are available" mean?</q>
  +       <a>
  +         <p>It means you are probably using a very old version of Xalan, likely the 
version 2.2D11 which
  +            was packaged in JDK1.4.  Architectural changes made in early 2002 
should have eliminated this issue
  +            for almost all cases.</p>
  +         <p>You should verify the version of Xalan you are using by running the 
<link anchor='environmentcheck'>EnvironmentCheck</link> utility, 
  +            and read the FAQ about <link anchor='jdk14'>Issues running Xalan-Java 
on JDK 1.4</link>.</p>
  +        </a>        
  +    </faq>
     </group>
     <group title='Miscellaneous'>
       <faq title='Chaining transformations'>
  @@ -478,7 +507,6 @@
           <p>For the details and links to examples, see
             <link anchor='outasin' idref='usagepatterns'>Using transformation output 
as input for 
       another transformation</link>.
  -          <anchor name='jdk13' />
           </p>
         </a>
       </faq>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to