You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by am...@apache.org on 2001/08/10 19:56:14 UTC
cvs commit: xml-xalan/java xsltc_todo.xml
amiro 01/08/10 10:56:14
Modified: java/xdocs/sources/xalan xsltc_constraints.xml
java xsltc_todo.xml
Log:
Updating these "release note/readme" files on xsltc for the next release.
They have become very rusty. The section on TrAX still has to be rewritten.
I updated the "todo" list based on the current bug list, but I'm not
sure we should have fixing-different-sets-of-bugs as 'todo' items, since
it is very hard to keep them up-to-date. Along those lines, I replaced
the "Known Problems" content with a reference to the bugs in Bugzilla.
After all, the reported bugs are the know problems.
Revision Changes Path
1.14 +4 -107 xml-xalan/java/xdocs/sources/xalan/xsltc_constraints.xml
Index: xsltc_constraints.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/xsltc_constraints.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- xsltc_constraints.xml 2001/08/09 14:11:41 1.13
+++ xsltc_constraints.xml 2001/08/10 17:56:13 1.14
@@ -39,36 +39,9 @@
<anchor name="xsltcknownproblems"/>
<s3 title="Known Problems">
<ul>
- <li>Casting variables: XSLTC requires you to explicitly type cast values
- returned by variables or expressions, when you use them in tests. Always a good
- practice, but it may seem like overkill in some in contexts, where other XSLT processors
- automatically assume or convert to the correct type. For example. unless you cast $country
- to a string in the following apply-templates, entry nodes whose <country> elements
- contain a string matching the global $country parameter are NOT selected.<br/><br/>
- <code><xsl:apply-templates select="entry[country=string($country)]"/></code></li>
- <li>Order dependency of conditions within a predicate: If you have a predicate in a select or match
- expression that has multiple conditions, one of which contains a union (X or Y), put it last.
- Otherwise, the predicate fails to match node that it should.</li>
- <li>When using DOM caching, as shown in the Servlet demo, if the source document is local to the
- server, the cache is not refreshed when the source XML document is modified. This
- problem does not apply when the source is associated with a URL.</li>
- <li>If you have a list of references included or imported stylesheets, put any with
- a relative path last; otherwise, stylesheets in the current directory are not found.</li>
- <li>[1] should be treated equivalent to position()=1, but it is not. Therefore, if
- you get unexpected results using such shortcut positional predicates, substitute the
- full postion()= version.</li>
- <li>XSLTC fails to match existing nodes when match expressions have
- multiple steps with predicates containing the position function.
- The following examples are taken from the XSLTMark oddtemplates.xsl test:<br/><br/>
- <code> match='top/*[position()=2]'</code><br/>
- <code> match='top/*[6]/kid[2]'</code><br/>
- <code> match='top/*[position()=last()]'</code><br/></li>
- <li>XSTLC has problems with output escaping, see bug 1403.</li>
- <li>Case-order option with sorting is ignored.</li>
- <li>As a minor side-effect of implementing simplified stylesheets, if you inadvertenly
- go to compile a stylesheet and give the name of the .xml doc instead of the .xsl doc,
- it may compile without a warning. In some cases, the compiler aborts with an error
- about too many branches.</li>
+ <li>All the currently know problems with XSLTC are filed in Bugzilla. To see the list,
+ do a query with the Program set to XalanJ2 and the Components set to org.apache.xalan.xsltc and/or
+ Xalan-Xsltc.</li>
</ul>
</s3>
<anchor name="xsltcdemos"/>
@@ -95,70 +68,7 @@
<anchor name="xsltctrax"/>
<s3 title="Translets and TrAX">
-<p>
-The Translet API has been extended to conform with the JAXP1.1 TrAX model.
-This release contains the first implementation of that extension. Two
-new classes have been added to the Translet XSLT codebase, they are:</p>
-<p>(1) <code>org.apache.xalan.xsltc.runtime.TransformerFactoryImpl</code> -<br/>
- the Translet implementation of a SAXTransformerFactory.</p>
-<p>(2) <code>org.apache.xalan.xsltc.runtime.TransletTemplates</code> -
- the Translet implementation of a Templates object.</p>
-<p>
-The existing XSLT class 'org.apache.xalan.xsltc.runtime.AbstractTranslet'
-that implements the Translet interface is now also extending the
-javax.xml.transform.Transformer abstract class.
-</p>
-<p>
-This implementation is only a partial implementation, with many limitations.
-These limitations include:
-</p>
-<ol>
-<li>Currently 'StreamSource' and 'StreamResult' are the only
- TrAX Sources and Results that are supported.</li>
-<li>The translet is compiled everytime a call is made to the<br/>
-<code>TransformerFactoryImpl 'newTransformer()'</code> method.</li>
-<li>The translet is compiled everytime a call is made to the <br/>
-<code>TemplateFactoryImpl 'newTransformer()'</code> method.</li>
-<li>Translet are currently not cached. (See (2) and (3)).</li>
-<li>Several abstract methods from SAXTransformerFactory still need to
-be implemented in the xsltc.runtime.TransformerFactoryImpl class:<br/><br/>
-<code> TemplatesHandler newTemplatesHandler()</code><br/>
-<code> TransformerHandler newTransformerHandler()</code><br/>
-<code> TransformerHandler newTransformerHandler(Source src)</code><br/>
-<code> TransformerHandler newTransformerHandler(Templates templates)</code><br/>
-<code> XMLFilter newXMLFilter(Source src)</code><br/>
-<code> XMLFilter newXMLFilter(Templates templates)</code></li>
-<li>Several abstract methods from Transformer still need to be implemented in the
-AbstractTranslet class:<br/><br/>
-<code> ErrorListener getErrorListener()</code><br/>
-<code> void setErrorListener(ErrorListener)</code><br/>
-<code> Properties getOutputProperties()</code><br/>
-<code> String getOutputProperty(String name)</code><br/>
-<code> void setOutputProperties(Properties props)</code><br/>
-<code> void setOutputProperty(String name, String value)</code><br/>
-<code> URIResolver getURIResolver()</code><br/>
-<code> void setURIResolver(URIResolver resolver)</code></li>
-<li>Abstract method from Templates still need to be implemented in the TransletTemplates class:<br/><br/>
-<code> Properties getOutputProperties()</code></li>
-<li>Several abstract methods from TransformerFactory still need to be implemented
-in the <code>xsltc.runtime.TransformerFactoryImpl</code> class:<br/><br/>
-<code> ErrorListener getErrorListener()</code><br/>
-<code> void setErrorListener(ErrorListener listener)</code><br/>
-<code> Object getAttribute(String name)</code><br/>
-<code> void setAttribute(String name, Object value)</code><br/>
-<code> boolean getFeature(String name)</code><br/>
-<code> URIResolver getURIResolver()</code><br/>
-<code> void setURIResolver(URIResolver resolver)</code><br/>
-<code> Source getAssociatedStylesheet(Source src, String media, String title,</code><br/>
-<code> String charset)</code><br/>
-<code> Templates newTemplates(Source xslSrc)</code><br/>
-<code> Transformer newTransformer()</code></li>
-<li>Whenever possible, the required methods that are currently unimplemented will throw an
-exception if someone tries to call them- this will alert the user that the method is not implemented.
-The message is of the form:<br/><br/>
-<code> "<Class Name>:<Method Name>( <args> ) not implemented yet."</code>
-</li>
-</ol>
+<p>TO BE REWRITTEN</p>
</s3>
<anchor name="xsltchistory"/>
<s3 title="History of XSLTC software changes">
@@ -673,19 +583,6 @@
utilities. You can already use the same JAXP interfaces to perform
transformations with the Xalan transformer and with translets. Over time, we plan to merge the two codebases.
<ref>See <jump href="xsltc/index.html">XSLTC Design Documents</jump>.</ref></p>
-<p>Since this is the first release of XSLTC on Apache (xml.apache.org), changes are
-relative to Preview 5 of XSLTC posted on www.sun.com/xml/developers.</p>
-<ul>
- <li>Simplified stylesheets are now implemented.</li>
- <li>Base package name has changed from <code>com.sun.xslt</code> to <code>org.apache.xalan.xsltc</code></li>
- <li>You no longer have to get the BCEL.jar file; it is included in the distribution.</li>
- <li>The Project X parser components and APIs have all been replaced with JAXP equivalents.
- Consequently, you may deploy XSLTC with JAXP-conformant parsers, such as Xerces or Crimson.</li>
- <li>Previously undocumented feature: -x. You can use the -x option on the java command line when you
- compile translets or run them to get more detailed information on errors.</li>
- <li>Addition of -s to DefaultRun - a new -s option has been added to the DefaultRun class
- for use with test auotmation. When you use the option, it prevents System.exit() from being called when
- and exception is encountered.</li>
</ul>
</s4>
</s3>
1.5 +26 -61 xml-xalan/java/xsltc_todo.xml
Index: xsltc_todo.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xsltc_todo.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- xsltc_todo.xml 2001/06/20 17:43:53 1.4
+++ xsltc_todo.xml 2001/08/10 17:56:14 1.5
@@ -23,8 +23,8 @@
<actions>
<target-release-description>
- <date>05/18/01</date>
- <level>beta</level>
+ <date>09/??/01</date>
+ <level>????</level>
<goal type="conformance">XSLT 1.0 compliant 100%.</goal>
<goal type="performance">Maintain current level.</goal>
<goal type="stability"> Stable, reasonable.</goal>
@@ -32,26 +32,16 @@
<goal type="documentation">Documentation functionally complete.</goal>
</target-release-description>
- <action context="doc"
- category="documentation"
- who="MJ"
- priority="high">
- Produce documentation on architecture of XSLTC so the larger developer
- community can contribute to the development of XSLT.
- </action>
-
<action context="test, packages:org.apache.xalan.xsltc"
category="tests"
who="TA, Shane"
priority="high">
- Integrate tests not already there into the Xalan test suite and begin
- using the Xalan test suite to test XSLTC as a component of XalanJ2.
- (This should wait until #1 is done.)
+ Modify Xalan test enviroment to test XSLTC as a component of XalanJ2.
</action>
<action context="code, packages:org.apache.xalan.xsltc"
category="feature"
- who="??"
+ who="MJ"
priority="high">
Finish the implementation of id() and key() in patterns.
</action>
@@ -62,54 +52,51 @@
priority="high">
Continue to improve the handling of name spaces. There are a number of
bugs that are independent of the lack of namespace nodes.
- (bugzilla 1411, 1472, 1473, 1506, 1517, 1518)
+ (bugzilla 1411, 1506, 1518, 2582, 2801, 2857, 2859, 2863, 2535, 2954, 2840)
</action>
-
<action context="code, packages:org.apache.xalan.xsltc"
category="bug"
who="??"
priority="high">
Fix bugs that impact the XSLTMark performance benchmark.
- (bugzilla 1498, 1532).
+ (bugzilla 1376, 1498, 1512, 1532, 2351, 2517, 2553, 3065, 3066).
</action>
<action context="code, packages:org.apache.xalan.xsltc"
- category="feature"
- who="??"
+ category="bugs"
+ who="TM"
priority="high">
- Fix bugs that impact the use of XSLT with DocBook (1404, 1487).
+ Fix bugs reflecting positional problems (1410, 1532, 2939).
</action>
<action context="code, packages:org.apache.xalan.xsltc"
- category="feature"
- who="MJ"
+ category="bug"
+ who="TM"
priority="high">
- Fix bugs with the handling of variables and parameters (1487, 1408)
- </action>
-
+ Fix bugs on dealing with XPATH/Axes expressions (1498, 2551, 2553, 2572, 2932).
+ </action>
<action context="code, packages:org.apache.xalan.xsltc"
- category="feature"
- who="TM"
- priority="high">
- Fix bugs reflecting positional problems (1409, 1410, 1412, 1532).
+ category="bug"
+ who="??"
+ priority="medium">
+ Fix bugs involving template selection (1397, 2749, 2582, 2585, 2695, 2749, 2754, 2886, 2937).
</action>
<action context="code, packages:org.apache.xalan.xsltc"
- category="feature"
- who="TM"
- priority="high">
- Fix bugs on dealing with XPATH expressions (1407, 1511).
- </action>
-
+ category="bug"
+ who="??"
+ priority="medium">
+ Fix bugs affecting numbering (2901, 2931).
+ </action>
<action context="code, packages:org.apache.xalan.xsltc"
- category="feature"
- who="who"
+ category="bug"
+ who="??"
priority="medium">
- Fix bugs involving template selection (1503, 1397).
+ Fix bugs affecting comment and processing-intruction nodes (2599, 2834, 2858).
</action>
<action context="code, packages:org.apache.xalan.xsltc"
@@ -119,15 +106,6 @@
Implement name space nodes (bugzilla 1379).
</action>
- <action context="code, packages:org.apache.xalan.xsltc"
- category="feature"
- who="??"
- priority="low">
- Look into proper caching algorithms and improve the example given in
- DocumentCache.java accordingly.
- </action>
-
-
<action context="code, packages:????"
category="feature, integration with Xalan"
who="??"
@@ -165,8 +143,7 @@
who="??"
priority="medium">
Fix bugs affecting the correctness of ouput
- (1403, 1406, 1441, 1489, 1429, 1504,
- 1508, 1512, 1513, 1516, 1520, 1521, 1525).
+ (1439, 1504, 1512, 1516, 1520, 1525, 2517, 2520, 2578, 2948, 2951, 2952, 2954, 3005, 3065).
Note: Task may be implemented as a result of integrating Xsltc and Xalan
and using shared code.
</action>
@@ -196,16 +173,4 @@
</action>
</actions>
-
- <completed>
- <action context="code, packages: org.apache.xalan.xsltc"
- category="feature"
- who="MJ, TM"
- priority="high">
- Replace all Project X components and APIs with
- JAXP equivalents (this includes updating compiler's parser
- to use SAX2/DOM2).
- </action>
- </completed>
-
</todo>
---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xalan-cvs-help@xml.apache.org