dleslie 00/11/28 13:58:10
Modified: xdocs/sources/xalan DONE index.xml
Log:
Draft of updates for 1.2.2
Revision Changes Path
1.37 +6 -6 xml-xalan/xdocs/sources/xalan/DONE
Index: DONE
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/DONE,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- DONE 2000/11/28 19:59:42 1.36
+++ DONE 2000/11/28 21:58:02 1.37
@@ -1,11 +1,11 @@
<s3 title="Changes since &xslt4j; version 1.2.1">
-<p>We have applied a single enhancement to this release</p>
+<p>When you use XSLTProcessor to perform multiple transformations, you must
reset the XSLTProcessor between each transformation. The existing <jump
href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#reset()">reset()</jump>
method (with no arguments) also clears all stylesheet parameters that you have
set with either of the <jump
href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#setStylesheetParam(java.lang.String,
org.apache.xalan.xpath.XObject)">setStylesheetParam()</jump> methods. In
response to requests for more control over resetting stylesheet parameters, we
have added two methods:</p>
<ul>
-<li>Working with Gary Peskin, Myriam Midy has posted a change to the
procedure for resetting top-level stylesheet parameters between the
transformations that you perform with a given XSLTProcessor object. When you
want to clear all xsl:param settings that will be submitted to the stylesheet
for the next transformation, call the new <jump
href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#resetTopLevelParams()">XSLTProcessor
resetTopLevelParams()</jump> method.</li>
+<li>The XSLTProcessor <jump
href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#reset(boolean)">reset(boolean
resetParams)</jump> method lets you specify whether stylesheet parameters are
to be reset.<br/><br/>
+If you do not want to reset the stylesheet params, call reset(false). The
XSLTProcessor <jump
href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#processStylesheet(org.apache.xalan.xslt.XSLTInputSource)">processStylesheet(XSLTInputSource
stylesheet)</jump> method uses this new method to perform a reset without
resetting stylesheet parameters.<br/><br/></li>
+
+<li>The XSLTProcessor <jump
href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#resetTopLevelParams()">resetTopLevelParams()</jump>
method clears stylesheet parameter settings without performing a general reset
of the XSLTProcessor.</li>
</ul>
-<p><em>Situation:</em> You are using an XSLTProcessor to perform multiple
transformations with a stylesheet that contains one or more
-xsl:param elements. Each time you perform a transformation, you can use the
XSLTProcessor setStylesheetParam() method to assign a value to
-each of these xsl:param elements. Once you have set a parameter, that
setting remains in place for the life of the XSLTProcessor object until you
assign a new value with setStylesheetParam() or clear all paramater settings
with resetTopLevelParams(). The XSLTProcessor reset()
-method that you are required to call between transformations no longer
attempts to clear xsl:param settings.</p>
+
<p>If you run across a problem with &xslt4j;, we strongly encourage you to
write a patch and submit it to <human-resource-ref idref="xalandev"/>. We will
review it to make sure it doesn't break something else, and (assuming it
doesn't) include it in our next release. In the interest of fixing bugs, adding
enhancements, and addressing a host of thorny design issues, we sincerely want
(and need!) your active participation in the ongoing development of Xalan.</p>
</s3>
1.15 +2 -1 xml-xalan/xdocs/sources/xalan/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/index.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- index.xml 2000/11/28 19:13:26 1.14
+++ index.xml 2000/11/28 21:58:05 1.15
@@ -64,7 +64,8 @@
is a complete and robust implementation of the W3C Recommendations for
XSL Transformations (XSLT) and the XML Path Language
(XPath).</p>
<p>Xalan can be used from the command line, in an applet or a servlet,
or as a module in other program. By default, it uses the Xerces XML parser, but
it can interface to any XML parser that conforms to the DOM level 2 or SAX
level 1 specification.</p>
- <p>This release improves support for clearing top-level stylesheet
parameter settings between transformations. For the details, see <link
idref="readme">Release Notes</link>.</p>
+ <p>This release provides you with direct control over whether
XSLTProcessor stylesheet parameter settings are cleared between
+ transformations. For the details, see <link idref="readme">Release
Notes</link>.</p>
</s2>
<s2 title="How do I get it?">
