You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@xml.apache.org by dl...@locus.apache.org on 2000/03/07 17:49:59 UTC
cvs commit: xml-site/targets/xalan dtm.html faq.html getstarted.html overview.html readme.html samples.html usagepatterns.html
dleslie 00/03/07 08:49:58
Modified: targets/xalan dtm.html faq.html getstarted.html
overview.html readme.html samples.html
usagepatterns.html
Log:
Xalan 0.20.0 Gold Candidate
Revision Changes Path
1.10 +17 -14 xml-site/targets/xalan/dtm.html
Index: dtm.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/dtm.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- dtm.html 2000/03/03 15:48:49 1.9
+++ dtm.html 2000/03/07 16:49:57 1.10
@@ -46,24 +46,27 @@
<IMG border="0" height="14" hspace="0" src="resources/close.gif" vspace="0" width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE border="0" cellpadding="3" cellspacing="0"><TR><TD>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using the Xalan DTM (Document Table Model)</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0
" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P><A href="http://www.w3.org/DOM" target="_top">DOM</A> (Document Object Model) provides a standard interface for interacting
- with XML documents. Xalan supports this interface: when you set up an XSLTProcessor to use
- <A href="apidocs/org/apache/xalan/xpath/xdom/XercesLiaison.html" target="_top">XercesLiaison class</A> and the Xerces XML parser, Xalan uses an implementation of the
- DOM interface. For large XML documents, however, this may involve considerable overhead, since Xalan must create
- one or more Java objects for each Node in the DOM tree.</P>
- <P>For those cases where your input and output are URLS, files, or streams, and you use the default liaison (<A href="apidocs/org/apache/xalan/xpath/dtm/DTMLiaison.html" target="_top">DTMLiaison class</A>) and XML parser, Xalan avoids this overhead by implementing a DTM, a "pseudo-DOM" that uses
- integer arrays to represent the required information about the DOM Nodes. For larger input and output trees, the
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using the Xalan Document Table Model (DTM)</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0
" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <P>The Document Object Model (<A href="http://www.w3.org/DOM" target="_top">DOM</A>) provides a standard interface for interacting
+ with XML documents. Xalan supports this interface. For large XML documents, however, this may involve considerable
+ overhead, since Xalan must create one or more Java objects for each Node in the document DOM tree.</P>
+ <P>For the majority of cases -- your input and output are URLS, files, or streams, and you use the default Liaison
+ (<A href="apidocs/org/apache/xalan/xpath/dtm/DTMLiaison.html" target="_top">DTMLiaison class</A>) and XML parser, Xalan avoids this overhead by implementing the Document Table
+ Model (DTM), a "pseudo-DOM" that uses integer arrays in place of the DOM. For larger input and output trees, the
performance improvements can be very significant.</P>
- <P>The <A href="apidocs/org/apache/xalan/xslt/XSLTProcessorFactory.html#getProcessor()">XSLTProcessorFactory
- getProcessor()</A> method (with no arguments) sets up an XSLT processor to use the default DTM
- liaison and parser. Keep in mind that if your input or output is a DOM, you must use a "standard" DOM liaison and XML
- parser, such as XercesLiaison and the Xerces XML parser. For more information, see
- <A href="usagepatterns.html#dom-in">Processing DOM input and Producing DOM output</A>.</P>
+ <P>The <A href="apidocs/org/apache/xalan/xslt/XSLTProcessorFactory.html#getProcessor()" target="_top">XSLTProcessorFactory static getProcessor() method</A> sets up an XSLT processor to use the default DTM liaison
+ and XML parser. If your input or output turns out to be a DOM Node, the XSLTProcessor automatically switches to the
+ <A href="apidocs/org/apache/xalan/xpath/xdom/XercesLiaison.html" target="_top">XercesLiaison class</A> and the Xerces DOM parser. You can explicitly instantiate an XSLTProcessor to use
+ XercesLiaison and the Xerces DOM parser as follows:</P>
+ <P><CODE><FONT face="courier, monospaced">org.apache.xalan.xsltXSLT.Processor xsltProc = org.apache.xalan.xslt.XSLTProcessorFactory.getProcessor(</FONT></CODE><BR>
+ <CODE><FONT face="courier, monospaced"> new org.apache.xalan.xpath.xdom.XercesLiaison());</FONT></CODE></P>
+ <P>For more information, see <A href="usagepatterns.html#dom-in">Processing DOM input and Producing DOM
+ output</A>.</P>
<TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I>The DTM parser always attempts to expand entitity references in the source tree and stylesheet
tree. If you attempt to turn off entity reference expansion -- with DTMLiaison
setShouldExpandEntitityRefs(false) -- DTMLaison does not make the setting and issues a message to that
- effect. If you want to turn off entity refereence expansion, use XercesLiaison.</I></FONT></TD></TR></TABLE>
+ effect. If you want to turn off entity refereence expansion, instantiate the XSLTProcessor to use XercesLiaison and the
+ Xerces DOM parser.</I></FONT></TD></TR></TABLE>
</FONT></TD></TR></TABLE><BR>
</TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
Copyright © 2000 The Apache Software Foundation.
1.2 +2 -2 xml-site/targets/xalan/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/faq.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- faq.html 2000/03/03 14:34:08 1.1
+++ faq.html 2000/03/07 16:49:57 1.2
@@ -68,11 +68,11 @@
<P>Second scenario: you want to perform a number of transformations with the same stylesheet. To improve performance, you
compile the stylesheet once, and use the resulting <A href="apidocs/org/apache/xalan/xslt/StylesheetRoot.html" target="_top">StylesheetRoot class</A> object for each
transformation.</P>
- <P>You can use the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#process(org.apache.xalan.xslt.XSLTInputSource,org.apache.xalan.xslt.XSLTInputSource,org.apache.xalan.xslt.XSLTOutputTarget)">
+ <P>You can use the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#process(org.apache.xalan.xslt.XSLTInputSource, org.apache.xalan.xslt.XSLTInputSource, org.apache.xalan.xslt.XSLTResultTarget)">
XSLTProcessor process()</A> method with a compiled stylesheet. For an example, see <A href="usagepatterns.html#compiled">Compiling stylesheets</A>. But an XSLTProcessor object is not thread-safe and must be
reset between transformations. A StylesheetRoot object, on the other hand, is thread-safe and may even be used concurrently
(running in a servlet, for example) to perform multiple transformations, so it is more straightforward to use the
- <A href="apidocs/org/apache/xalan/xslt/StylesheetRoot.html#process(org.apache.xalan.xslt.XSLTInputSource,org.apache.xalan.xslt.XSLTOutputTarget)">
+ <A href="apidocs/org/apache/xalan/xslt/StylesheetRoot.html#process(org.apache.xalan.xslt.XSLTInputSource, org.apache.xalan.xslt.XSLTResultTarget)">
StylesheetRoot process()</A> method to perform the transformations.</P>
<P>Example:</P>
<DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4" width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff" width="462"><FONT size="-1"><PRE>import org.apache.xalan.xslt.*;
1.4 +6 -6 xml-site/targets/xalan/getstarted.html
Index: getstarted.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/getstarted.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- getstarted.html 2000/03/03 15:48:49 1.3
+++ getstarted.html 2000/03/07 16:49:57 1.4
@@ -61,7 +61,7 @@
<LI>xerces.jar</LI>
</UL>
<P>You can get the Sun JDK or JRE from <A href="http://www.java.sun.com">java.sun.com</A>. Download the latest release of Xalan and Xerces-java from <A href="http://xml.apache.org/dist/">xml.apache.org</A>. Check the <A href="readme.html#status">version release notes</A> to verify that you are using the correct version of Xerces. <B>Important</B> You may experience unpredictable anomalies if your Xalan and Xerces-Java builds are not in synch. 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 <A href="apidocs/org/apache/xalan/xpath/xml/XMLParserLiaisonDefault.html" target="_top">XMLParserLiaisonDefault class</A> and implement <A href="apidocs/org/apache/xalan/xpath/XPathSupport.html" target="_top">XPathSupport interface</A>.</P>
-<TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I>You may also download the latest releases of LotusXSL and the XML Parser for Java from <A href="http://www.alphaworks.ibm.com/tech/LotusXSL">alphaWorks</A>. LotusXSL and the XML Parser for Java are Xalan and Xerces-java respectively, along with additional features and with wrappers to support the core API in place on alphaWorks before the first releases of Xalan and Xerces-java on xml.apache.org in November 1999. The alphaWorks LotusXSL release also provides continued support for earlier alphaWorks releases of the XML4J DOM and TXDOM parsers.</I></FONT></TD></TR></TABLE>
+
<P>If you plan to run <A href="extensions.html">XSLT extensions</A>. you need bsf.jar and bsfengines.jar, both of which are included in the Xalan 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 <A href="extensions.html#supported-lang">extensions language requirements</A>.</P>
</FONT></TD></TR></TABLE><BR><A name="classpath"><!--anchor--></A>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Setting up the system class path</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resou
rces/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
@@ -95,18 +95,18 @@
<P>You can start by using your own XML source files and XSL stylesheets with the sample applications, which illustrate a number of the <A href="#usage-patterns">basic usage patterns</A>.</P>
<P>If you modify a java source file, be sure to compile the class and place it on the system class path. Here are some basic points to keep in mind as you are setting up transformations:</P>
<UL>
-<LI>Use one of the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessorFactory.html" target="_top">XSLTProcessorFactory class</A> static getProcessor methods to set up an <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html" target="_top">XSLTProcessor interface</A>. <BR><BR>By default, the XSLTProcessor uses the <A href="apidocs/org/apache/xalan/xpath/dtm/DTMLiaison.html" target="_top">DTMLiaison class</A> and the high-performance <A href="dtm.html"> Document Table Model (DTM)</A> "pseudo-DOM" parser to process the input. If your input or output is a DOM node (rather than a URL, file, or stream), you must use a "standard" DOM liaison and XML parser, such as the <A href="apidocs/org/apache/xalan/xpath/xdom/XercesLiaison.html" target="_top">XercesLiaison class</A> and the Xerces XML parser. For an example, see <A href="#dom-in">Processing DOM input</A>.<BR><BR></LI>
+<LI>Use the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessorFactory.html#getProcessor()" target="_top">XSLTProcessorFactory static getProcessor() method</A> to set up an <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html" target="_top">XSLTProcessor interface</A> object.<BR><BR></LI>
<LI>Set up <A href="apidocs/org/apache/xalan/xslt/XSLTInputSource.html" target="_top">XSLTInputSource class</A> objects for the XML input and XSL stylesheet. You can use a file name or URL, character streams, byte streams, or SAX input stream to instantiate an XSLTInputSource object.<BR><BR>
If the XML document contains a stylesheet Processing Instruction (PI), you do not need to create a separate
XSLTInputSource object for an XSL stylesheet.<BR><BR></LI>
-<LI>For improved performance with a series of transformations, use the XSLTProcessor processStylesheet method to compile the XSL stylesheet (the result is a <A href="apidocs/org/apache/xalan/xslt/StylesheetRoot.html" target="_top">StylesheetRoot class</A>.<BR><BR>
-This is also useful when you need to get information from the stylesheet before the tranformation occurs, for
+<LI>For improved performance with a series of transformations, use the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#processStylesheet(java.lang.String)" target="_top">XSLTProcessor processStylesheet() method</A> to compile the XSL stylesheet (the result is a <A href="apidocs/org/apache/xalan/xslt/StylesheetRoot.html" target="_top">StylesheetRoot class</A>), and then use the <A href="apidocs/org/apache/xalan/xslt/StylesheetRoot.html#process(org.apache.xalan.xslt.XSLTInputSource, org.apache.xalan.xslt.XSLTResultTarget)" target="_top">StylesheetRoot process() method</A> to perform the transformations.<BR><BR>
+Compiling the stylesheet is also useful when you need to get information from the stylesheet before the tranformation occurs, for
instance, when you need to find out the output encoding in order to construct the right kind of Writer.
You must also compile the stylesheet if you are using the XSLTProcessor as a SAX document handler (see <A href="usagepatterns.html#sax">Generating and responding to SAX events</A>).<BR><BR></LI>
<LI>Set up an <A href="apidocs/org/apache/xalan/xslt/XSLTResultTarget.html" target="_top">XSLTResultTarget class</A> for the transformation output. You can use a file name or URL, character stream, byte stream, or SAX document handler to instantiate an XSLTOutputTarget object.<BR><BR></LI>
-<LI>Use the XSLTProcessor (or, in some cases, the <A href="apidocs/org/apache/xalan/xslt/StylesheetRoot.html" target="_top">StylesheetRoot class</A>) process method to perform the transformation.<BR><BR>
+<LI>Use the XSLTProcessor process() method to perform the transformation, or the StylesheetRoot process() method to perform a series of transformations with the same stylesheet.<BR><BR>
XSLTProcessor is thread-safe for one instance per thread. If you are using the same instance of XSLTProcessor to perform
-more than one transformation, call the reset method between transformations. StylesheetRoot is multithread-safe. amd a single instance may be used acress threads.</LI>
+more than one transformation, call the reset method between transformations. StylesheetRoot is multithread-safe, and a single instance may be used across threads. Accordingly, you can call a StylesheetRoot object process() method repeatedly without resetting the StyleSheetRoot.</LI>
</UL>
<P>For more information on setting up applications, see <A href="usagepatterns.html">Usage Patterns</A>.</P>
</FONT></TD></TR></TABLE><BR>
1.16 +3 -3 xml-site/targets/xalan/overview.html
Index: overview.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/overview.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- overview.html 2000/03/03 15:48:48 1.15
+++ overview.html 2000/03/07 16:49:57 1.16
@@ -53,9 +53,9 @@
<LI><A href="#glossary">Glossary</A></LI>
</UL><A name="intro"><!--anchor--></A>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Introduction</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vsp
ace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P>Xalan (named after a rare musical instrument) fully implements the <A href="http://www.w3.org/TR/xslt" target="_top">W3C Recommendation 16 November 1999 XSL Transformations (XSLT) Version 1.0</A>.
- XSLT is the first part of the XSL stylesheet language for XML. It includes the XSL Transformation vocabulary and the
- <A href="http://www.w3.org/TR/xpath" target="_top">XML Path Language (XPath) Version 1.0</A>, a language for addressing parts of XML documents. For links to background materials,
+ <P>Xalan (named after a rare musical instrument) fully implements the <A href="http://www.w3.org/TR/xslt" target="_top">W3C Recommendation 16 November 1999 XSL Transformations (XSLT) Version 1.0</A> and the
+ <A href="http://www.w3.org/TR/xpath" target="_top">XML Path Language (XPath) Version 1.0</A>. XSLT is the first part of the XSL stylesheet language for XML. It includes the XSL
+ Transformation vocabulary and XPath, a language for addressing parts of XML documents. For links to background materials,
discussion groups, frequently asked questions, and tutorials on XSLT, see <A href="#uptospeed">Getting up
to speed with XSLT</A>.</P>
<TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I>XSL also includes a vocabulary for formatting documents, which is still under design and is not part of Xalan.
1.12 +729 -62 xml-site/targets/xalan/readme.html
Index: readme.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/readme.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- readme.html 2000/03/03 15:48:48 1.11
+++ readme.html 2000/03/07 16:49:57 1.12
@@ -57,70 +57,731 @@
<LI><A href="#bugs">Outstanding bugs</A></LI>
</UL>
<A name="status"><!--anchor--></A>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Version of Xerces to use</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif
" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
-<P>The version of xalan.jar shipped with this release works with the xerces.jar shipped in Xerces-java version 1.0.1.</P>
-</FONT></TD></TR></TABLE><BR>
-<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Things still to be done</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspa
ce="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
- <P>We still need to do the following:</P>
- <UL>
- <LI>Switch from Makefile et.al. to an Ant-based system (contact: shane_curcur@lotus.com working on).<BR><BR></LI>
- <LI>Create a simple 'minitest' so anyone can verify very basic
- functionality of Xalan. (shane_curcuru@lotus.com working on).<BR><BR></LI>
- <LI>Have more regular builds, synched with Xerces builds.<BR><BR></LI>
- <LI>attribute:: and child:: (ChildOrAttributeAxisSpecifier) in patterns are not
- yet implemented.<BR><BR></LI>
- <LI>The main focus for the next release (0.19.2, and upcoming 0.19.3) will be performance.<BR><BR></LI>
- <LI>Extensions need further work to become more robust and less confusing.<BR><BR></LI>
- <LI>Beyond this, and a few other minor conformance issues, the goal is to
- reach a level of stability that can be tagged as a 1.0.0 release.<BR><BR></LI>
- </UL>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>To-do tasks for future Xalan versions</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resou
rces/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <P>Things we are planning or would like to do in Xalan:</P>
+ <UL>
+ <LI>Updating this STATUS file regularly</LI>
+ <LI>This (Xalan 0.20.0) is a Gold Candidate release. Before we release this as the long-awaited Xalan 1.0.0, we'd
+ like you all to bang on it a bit, especially via the API. We've done a pretty good job at testing via the
+ org.apache.xalan.xslt.Process command-line utility, but we have more limited exposure to running in more complicated
+ run-time scenarios, especially multi-threaded, etc.</LI>
+ <LI>We're looking at replacing our current make system with Ant for post Xalan 1.0. Shane shane_curcuru@lotus.com is looking
+ into this.</LI>
+ <LI>It would be great if someone would volunteer to own JBuilder support for Xalan, e.g., regularly test to make sure we
+ compile and run correctly in that environment, produce project files for JBuilder for released version of Xalan, etc.</LI>
+ <LI>Ditto for other IDE's: Visual Cafe, MSVJ++, whatever people have expertise in. If you're interested, post a note to the
+ list.
+ The best person to maintain stuff like this is someone who works with the builder on a regular basis, and that isn't me! </LI>
+ <LI>There's a lot of talk now about Xalan 2.0 and what that will be, including a possible top-down redesign.
+ Watch the xalan-dev list for more information and for ideas about how you can get involved.</LI>
+ </UL>
</FONT></TD></TR></TABLE><BR>
<A name="done"><!--anchor--></A>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Bug fixes since the last version</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/
void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
- <P>Bugs (SPR ID and Description) fixed since version 0.19.1:</P>
- <UL>
-<LI>MMIY4ELLNZ Error reporting mechanism needs major improvements.<BR><BR></LI>
-<LI>PDIK4ELNRC Outp tests 19,20,21,22,23 now failing to output xml headers w/ different encodings.<BR><BR></LI>
-<LI>PDIK4ELPBD Document()'s error resources should be in XSLT not XPATH.<BR><BR></LI>
-<LI>PDIK4ELSE3 Entref01: value-of is not passing "&" thru to result output file.<BR><BR></LI>
-<LI>SCUU4ELPRP TestThreads: running processors on multiple threads throws exceptions.<BR><BR></LI>
-<LI>SCUU4ELPWT Samples do not compile from LotusXSL distribution.<BR><BR></LI>
-<LI>SCUU4ELRSG Xalan's samples\pipe does not appear to work from end-user perspective.<BR><BR></LI>
-<LI>PDIK4ESQA5 LRE attribute creation will include nodes with names in the XSLT namespace.<BR><BR></LI>
-<LI>PDIK4ESQEF Both forms of exclude-result-prefixes fail to suppress the default namespace - #default.<BR><BR></LI>
- </UL>
-</FONT></TD></TR></TABLE><BR>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Work done since the last Xalan version</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="reso
urces/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <P>The following features were added in 0.20.0:</P>
+ <UL>
+ <LI>Xerces 1.02 integration - This was pretty simple, just some packaging changes in the SAX2 classes.</LI>
+ <LI>API and JavaDoc - We tried to make the API cleaner and easier to understand.</LI>
+ <LI>Disable compilation with debug data - This cut down on the size of our JAR file by 300K or so.</LI>
+ </UL>
+</FONT></TD></TR></TABLE><BR>
+<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Bugs Pended since the last Xalan version</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resourc
es/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <P>The following are Pending bugs (we think they're fixed but haven't tested them):</P>
+ <UL>
+ <LI>PDIK4GZM3K: Calling initXPath twice in a row will cause ArrayIndexOBE due to m_tokenQueue being to small.
+
+ </LI>
+ <LI>SBOG4GYUUS: No env support to get variable, in 2nd pipe of piped transform
+
+ </LI>
+ <LI>SBOG4H3L4K: MDOCS\mdocs04, MDOCS\mdocs08, and 09 throw null pointer exception with SAX-based tests.
+
+ </LI>
+ </UL>
+</FONT></TD></TR></TABLE><BR>
+
+<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Bugs resolved since the last Xalan version</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resou
rces/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <P>The following are Resolved bugs (fixed and tested):</P>
+ <UL>
+ <LI>DLEE4FYH9D: No support for sending primitives in extension functions
+
+ </LI>
+ <LI>DMAN465L5N: Browser hangs when running demo
+
+ </LI>
+ <LI>DMAN465LF8: Problem with relative URIs in nested import/include
+
+ </LI>
+ <LI>DMAN46GRGT: Must create a new instance of XSLProcessor for each process() call
+
+ </LI>
+ <LI>DMAN46HL8J: Empty text nodes generated when stripping whitespace
+
+ </LI>
+ <LI>DMAN46HSBF: Non-expanded entity references are lost
+
+ </LI>
+ <LI>DMAN46PTL7: CDATA treatment of character entities should follow spec painfully
+
+ </LI>
+ <LI>DMAN46PTTQ: Extra lines around output from CDATA section
+
+ </LI>
+ <LI>DMAN475K6J: Two rules for exact same pattern don't resolve as they should
+
+ </LI>
+ <LI>DMAN4D5SKA: xsl:message doesn't recognize terminate attribute
+
+ </LI>
+ <LI>DMAN4D5SPC: xsl:message puts out garbage around literal message
+
+ </LI>
+ <LI>DMAN4D5SRT: Decimal format for per-mille is not working
+
+ </LI>
+ <LI>DMAN4D5T4Z: xsl:decimal-format element not recognized
+
+ </LI>
+ <LI>DMAN4DBRUM: Compound inequality not being evaluated per spec
+
+ </LI>
+ <LI>DMAN4DHNXH: Match patterns comment() and processing-instruction() not firing
+
+ </LI>
+ <LI>DMAN4DHPF2: No way to express < or <= in a predicate
+
+ </LI>
+ <LI>DMAN4DHPJT: Numeric sorting of NaN inconsistent; spec doesn't address
+
+ </LI>
+ <LI>DMAN4DWTUK: round() not handling .5 cases per spec
+
+ </LI>
+ <LI>DMAN4E7UU8: Included stylesheets need distinguished namespaces, etc.
+
+ </LI>
+ <LI>DMAN4EFSVL: Boolean-valued lang() function emits no output
+
+ </LI>
+ <LI>DMAN4EFTBU: boolean(node-set) should return true for non-empty set
+
+ </LI>
+ <LI>DMAN4EFU46: Equality of result tree fragments fails
+
+ </LI>
+ <LI>DMAN4EFUNB: decimal-format reassignment of characters in format string has no effect
+
+ </LI>
+ <LI>DMAN4EJUUG: Default decimal-format declarations cannot be changed
+
+ </LI>
+ <LI>DMAN4ESS98: Sort with data-type="number" should only rearrange numbers.
+
+ </LI>
+ <LI>DMAN4ETPTK: case-order attribute apparently ignored in xsl:sort
+
+ </LI>
+ <LI>DMAN4FEPC5: Some xsl:sort attributes must reject bad keyword values
+
+ </LI>
+ <LI>DMAN4FFQBJ: Need correct URL in system-property
+
+ </LI>
+ <LI>DMAN4FNSEU: Need error message for xsl:choose lacking an xsl:when
+
+ </LI>
+ <LI>DMAN4FQJUL: Use of key() in keyspace causes crash
+
+ </LI>
+ <LI>DMAN4FQK48: key() has badly-formed error message when keyspace doesn't exist
+
+ </LI>
+ <LI>DMAN4FQRJL: key() should issue an error if it doesn't get exactly two arguments
+
+ </LI>
+ <LI>DMAN4FVSJG: Some bad links on Apache Xalan pages
+
+ </LI>
+ <LI>DMAN4FWUKK: key() is not creating a complete node-set
+
+ </LI>
+ <LI>DMAN4FYPWC: Descriptions missing in JavaDocs
+
+ </LI>
+ <LI>DMAN4FYQFS: Need better JavaDocs strings in XPathProcessorImpl class
+
+ </LI>
+ <LI>DMAN4FYREQ: Miscellaneous cleanup needed on Xalan API page on apache.org Website
+
+ </LI>
+ <LI>DMAN4FYSFJ: Need better JavaDoc for XSLTProcessorApplet class
+
+ </LI>
+ <LI>DMAN4FYSTE: Need better JavaDoc for XSLTProcessor Interface
+
+ </LI>
+ <LI>DMAN4GBLKN: Generated numbers sometimes have wrong format
+
+ </LI>
+ <LI>DMAN4GBMGY: Wacky numbering when level=multiple and from has only one level
+
+ </LI>
+ <LI>DMAN4GBQXL: Conversion of non-convertible string to number no longer obtains NaN
+
+ </LI>
+ <LI>DMAN4GDLHD: Strange counting in xsl:number level="any" when count path has a predicate
+
+ </LI>
+ <LI>DMAN4GDLQQ: Numbering separate levels with xsl:number level=single misses top level
+
+ </LI>
+ <LI>DMAN4GEVDF: Version number cannot be built into system-property
+
+ </LI>
+ <LI>DMAN4GHQNU: Using sort with either last() or position() in select expression crashes
+
+ </LI>
+ <LI>DMAN4GHVGP: NumberFormat09 crashes after issuing incorrect error message
+
+ </LI>
+ <LI>DMAN4GJPXR: Can crash under some conditions when variable is undefined
+
+ </LI>
+ <LI>DMAN4GJRZH: Null test in xsl:if triggers wrong error message
+
+ </LI>
+ <LI>DMAN4GKV7N: Unions in select patterns often fail
+
+ </LI>
+ <LI>DMAN4GRRTD: No error message for bad attribute in decimal-format
+
+ </LI>
+ <LI>DMAN4GSLST: Disallowed name for created PI causes runtime exception
+
+ </LI>
+ <LI>DMAN4GSM9Q: Must catch bad NCnames in xsl:element
+
+ </LI>
+ <LI>DMAN4GSP5T: Missing select on xsl:copy-of causes stack dump
+
+ </LI>
+ <LI>DMAN4GSV35: Missing name in call-template causes stack dump
+
+ </LI>
+ <LI>DMAN4GTPUZ: Xalan only: vendor name is wrong
+
+ </LI>
+ <LI>DMAN4GXR7E: Using absolute filepath for XSL file causes stack dump
+
+ </LI>
+ <LI>DMAN4GYTXG: Boolean function doesn't anticipate null input, stack-dumps
+
+ </LI>
+ <LI>DMAN4GYU8X: Garbage in test attribute of xsl:if causes stack dump
+
+ </LI>
+ <LI>DMAN4GYVXL: Numeric expressions stack-dump if an operator or function gets a null as operand
+
+ </LI>
+ <LI>DMAN4GYW5T: Functions that take string arguments should check for null (as opposed to null string)
+
+ </LI>
+ <LI>DMAN4GZ277: Functions that expect node-set will crash if they get a null instead
+
+ </LI>
+ <LI>DMAN4H2N2Z: Under DOM, lang() fails in a case where it works under DTM
+
+ </LI>
+ <LI>DMAN4H2NDH: URL-related functions fail under DOM, but okay under DTM
+
+ </LI>
+ <LI>DMAN4H3SUC: Matching on id('literal') fails under DOM only
+
+ </LI>
+ <LI>MMIY4ELLNZ: Error reporting mechanism needs major improvements
+
+ </LI>
+ <LI>MMIY4G5RKT: Need to have XSLTInputSource have a setDocumentHandler method, etc.
+
+ </LI>
+ <LI>MMIY4G5RPR: Stylesheet Attribute validation seems not to be working
+
+ </LI>
+ <LI>MMIY4G5RY5: Processor needs to be smarter about using DTM vs. Xerces liaison
+
+ </LI>
+ <LI>MMIY4G5RZU: xsl:sort should do simple string compare if lang="english"
+
+ </LI>
+ <LI>PDIK4D2JCF: Failure to parse attribute with a SPACE within quoted string
+
+ </LI>
+ <LI>PDIK4D2JLR: Problems parsing <xsl:with-param> stmt
+
+ </LI>
+ <LI>PDIK4D9RX5: FormatterToXML is throwing a NullPointerException
+
+ </LI>
+ <LI>PDIK4DASEE: Predicate test failing when testing for number that has space around it
+
+ </LI>
+ <LI>PDIK4DBTZG: method="html" failing to esc non-ASCII chars in URI attributes via HTML 4.O Spec
+
+ </LI>
+ <LI>PDIK4DHUR4: <Option selected="selected"> not being output correctly for HTML output.
+
+ </LI>
+ <LI>PDIK4DHUVS: <? Processing Instructions?> not being not being terminated correctly for HTML output.
+
+ </LI>
+ <LI>PDIK4DJSE3: xsl:output method="xsl" not outputing proper xml header for result file
+
+ </LI>
+ <LI>PDIK4DJSKZ: omit-xml-declaration is not a recognize attribute for method="xml"
+
+ </LI>
+ <LI>PDIK4DRL8E: HTML DTD being output after initial data.
+
+ </LI>
+ <LI>PDIK4DRLCG: No error reporting of invalid use of disable-output-escaping
+
+ </LI>
+ <LI>PDIK4DSKP4: Included template w/higher priority not being instantiated
+
+ </LI>
+ <LI>PDIK4DVTJS: Marginal error reporting for toplevel elements with undefined namespaces.
+
+ </LI>
+ <LI>PDIK4E4KCL: Not allowed to have xsl:apply-imports within a xsl:for-each
+
+ </LI>
+ <LI>PDIK4E8L6L: <xsl:namespace-alias stylesheet-prefix="axsl" result-prefix="xsl"/> not working correctly
+
+ </LI>
+ <LI>PDIK4E8QBB: The expression in a use attribute on xsl:key should not restricted to return a node-set.
+
+ </LI>
+ <LI>PDIK4E8UHQ: Extend tests that use Javascript not running w/ latest js.jars
+
+ </LI>
+ <LI>PDIK4EBQWT: Processor crashes running example for embedded stylesheets from spec
+
+ </LI>
+ <LI>PDIK4ECQK3: Document() not creating a union when single argument is a nodeset.
+
+ </LI>
+ <LI>PDIK4ECTX7: NPE when passing document() a nodeset of 'doc' as second argument
+
+ </LI>
+ <LI>PDIK4ECVJJ: document("") does NOTrefer to the root node of the stylesheet
+
+ </LI>
+ <LI>PDIK4ED222: exclude-result-prefixes="ped bdd #default" not working with multiple prefixes
+
+ </LI>
+ <LI>PDIK4EF2FS: xml header being output all the time
+
+ </LI>
+ <LI>PDIK4EF2KL: Doctype declaration not output html/HTML when it's suppose to.
+
+ </LI>
+ <LI>PDIK4EKLX9: Attribute sets test atrs07, seems to be generating wrong output
+
+ </LI>
+ <LI>PDIK4EKNM8: Prop01 returns the value of system-property('xsl:version') as a string not a number
+
+ </LI>
+ <LI>PDIK4ELNRC: Outp tests 19,20,21,22,23 now failing to output xml headers w/ different encodings.
+
+ </LI>
+ <LI>PDIK4ELPBD: Document()'s error resources should be in XSLT not XPATH.
+
+ </LI>
+ <LI>PDIK4ELSE3: Entref01: value-of is not passing "&" thru to result output file.
+
+ </LI>
+ <LI>PDIK4ERPLJ: $x="foo" does not mean the same as not($x!="foo")
+
+ </LI>
+ <LI>PDIK4ESQA5: LRE attribute creation will include nodes with names in the XSLT namespace.
+
+ </LI>
+ <LI>PDIK4ESQEF: both forms of exclude-result-prefixes fail to suppress the default namespace - #default
+
+ </LI>
+ <LI>PDIK4ESTEB: exclude-result-prefixes, should not apply to any included/imported stylesheets
+
+ </LI>
+ <LI>PDIK4ETKTJ: Attribute value template does not parse.
+
+ </LI>
+ <LI>PDIK4ETPCT: xsl:element name attribute should generate error if result from the AVT is not a QName.
+
+ </LI>
+ <LI>PDIK4EUQN6: LRE with namespace prefixed QName attribute(ped:attr) does not pass attribute to result tree.
+
+ </LI>
+ <LI>PDIK4EYP2U: Parameters are not evaluated by XPATH expressions correctly.
+
+ </LI>
+ <LI>PDIK4F7PZC: Should we generate namespaces if it's set to ""
+
+ </LI>
+ <LI>PDIK4F7QUC: attribute name is accepting an invalid QName and "xmlns" as valid names.
+
+ </LI>
+ <LI>PDIK4F7TP5: Using sort with position() fails.
+ </LI>
+ <LI>PDIK4F8N4Y: <xsl:elements> elements are not getting copy of namespace nodes from element node.
+
+ </LI>
+ <LI>PDIK4F9L5Q: Problems with whitespace stripping in stylesheet.
+
+ </LI>
+ <LI>PDIK4F9PTP: Customer problem. Attempt to create DOM output w/o creating root node first, crashes.
+
+ </LI>
+ <LI>PDIK4F9QVX: URL encoding should escape the space character as '%20'.
+
+ </LI>
+ <LI>PDIK4FBMT8: document not sucking in a document of different encoding.
+
+ </LI>
+ <LI>PDIK4FHTUQ: The xml:space attributes are not stripped from the tree.
+
+ </LI>
+ <LI>PDIK4FJNZV: Using <xsl:output indent="yes"> exclusively within a stylesheet does not perform indent.
+
+ </LI>
+ <LI>PDIK4FJR54: xsl:number fails to generate proper result if xml file has comment before doc element
+
+ </LI>
+ <LI>PDIK4FPU6T: redirect doesn't create files relative to the output file
+
+ </LI>
+ <LI>PDIK4FXLWA: Stylesheet should hold memory about the liaison it should use
+
+ </LI>
+ <LI>PDIK4FXM2R: Problem with computation of opPos -= 3; in org/apache/xalan/xpath/dtm/DTMNodeLocator.java
+
+
+ </LI>
+ <LI>PDIK4FYPHX: document() in included .xsl is based on URI of including .xsl not included .xsl
+
+ </LI>
+ <LI>PDIK4FYSLG: "version" attribute on <xsl:stylesheet> is required.
+
+ </LI>
+ <LI>PDIK4G3TVT: Expansion of entity reference is hosing numbering.
+
+ </LI>
+ <LI>PDIK4G5NUY: xsl:output attribute 'indent' not indenting non-html elements.
+
+ </LI>
+ <LI>PDIK4G6MYB: From forum: German Umlauts (ISO-8859-1) are not output to result tree correctly.
+
+ </LI>
+ <LI>PDIK4GBR22: Attributes that contain CRLF, must output a character reference for CRLF
+
+ </LI>
+ <LI>PDIK4GBR5Z: Test for the preceding::* axes are broken
+
+ </LI>
+ <LI>PDIK4GBRM4: Intl01 Fails. It use to output entity references for the correctly for Big5 encoding.
+
+ </LI>
+ <LI>PDIK4GBTA7: Performance: Depth-first search enhancement.
+
+ </LI>
+ <LI>PDIK4GBTET: Performance: SaxAttributeImpl is tooooooooooo big.
+
+ </LI>
+ <LI>PDIK4GCLA7: Processing Instruction with in a for-each loop is not being totally ignored.
+
+ </LI>
+ <LI>PDIK4GCPRG: Atrs24: It's easy to generate an attribute of the form abc:xyz:Attr="blablabla"
+
+ </LI>
+ <LI>PDIK4GCRA9: xsl:copy-of not copying elements namespace nodes that are inherited from the parent.
+
+ </LI>
+ <LI>PDIK4GCT6V: xsl:copy: missing select attribute causes crash.
+
+ </LI>
+ <LI>PDIK4GHL4C: System w/default encoding of DP-2312 (DPK), is not being overridden to UTF-8.
+
+ </LI>
+ <LI>PDIK4GHMZA: Simple LRE stylesheet not processing the version attribute correctly
+
+ </LI>
+ <LI>PDIK4GHPZ7: Basic test of xsl:copy is failing.
+
+ </LI>
+ <LI>PDIK4GHQAQ: Failure of xsl:copy to copy attributes.
+
+ </LI>
+ <LI>PDIK4GHQTH: LRE01, stylesheet attribute extension-element-prefixes is broken
+
+ </LI>
+ <LI>PDIK4GHS8L: Need to integrate with xerces 1.0.2 w/ Sax support
+
+ </LI>
+ <LI>PDIK4GKQB2: Namespace axes is not implemented
+
+ </LI>
+ <LI>PDIK4GLUPM: Overwriting previously set attributes crashing in MutableAttrListImpl
+
+ </LI>
+ <LI>PDIK4GLUVU: Attributes set tests are failing in FormatterToXML
+
+ </LI>
+ <LI>PDIK4GMLVR: NPE: Caused by sending RTF out to the DOM.
+
+ </LI>
+ <LI>PDIK4GMSHL: Slct03 failing; adding attribute to <out> when it should'nt be.
+
+ </LI>
+ <LI>PDIK4GRMZ5: Failing to match a LocationPathPattern based on an IdKeyPattern.
+
+ </LI>
+ <LI>PDIK4GRQZX: Failing to match "attribute::*" in match pattern
+
+ </LI>
+ <LI>PDIK4GRR3Q: Failing to match "child::*" in match pattern
+
+ </LI>
+ <LI>PDIK4GSQK7: XSLT element-available function not working.
+
+ </LI>
+ <LI>PDIK4GSSF5: Makefiles; cleanup?; compile with g:none, removes debug code (opt/debug builds)
+
+ </LI>
+ <LI>PDIK4GZRHZ: Element from XSLT namespace may have any attribute not from XSLT namespace provided.....
+
+ </LI>
+ <LI>PDIK4H3QXA: Invalid attributes of the form x="x", without namespace URI are not being flagged as errors.
+
+ </LI>
+ <LI>PDIK4H3TNC: xsl:attribute will allow generation of null namespace nodes.
+
+ </LI>
+ <LI>RWER4GJQHK: showtree-19991008.xsl perf benchmark crashes
+
+ </LI>
+ <LI>RWER4GJUY3: Greek numbering crashes with array bounds exception with HTML output
+
+ </LI>
+ <LI>SBOG45UMEH: Tests 43, 34: Namespace handling in patterns seems to fail in XML4J2DOM liaison
+
+ </LI>
+ <LI>SBOG45UMVJ: Test62,63: XML4J2DOM: Dropped tag end (>)
+
+ </LI>
+ <LI>SBOG4FWN66: Problem with "//a" and large docs (Inconsistent Behavior Xalan v. XT and ODI Stylus)
+
+ </LI>
+ <LI>SBOG4FWNH2: StylesheetRoot creates wrong liaison if processor is not passed
+
+ </LI>
+ <LI>SBOG4G67ZU: Stylesheet serialization is broken
+
+ </LI>
+ <LI>SCUU4D9S36: Process.java does not check for errors in command line
+
+ </LI>
+ <LI>SCUU4ELPRP: TestThreads: running processors on multiple threads throws exceptions
+
+ </LI>
+ <LI>SCUU4ELRSG: Xalan's samples\pipe does not appear to work from end-user perspective
+
+ </LI>
+ <LI>SCUU4FER9P: Documentation typos/errors in Xalan 0.19.2 Overview, etc.
+
+ </LI>
+ <LI>SCUU4GBPDY: JVM crashes processing idky14 with XercesLiaison
+
+ </LI>
+ <LI>SCUU4GBPM4: DTM.java(1517) System.out.println("Not descendent..."); - should be if(DEBUG) or something
+
+ </LI>
+ <LI>SCUU4GBRB5: Placeholder: Move doc-related README, etc. files to new xdocs structure
+
+ </LI>
+ <LI>SCUU4GTSBS: TransformToDom sample throws exception; build xalan_0_19_5
+
+ </LI>
+ </UL>
+</FONT></TD></TR></TABLE><BR>
+
+<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Bugs closed since the last Xalan version</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resourc
es/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <P>The following are Closed bugs (not really a bug; no longer applicable; etc.):</P>
+ <UL>
+ <LI>DMAN465KYD: Demo page exposes possible timing issues
+
+ </LI>
+ <LI>DMAN46RS8G: Attribute-sets not interacting well
+
+ </LI>
+ <LI>DMAN4EFUYU: decimal-format pattern-separator setting has no effect
+
+ </LI>
+ <LI>DMAN4G5TLR: xsl:number assumption of separators is no longer correct
+
+ </LI>
+ <LI>DMAN4GBQTW: Null string should be a substring of itself; "contains" function defect
+
+ </LI>
+ <LI>PDIK47NLGY: xsl:stylesheet is not synonymous with xsl:transform
+
+ </LI>
+ <LI>PDIK4D2JFT: <xsl:text disable-output-escaping="yes"> not working with <xsl:output method=html>
+
+ </LI>
+ <LI>SBOG45VNAM: uri() function doesn't take into account the base uri of the stylesheet.
+
+ </LI>
+ </UL>
+</FONT></TD></TR></TABLE><BR>
+
<A name="bugs"><!--anchor--></A>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Known bugs</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" w
idth="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
- <P>We are aware of the following bugs (SPR ID# and description):</P>
- <UL>
-<LI>SCUU4EMMUC ValidateXPath sample throws exception with illegal xpath<BR><BR></LI>
-<LI>PDIK4ERNDJ Errors messages are overly verbose, can they be simplified.<BR><BR></LI>
-<LI>PDIK4ERPLJ $x="foo" does not mean the same as not($x!="foo")<BR><BR></LI>
-<LI>DMAN4ESS98 Sort with data-type="number" should only rearrange numbers.<BR><BR></LI>
-<LI>PDIK4ESTEB exclude-result-prefixes, should not apply to any included/imported stylesheets<BR><BR></LI>
-<LI>DMAN4ETPTK case-order attribute apparently ignored in xsl:sort<BR><BR></LI>
-<LI>PDIK4ETKTJ Attribute value template does not parse.<BR><BR></LI>
-<LI>PDIK4ETPCT xsl:element name attribute should generate error if result from the AVT is not a QName.<BR><BR></LI>
-<LI>PDIK4EUNA6 "xsl:element" created element does not acquire namespace prefixes from stylesheet.<BR><BR></LI>
-<LI>PDIK4EUQN6 LRE with namespace prefixed QName attribute(ped:attr) does not pass attribute to result tree.<BR><BR></LI>
-<LI>PDIK4EYP2U Parameters are not evaluated by XPATH expressions correctly.<BR><BR></LI>
-<LI>PDIK4F7PZC Should we generate namespaces if it's set to ""<BR><BR></LI>
-<LI>PDIK4F7QUC attribute name is accepting an invalid QName and "xmlns" as valid names.<BR><BR></LI>
-<LI>PDIK4F7TP5 Using sort with position() fails.<BR><BR></LI>
-<LI>PDIK4F8N4Y "xsl:elements" elements are not getting copy of namespace nodes from element node.<BR><BR></LI>
-<LI>PDIK4F9L5Q Problems with whitespace stripping in stylesheet.<BR><BR></LI>
-<LI>PDIK4F9PTP Customer problem. Attempt to create DOM output w/o creating root node first, crashes.<BR><BR></LI>
-<LI>PDIK4F9QVX URL encoding should escape the space character as '%20'.<BR><BR></LI>
-<LI>PDIK4FBMT8 document not extracting a document with different encoding.<BR><BR></LI>
-<LI>DMAN4FEPC5 Some xsl:sort attributes must reject bad keyword values<BR><BR></LI>
-<LI>DMAN4FERJ3 Number format patterns should act the same whether 1 or 2 patterns<BR><BR></LI>
-<LI>DMAN4FFQBJ Need correct URL in system-property<BR><BR></LI>
-<LI>SCUU4ELPVP Performance: XT is often faster than LotusXSL<BR><BR></LI>
- </UL>
- <P>The format-number function sometimes behaves incorrectly when the second argument (pattern-string) has two sub-patterns for positive and negative numbers. You may find that you do not get a minus sign on negative numbers. You can either avoid using the second pattern or insert a literal minus sign at the front of the second pattern. If you choose the latter, you will have to re-edit the pattern when we fix the problem. There may also be incorrect behavior if you set the zer0-digit to a different character.</P>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Known bugs in the current Xalan version</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="res
ources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <P>We are aware of the following bugs in the current version 0.20.0:</P>
+ <UL>
+ <LI>DMAN4DXQLE: Mistaken use of I instead of or causes crash
+
+ </LI>
+ <LI>DMAN4FERJ3: Number format patterns should act the same whether 1 or 2 patterns
+
+ </LI>
+ <LI>DMAN4FQJZ8: Need better argument checking for xsl:key
+
+ </LI>
+ <LI>DMAN4FQK9Z: Should flag two xsl:key keyspaces with same name
+
+ </LI>
+ <LI>DMAN4FUSQ6: Handling of null strings by contains() is not consistent across JDKs
+
+ </LI>
+ <LI>DMAN4FVS7S: Using defined constants from instance variables in switch fails in some compilers
+
+ </LI>
+ <LI>DMAN4FYS5A: Need better JavaDoc for XObject and subclasses
+
+ </LI>
+ <LI>DMAN4GBR4Z: Need nicer format to render zero as roman numeral
+
+ </LI>
+ <LI>DMAN4GBR8W: last() should insist on zero arguments
+
+ </LI>
+ <LI>DMAN4GKRZ3: Certain match patterns involving id() don't work
+
+ </LI>
+ <LI>DMAN4GLT3L: xsl:when test="" should have a specific error message
+
+ </LI>
+ <LI>DMAN4GLTN7: xsl:sort should reject all child elements
+
+ </LI>
+ <LI>DMAN4GRPXQ: Need specific error for xsl:stylesheet (or transform) not used as top-level element
+
+ </LI>
+ <LI>DMAN4GRQXY: Infinite-loop detection is not working for apply-templates with modes
+
+ </LI>
+ <LI>DMAN4GRRP6: Bad error message for elements inside xsl:decimal-format
+
+ </LI>
+ <LI>DMAN4GRS4C: Single-character attributes should raise an error when value is set longer
+
+ </LI>
+ <LI>DMAN4GRSQW: Invalid value for letter-value attribute in xsl:number should raise an error
+
+ </LI>
+ <LI>DMAN4GRTJS: Attributes count and from of xsl:number should have an error when value is not a pattern
+
+ </LI>
+ <LI>DMAN4GYUGL: Performance: should avoid calls to mult when we already know the outcome
+
+ </LI>
+ <LI>DMAN4H2RE6: namespace::xmlns not recognized as special
+
+ </LI>
+ <LI>DMAN4H3VML: Attribute values fail to override in DOM scenario
+
+ </LI>
+ <LI>DMAN4H429H: Torture test of format-number obtains garbage
+
+ </LI>
+ <LI>PDIK4D2JP5: Escaping of attribute quotes wasn't being done correctly when method="html".
+
+ </LI>
+ <LI>PDIK4D2JPR: Equality comparisons with nodesets and other nodesets, strings, and numbers not to spec.
+
+ </LI>
+ <LI>PDIK4DJS4Q: cdata-section-elements not outputing literal result element correctly
+
+ </LI>
+ <LI>PDIK4DRPKM: Use of 9/5 in a xpath expression generates a cryptic error message
+
+ </LI>
+ <LI>PDIK4E6MR3: Concat() does not check for number of arguments.
+
+ </LI>
+ <LI>PDIK4E6NZE: Stylesheet should not contain more then 1 template with the same name.
+
+ </LI>
+ <LI>PDIK4ERNDJ: Errors messages are overly verbose. Simplify where possible.
+
+ </LI>
+ <LI>PDIK4EUNA6: "xsl:element" created element does not acquire namespace prefixes from stylesheet.
+
+ </LI>
+ <LI>PDIK4FXM49: Stylesheets need to use Externalizable instead of Serializable
+
+ </LI>
+ <LI>PDIK4G5P7U: command line interface with -tt option does not output mention of built-in template for text nodes.
+
+ </LI>
+ <LI>PDIK4GBTCQ: Performance: Space stripping taking too long
+
+ </LI>
+ <LI>PDIK4GBTDY: Performance: Attributes are taking a long time to return from the DTM
+
+ </LI>
+ <LI>PDIK4GSRAB: element-available crashes if namespace prefix can not be resolved
+
+ </LI>
+ <LI>PDIK4GTR77: function-available fails if lxslt:component is not in stylesheet.
+
+ </LI>
+ <LI>PDIK4GTS2Z: function-available and element-available do not work for XSLT/XPATH components.
+
+ </LI>
+ <LI>PDIK4GTS6H: function-available crashes if namespace prefix can not be resolved
+
+ </LI>
+ <LI>SBOG4G5JCF: Need to be able to choose stylesheet via media="xxx" and type="text/xslt"
+
+ </LI>
+ <LI>SBOG4G5JF3: Need ability to do more than one XML per command line
+
+ </LI>
+ <LI>SCUU4ELPVP: Performance: XT is often faster than LotusXSL
+
+ </LI>
+ <LI>SCUU4EMMUC: ValidateXPath sample throws exception with illegal xpath
+
+ </LI>
+ <LI>SCUU4GBPJ5: org.apache.xalan.xslt.Process does not resource all strings
+
+ </LI>
+ <LI>SCUU4H3R39: [linux] JVM crashes processing lre01 (attribute in xsl namespace); all other tests run
+
+ </LI>
+ </UL>
</FONT></TD></TR></TABLE><BR>
</FONT></TD></TR></TABLE><BR>
@@ -158,13 +819,18 @@
example. Be sure xalan.jar and xerces.jar are on the class path. To recompile (and run!) the class files in the
Servlet subdirectory, the javax.servlet and javax.servlet.http packages must also be on the class path. Sun
distributes these packages in the JSWDK 1.0.1 servlet.jar file.</P>
- <P>After recompiling a sample, you can use the Sun jar utility to place your new .class files in
+ <P>After recompiling a sample, you can use the Sun jar utility to place your new .class files in
xalansamples.jar.</P>
</FONT></TD></TR></TABLE><BR><A name="doc"><!--anchor--></A>
<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Rebuilding the Xalan documentation</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/
void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
<P>Xalan includes a number of XML source files, XSL stylesheets, document type definition (DTD)
files, entity relationship (ENT) files, graphics, and a JavaScript file that provide the input for the Xalan
HTML User's Guide, and the overview and package-level documents used during the generation of Javadoc.</P>
+ <P>To rebuild the documentation, you must use the JDK 1.2.2 java and javadoc tools. If the JDK 1.2.2 bin and lib
+ directories are not on your class path, you can edit the make.include file in the Xalan root directory so the make file
+ can find the JDK 1.2.2 java and javadoc tools. You can also include java and javadoc arguments on the make file command
+ line. See the make.include file for the details.</P>
+
<P>To generate the Xalan HTML User's Guide, run the Xalan make file in the Xalan xdocs directory:<BR><BR>
<CODE><FONT face="courier, monospaced">make stylebook</FONT></CODE></P>
<P>To generate Xalan API documentation, set up the make file to use the Javadoc tool in the Java JDK 1.2.2 bin
@@ -179,7 +845,7 @@
<P>If you want to rebuild the documentation without using the GNU build environment, keep the following in
mind:</P>
<UL>
- <LI>Be sure stylebook-1.0-b1.jar, xalan.jar, bsf.jar, bsfengines.jar, and xerces.jar are on the class
+ <LI>Be sure stylebook-1.0-b2.jar, xalanjdoc.jar, xalan.jar, bsf.jar, bsfengines.jar, and xerces.jar are on the class
path.<BR><BR></LI>
<LI>To build doc in a build/docs subdirectory, run StyleBook from the xdocs directory as follows:<BR><BR>
<CODE><FONT face="courier, monospaced">java org.apache.stylebook.StyleBook "targetDirectory=../build/docs/" sources/xalanLocal.xml style</FONT></CODE>
@@ -190,7 +856,8 @@
<LI>Before you run javadoc, make sure the following directory structure exists under the Xalan root
directory: build/docs/apidocs.<BR><BR></LI>
<LI>To build the API documentation, run the JDK 1.2.2 javadoc tool from the xdocs directory:<BR><BR>
-<CODE><FONT face="courier, monospaced">javadoc -overview ../src/javadocOverview.html -sourcepath ../src org.apache.xalan.xpath org.apache.xalan.xpath.xdom org.apache.xalan.xpath.dtm org.apache.xalan.xpath.xml org.apache.xalan.xslt org.apache.xalan.xslt.trace org.apache.xalan.xslt.client org.apache.xalan.xslt.extensions -windowtitle Xalan -d ../build/docs/apidocs</FONT></CODE></LI>
+<CODE><FONT face="courier, monospaced">-doclet xalanjdoc.Standard -public -overview ../src/javadocOverview.html -sourcepath ../src -group "XSLT Packages" "org.apache.xalan.xslt*" -group "XPath Packages" "org.apache.xalan.xpath*" org.apache.xalan.xpath org.apache.xalan.xpath.xdom org.apache.xalan.xpath.dtm org.apache.xalan.xpath.xml org.apache.xalan.xslt org.apache.xalan.xslt.trace org.apache.xalan.xslt.client org.apache.xalan.xslt.extensions -windowtitle Xalan -d ../build/docs/apidocs
+</FONT></CODE></LI>
</UL>
</FONT></TD></TR></TABLE><BR>
</FONT></TD></TR></TABLE><BR><A name="contact"><!--anchor--></A>
1.4 +23 -12 xml-site/targets/xalan/samples.html
Index: samples.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/samples.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- samples.html 2000/03/03 15:48:47 1.3
+++ samples.html 2000/03/07 16:49:57 1.4
@@ -50,7 +50,8 @@
<LI><A href="#transformtodom">TransformToDom</A></LI>
<LI><A href="#usestylesheetparam">UseStylesheetParam</A></LI>
<LI><A href="#xpath">ApplyXPath</A></LI>
-<LI><A href="#pipe">Pipe (SAX)</A></LI>
+<LI><A href="#pipe">Pipe</A></LI>
+<LI><A href="#sax">PureSAX</A></LI>
<LI><A href="#extensions">Extensions</A></LI>
<LI><A href="#appletxmltohtml">AppletXMLtoHTML</A></LI>
<LI><A href="#servlet">Servlet</A></LI>
@@ -101,8 +102,10 @@
<P>where <I>param</I> is the stylesheet parameter (a string of your choice).</P>
</FONT></TD></TR></TABLE><BR><A name="xpath"><!--anchor--></A>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>ApplyXPath</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vsp
ace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P>What it does: The ApplyXPath class executes an XPath expression against an XML document and returns
- information about the route it takes and the nodes (if any) it finds.</P>
+ <P>What it does: The ApplyXPath class uses the XPathAPi class to execute an XPath expression against an XML document
+ and returns the nodes (if any) it finds. XPathAPI contains some convenience methods for using XPath expressions to return
+ single Nodes, NodeLists, and XObjects. In the future, we plan to incorporate user feedback and move these methods into the
+ core API.</P>
<TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I>You can use this sample as an aid when you want to find out what a given XPath expression returns from a
given XML file. Keep in mind that the context node (base point of evaluation) for the XPath expression is the document
root.</I></FONT></TD></TR></TABLE>
@@ -114,8 +117,10 @@
<P><CODE><FONT face="courier, monospaced">java ApplyXPath foo.xml /</FONT></CODE></P>
<P>and</P>
<P><CODE><FONT face="courier, monospaced">java ApplyXPath foo.xml /doc/name/@first</FONT></CODE></P>
+ <P>If you are interested in the API for executing XPath expressions, we suggest you take a look at the methods in XPathAPI,
+ and send us feedback on what best meets your needs.</P>
</FONT></TD></TR></TABLE><BR><A name="pipe"><!--anchor--></A>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Pipe (SAX)</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vsp
ace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Pipe</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0
" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<P>What it does: The Pipe class uses the output of the first transformation as input to a second
transformation.</P>
<P>The first transformation produces a sequence of SAX events which the second transformation processes with
@@ -123,8 +128,13 @@
for the entire result tree to be constructed (as the DOM consumer must do).</P>
<P>Run this sample from the Pipe subdirectory with</P>
<P><CODE><FONT face="courier, monospaced">java Pipe</FONT></CODE></P>
- <P>For other examples using the SAX document handler, see <A href="getstarted.html#sax">Generating and
- responding to SAX events</A>.</P>
+ <P>For other examples using the SAX document handler, see the next section and <A href="getstarted.html#sax">Generating and responding to SAX events</A>.</P>
+ </FONT></TD></TR></TABLE><BR><A name="sax"><!--anchor--></A>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>PureSAX</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace
="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <P>What it does: The PureSAX class uses SAX DocumentHandlers and the Xerces SAX parser to produce a stylesheet tree,
+ an XML input tree, and the transformation result tree.</P>
+ <P>Run this sample from the PureSax subdirectory with</P>
+ <P><CODE><FONT face="courier, monospaced">java PureSAX</FONT></CODE></P>
</FONT></TD></TR></TABLE><BR><A name="extensions"><!--anchor--></A>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Extensions</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vsp
ace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<P>The extensions subdirectory contains four samples with Xalan extensions. Two of the samples use
@@ -140,13 +150,13 @@
<P>Run these samples from the extensions directory as follows (each of the following is a single command
line):</P>
- <P><CODE><FONT face="courier, monospaced">java org.apache.xslt.xalan.Process -in 1basicJscript</FONT></CODE>
+ <P><CODE><FONT face="courier, monospaced">java org.apache.xalan.xslt.Process -in 1basicJscript</FONT></CODE>
<BR> <CODE><FONT face="courier, monospaced">-xsl 1basicJscript</FONT></CODE></P>
- <P><CODE><FONT face="courier, monospaced">java org.apache.xslt.xalan.Process -in 2java-namespace.xml</FONT></CODE>
+ <P><CODE><FONT face="courier, monospaced">java org.apache.xalan.xslt.Process -in 2java-namespace.xml</FONT></CODE>
<BR> <CODE><FONT face="courier, monospaced">-xsl 2java-namespace.xsl</FONT></CODE></P>
- <P><CODE><FONT face="courier, monospaced"> java org.apache.xslt.xalan.Process -in 3numlistJava.xml</FONT></CODE>
+ <P><CODE><FONT face="courier, monospaced"> java org.apache.xalan.xslt.Process -in 3numlistJava.xml</FONT></CODE>
<BR> <CODE><FONT face="courier, monospaced">-xsl 3numlistJava.xsl</FONT></CODE></P>
- <P><CODE><FONT face="courier, monospaced"> java org.apache.xslt.xalan.Process -in 4numlistJcript.xml </FONT></CODE>
+ <P><CODE><FONT face="courier, monospaced"> java org.apache.xalan.xslt.Process -in 4numlistJcript.xml </FONT></CODE>
<BR> <CODE><FONT face="courier, monospaced">-xsl 4numlistJscript.xsl</FONT></CODE></P>
</FONT></TD></TR></TABLE><BR><A name="appletxmltohtml"><!--anchor--></A>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>AppletXMLtoHTML</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif
" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
@@ -167,8 +177,9 @@
</OL>
<P>Examples:</P>
<DL>
-<DT>http://localhost/servlet/DefaultApplyXSL?URL=/data.xml&xslURL=/style.xsl</DT>
-<DD>...applies the style.xsl stylesheet to the data.xml data. Both files are
+<DT>http://localhost/servlet/DefaultApplyXSL?URL=/data.xml&xslURL=
+/style.xsl</DT>
+<DD>...applies the style.xsl stylesheet to the data.xml data. Both files are<BR>
served from the Web server's HTTP XSLTInputSource root.<BR><BR></DD>
<DT>http://localhost/servlet/DefaultApplyXSL?URL=/data.xml&xslURL=
/style.xsl&debug=true</DT>
1.5 +6 -2 xml-site/targets/xalan/usagepatterns.html
Index: usagepatterns.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/usagepatterns.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- usagepatterns.html 2000/03/03 15:48:47 1.4
+++ usagepatterns.html 2000/03/07 16:49:57 1.5
@@ -249,10 +249,14 @@
intermedResult);
}
}</PRE></FONT></TD><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
-<P>For a more compact (and elegant) form of this example, see the <A href="samples.html#pipe">Pipe</A>.</P>
+<P>For a more compact (and elegant) form of this example, see the <A href="samples.html#pipe">Pipe</A>. For an example that uses SAX DocumentHandlers and the Xerces SAX parser to parse the XML input and XSL stylesheet and produce the transformation result, see the <A href="samples.html#sax">PureSAX</A>.</P>
</FONT></TD></TR></TABLE><BR><A name="xpath"><!--anchor--></A>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Working with XPath expressions</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resourc
es/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
-<P>XSL stylesheets use XPath expressions to select nodes, specify conditions, and generate text for the result tree. XPath provides an API that you can call directly. For example, you may want to select nodes programatically and do your own processing without a stylesheet. For an example that executes individual XPath expressions against XML source files, see <A href="samples.html#xpath">ApplyXPath</A>.</P>
+<P>XSL stylesheets use XPath expressions to select nodes, specify conditions, and generate text for the result tree. XPath provides an API that you can call directly. For example, you may want to select nodes programatically and do your own processing without a stylesheet.</P>
+<P>The XPathAPI class, in the samples/ApplyXPath subdirectory, contains several convenience methods that you can use to return single DOM Nodes, NodeLists, and XObjects. In the future, we plan to incorporate user feedback and move these methods into the core API.</P>
+<P>If you are interested in the API for executing XPath expressions, we suggest you take a look at the methods in XPathAPI,
+and send us feedback on what best meets your needs.</P>
+<P>For an example that uses the XPathAPI convenience methods to execute XPath expressions against XML source files, see <A href="samples.html#xpath">ApplyXPath</A>.</P>
</FONT></TD></TR></TABLE><BR><A name="applet"><!--anchor--></A>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using the Xalan applet wrapper</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resourc
es/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<OL>