You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by dl...@locus.apache.org on 2000/03/17 13:46:47 UTC
cvs commit: xml-xalan/xdocs/sources/xalan BUGS DONE STATUS faq.xml getstarted.xml readme.xml resources.xml
dleslie 00/03/17 04:46:46
Modified: xdocs/sources/xalan Tag: Bxalan_1_0_0 BUGS DONE STATUS
faq.xml getstarted.xml readme.xml resources.xml
Log:
Updated bugs ref for readme.xml and updated xerces version reference.
Added faq on thread safety.
Revision Changes Path
No revision
No revision
1.2.2.2 +3 -5 xml-xalan/xdocs/sources/xalan/BUGS
Index: BUGS
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/BUGS,v
retrieving revision 1.2.2.1
retrieving revision 1.2.2.2
diff -u -r1.2.2.1 -r1.2.2.2
--- BUGS 2000/03/16 18:50:07 1.2.2.1
+++ BUGS 2000/03/17 12:46:45 1.2.2.2
@@ -1,6 +1,4 @@
-<s3 title="Known bugs in the current Xalan version">
- <p>We are aware of the following bugs in version 1.0.0:</p>
- <ul>
- <li></li>
- </ul>
+<s3 title="Outstanding bugs">
+ <p>Outstanding bugs are recorded in the Apache XML<jump href="http://xml.apache.org/bugs/">Bug Tracking System</jump>.
+ If you find a bug, please use this system to report it.</p>
</s3>
1.4.2.2 +1 -1 xml-xalan/xdocs/sources/xalan/DONE
Index: DONE
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/DONE,v
retrieving revision 1.4.2.1
retrieving revision 1.4.2.2
diff -u -r1.4.2.1 -r1.4.2.2
--- DONE 2000/03/16 18:50:07 1.4.2.1
+++ DONE 2000/03/17 12:46:45 1.4.2.2
@@ -1,5 +1,5 @@
<s3 title="Work done since the last Xalan version">
- <p>Since Gold Candidate release 0.20.0, we have concentrated all our efforts on fixing critical bugs and upgrading the documentation.</p>
+ <p></p>
</s3>
<s3 title="Bugs Pended since the last Xalan version">
<p>The following bugs have been pended (we think they're fixed but haven't tested the fixes):</p>
1.3.2.3 +1 -1 xml-xalan/xdocs/sources/xalan/STATUS
Index: STATUS
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/STATUS,v
retrieving revision 1.3.2.2
retrieving revision 1.3.2.3
diff -u -r1.3.2.2 -r1.3.2.3
--- STATUS 2000/03/16 21:25:31 1.3.2.2
+++ STATUS 2000/03/17 12:46:45 1.3.2.3
@@ -1,7 +1,7 @@
<s3 title="Version of Xerces to use">
<p>Xalan-J version 1.0.0 has been tested with Xerces-j version 1.0.3. &download; For information about including xerces.jar on the system class path, see <link idref="getstarted" anchor="classpath">Setting up the system class path</link>.</p>
<p><em>Important</em> You may experience unpredictable anomalies if your Xalan and Xerces builds are not in synch. If you download an update to Xalan, check the release notes to determine which version of Xerces you should use.</p>
-<note>You can use Xalan with other XML parsers, but it is up to you to implement liaisons to those parsers. Your liaison class should extend <resource-ref idref="XMLParserLiaisonDefaultDoc"/> and implement <resource-ref idref="XPathSupportDoc"/>.</note>
+<note>You can use Xalan with other XML parsers, but it is up to you to implement liaisons to those parsers. Your liaison class should extend <resource-ref idref="XMLParserLiaisonDefaultDoc"/> and implement <resource-ref idref="XMLParserLiaisonDoc"/>.</note>
</s3>
<s3 title="To-do tasks for future Xalan releases">
<p>A top priority for the &xslt4j; team in the ongoing development of &xslt4j; is to improve performance. This includes
1.6.2.2 +18 -4 xml-xalan/xdocs/sources/xalan/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/faq.xml,v
retrieving revision 1.6.2.1
retrieving revision 1.6.2.2
diff -u -r1.6.2.1 -r1.6.2.2
--- faq.xml 2000/03/16 18:50:10 1.6.2.1
+++ faq.xml 2000/03/17 12:46:46 1.6.2.2
@@ -1,4 +1,4 @@
-<?xml version="1.0" standalone="no"?>
+<?xml version="1.0" standalone="no"?>
<!DOCTYPE faqs SYSTEM "sbk:/style/dtd/faqs.dtd">
<faqs title="Frequently asked questions">
@@ -35,6 +35,20 @@
SAX events</link></p>.</a>
</faq>
+ <faq title="Are the XSLTProcessor and StylesheetRoot (compiled stylesheet) objects thread-safe?">
+
+ <q>Are the XSLTProcessor and StylesheetRoot (compiled stylesheet) objects thread-safe?</q>
+
+ <a>
+ <p>The XSLTProcessor stores running state information, so it is not thread-safe. If you want to use the XSLTProcessor
+ to perform multiple transformations, create a new instance for each transformations or synchronize. If you want to
+ perform multiple serial transformations with a single XSLTProcessor object, call the XSLTProcessor reset() method between each
+ transformation.</p>
+ <p>StylesheetRoot objects, on the other hand, are thread-safe. A single StylesheetRoot object may be called concurrently
+ from multiple threads.</p>
+ <p>For more information, see the next question.</p></a>
+ </faq>
+
<faq title="Why do XSLTProcessor and StylesheetRoot both have process() methods to perform transformations?">
<q>Why do XSLTProcessor and StylesheetRoot both have process() methods to perform transformations?</q>
@@ -79,7 +93,8 @@
...</source>
</a>
</faq>
-
+
+
<faq title="What can I do to speed up transformations?">
<q>What can I do to speed up transformations?</q>
@@ -91,8 +106,7 @@
and DOM and DOM2 do not include the interfaces required for optimal performance without the use of side
tables.<br/><br/></li>
<li>Set the XSLTProcessor to function as a SAX DocumentHandler, and respond to SAX events rather than waiting for
- the entire transformation to be completed. The use of SAX allows incremental transformation and allows the XSLT
- processor to create its own optimal tree (in place of a DOM).<br/><br/></li>
+ the entire transformation to be completed.<br/><br/></li>
<li>Use compiled stylesheets for multiple transformations.<br/><br/></li>
<li>Set up your stylesheets to function efficiently.<br/><br/></li>
<ul>
1.6.2.4 +1 -3 xml-xalan/xdocs/sources/xalan/getstarted.xml
Index: getstarted.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/getstarted.xml,v
retrieving revision 1.6.2.3
retrieving revision 1.6.2.4
diff -u -r1.6.2.3 -r1.6.2.4
--- getstarted.xml 2000/03/16 20:44:41 1.6.2.3
+++ getstarted.xml 2000/03/17 12:46:46 1.6.2.4
@@ -18,9 +18,7 @@
<li>xerces.jar</li>
</ul>
<p>You can get the JDK or JRE from <jump href="http://www.ibm.com/java/jdk">ibm.com/java/jdk/</jump> or <jump href="http://www.java.sun.com">java.sun.com</jump>.</p>
-<p>Download <jump href="http://xml.apache.org/dist/xalan-j_1_0_0.jar">xalan-j_1_0_0.jar</jump> or <jump href="http://xml.apache.org/dist/xalan-j_1_0_0.tar.gz">xalan-j_1_0_0.tar.gz</jump>. Both of these files contain &xslt4j; 1.0.0 (with xalan.jar) and xerces.jar from Xerces-J 1.0.3. You can use the jar or tar utility to expand these files into a full build.</p>
-
-<note>You can use &xslt4j; with other XML parsers than the Xerces XML parser, but it is up to you to implement liaisons to those parsers. Your liaison class should extend <resource-ref idref="XMLParserLiaisonDefaultDoc"/> and implement <resource-ref idref="XPathSupportDoc"/>.</note>
+<p>Download <jump href="http://xml.apache.org/dist/xalan-j_1_0_0.zip">xalan-j_1_0_0.jar</jump> or <jump href="http://xml.apache.org/dist/xalan-j_1_0_0.tar.gz">xalan-j_1_0_0.tar.gz</jump>. Both of these files contain &xslt4j; 1.0.0 (with xalan.jar) and xerces.jar from Xerces-J 1.0.3. You can use a zip or tar utility to expand these files into a full build.</p>
<p>If you plan to run <link idref="extensions">XSLT extensions</link>, you need bsf.jar and bsfengines.jar, both of which are included in the &xslt4j; distribution. If you plan to run XSLT extensions implemented in JavaScript or another scripting language, you will need one or more additional files as indicated in <link idref="extensions" anchor="supported-lang">extensions language requirements</link>.</p>
</s2><anchor name="classpath"/>
1.5.2.2 +1 -4 xml-xalan/xdocs/sources/xalan/readme.xml
Index: readme.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/readme.xml,v
retrieving revision 1.5.2.1
retrieving revision 1.5.2.2
diff -u -r1.5.2.1 -r1.5.2.2
--- readme.xml 2000/03/16 18:50:11 1.5.2.1
+++ readme.xml 2000/03/17 12:46:46 1.5.2.2
@@ -1,4 +1,4 @@
-<?xml version="1.0" standalone="no"?>
+<?xml version="1.0" standalone="no"?>
<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd"[
<!ENTITY done-j SYSTEM "DONE">
<!ENTITY status-j SYSTEM "STATUS">
@@ -69,13 +69,10 @@
<s2 title="Status">
<ul>
<li><link anchor="status">Version of Xerces to use</link></li>
- <li><link anchor="done">Bug fixes</link></li>
<li><link anchor="bugs">Outstanding bugs</link></li>
</ul>
<anchor name="status"/>
&status-j;
- <anchor name="done"/>
- &done-j;
<anchor name="bugs"/>
&bugs-j;
</s2>
1.7.2.2 +2 -2 xml-xalan/xdocs/sources/xalan/resources.xml
Index: resources.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/resources.xml,v
retrieving revision 1.7.2.1
retrieving revision 1.7.2.2
diff -u -r1.7.2.1 -r1.7.2.2
--- resources.xml 2000/03/16 18:50:11 1.7.2.1
+++ resources.xml 2000/03/17 12:46:46 1.7.2.2
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="UTF-8"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE resources [
<!ENTITY apiResources SYSTEM "apiResources.xml">
<!ELEMENT resources (resource|human-resource)+>
@@ -38,7 +38,7 @@
<resource id="xml4j-used" title="Version 3.0.0EA3 of the XML Parser for Java" location="http://www.alphaworks.ibm.com/tech/xml4j"/>
- <resource id="xerces-used" title="Version 1.0.1 of Xerces-Java" location="http://xml.apache.org/xerces-j/index.html"/>
+ <resource id="xerces-used" title="Version 1.0.3 of Xerces-Java" location="http://xml.apache.org/xerces-j/index.html"/>
<resource id="JRE1.2" title="Sun's JRE-1.2" location="http://java.sun.com/products/jdk/1.2/jre/index.html"/>
<resource id="JDK1.2" title="Sun's JDK-1.2" location="http://java.sun.com/products/jdk/1.2/"/>