You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by dl...@apache.org on 2001/08/09 22:10:37 UTC
cvs commit: xml-xalan/c/xdocs/sources/xalan extensionslib.xml history.xml index.xml readme.xml resources.xml samples.xml usagepatterns.xml
dleslie 01/08/09 13:10:36
Modified: c/xdocs/sources entities.ent xalan.xml xalanLocal.xml
c/xdocs/sources/xalan history.xml index.xml readme.xml
resources.xml samples.xml usagepatterns.xml
Added: c/xdocs/sources/xalan extensionslib.xml
Log:
Preliminary updates for Xalan-C 1.2
Revision Changes Path
1.19 +7 -7 xml-xalan/c/xdocs/sources/entities.ent
Index: entities.ent
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/entities.ent,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- entities.ent 2001/08/08 21:27:33 1.18
+++ entities.ent 2001/08/09 20:10:36 1.19
@@ -1,13 +1,13 @@
<?xml encoding="US-ASCII"?>
<!ENTITY xslt4c "Xalan-C++">
-<!ENTITY xslt4c-dist "Xalan-C_1_3">
-<!ENTITY xslt4c-current "Xalan-C++ version 1.3">
+<!ENTITY xslt4c-dist "Xalan-C_1_2">
+<!ENTITY xslt4c-current "Xalan-C++ version 1.2">
<!ENTITY xslt4c-windlls "DOMSupport.dll, PlatformSupport.dll, XalanDOM.dll, XalanSourceTree,dll, XercesParserLiaison.dll, XMLSupport.dll, XPath.dll, XSLT.dll, XalanTransformer.dll">
-<!ENTITY xslt4c-linuxlib "libxalan-c1_3.so">
-<!ENTITY xslt4c-aixlib "libxalan-c1_3.a">
-<!ENTITY xslt4c-hplib "libxalan-c1_3.sl">
-<!ENTITY xslt4c-solarislib "libxalan-c1_3.so">
+<!ENTITY xslt4c-linuxlib "libxalan-c1_2.so">
+<!ENTITY xslt4c-aixlib "libxalan-c1_2.a">
+<!ENTITY xslt4c-hplib "libxalan-c1_2.sl">
+<!ENTITY xslt4c-solarislib "libxalan-c1_2.so">
<!ENTITY xml4c "Xerces-C++">
<!ENTITY xml4c-used "Xerces-C++ version 1.5.1">
<!ENTITY xml4c-windll "xerces-c_1_5_1.dll">
@@ -17,7 +17,7 @@
<!ENTITY xml4c-hplib "libxerces-c1_5_1.sl">
<!ENTITY xml4c-solarislib "libxerces-c1_5_1.so">
<!ENTITY xslt4j "Xalan-Java">
-<!ENTITY icu-used "International Components for Unicode(ICU) 1.6 source files">
+<!ENTITY icu-used "International Components for Unicode(ICU) 1.8.1 source files">
<!ENTITY icu-windlls "icui18n.dll, icuuc.dll">
<!ENTITY icubridge-win "ICUBridge.dll">
<!ENTITY done SYSTEM "xalan/DONE">
1.8 +4 -5 xml-xalan/c/xdocs/sources/xalan.xml
Index: xalan.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- xalan.xml 2001/02/15 16:45:05 1.7
+++ xalan.xml 2001/08/09 20:10:36 1.8
@@ -58,7 +58,7 @@
* <http://www.apache.org/>.
-->
-<book title="Xalan-C++ XSLT User's Guide" copyright="2000 The Apache Software Foundation">
+<book title="Xalan-C++ XSLT User's Guide" copyright="2001 The Apache Software Foundation">
<resources source="sbk:/sources/xalan/resources.xml"/>
@@ -67,7 +67,7 @@
<separator/>
<document id="index"
- label="Xalan-C++ 1.1"
+ label="Xalan-C++ 1.2"
source="xalan/index.xml"/>
<separator/>
@@ -114,7 +114,7 @@
<document id="extensions"
label="Extensions"
source="xalan/extensions.xml"/>
-
+ <document id="extensionslib" label="Extensions Library" source="xalan/extensionslib.xml"/>
<separator/>
<document id="readme"
@@ -123,8 +123,7 @@
<separator/>
-<external href="http://xml.apache.org/bugs/"
- label="Bug reporting"/>
+<external href="readme.html#bugs" label="Bugs"/>
<external href="http://xml.apache.org/xalan-j/test/run.html#how-to-run-c"
label="Testing"/>
1.5 +3 -3 xml-xalan/c/xdocs/sources/xalanLocal.xml
Index: xalanLocal.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalanLocal.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- xalanLocal.xml 2001/02/15 16:45:06 1.4
+++ xalanLocal.xml 2001/08/09 20:10:36 1.5
@@ -58,7 +58,7 @@
* <http://www.apache.org/>.
-->
-<book title="Xalan-C++ XSLT User's Guide" copyright="2000 The Apache Software Foundation">
+<book title="Xalan-C++ XSLT User's Guide" copyright="2001 The Apache Software Foundation">
<resources source="sbk:/sources/xalan/resources.xml"/>
@@ -103,7 +103,7 @@
<document id="extensions"
label="Extensions"
source="xalan/extensions.xml"/>
-
+ <document id="extensionslib" label="Extensions Library" source="xalan/extensionslib.xml"/>
<separator/>
<document id="readme"
@@ -112,7 +112,7 @@
<separator/>
- <external href="http://xml.apache.org/bugs/" label="Bug reporting"/>
+ <external href="readme.html#bugs" label="Bugs"/>
<external href="http://xml.apache.org/xalan-j/test/run.html#how-to-run-c" label="Testing"/>
1.3 +3 -3 xml-xalan/c/xdocs/sources/xalan/history.xml
Index: history.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/history.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- history.xml 2001/06/12 13:08:18 1.2
+++ history.xml 2001/08/09 20:10:36 1.3
@@ -1,4 +1,4 @@
-<s3 title="Changes since &xslt4c; version 1.0">
+<s3 title="Changes for &xslt4c; version 1.1">
<p>In addition to adding to the list of platforms on which &xslt4c; builds, our focus for this release has been on bug fixes, performance enhancements,
and providing a simplified C++ and C API for performing standard transformations. Major updates since version 1.0 include:</p>
<ul>
@@ -30,7 +30,7 @@
recognize.</li>
</ul>
</s3>
-<s3 title="Changes since &xslt4c; version 0.40.0">
+<s3 title="Changes for &xslt4c; version 1.0">
<p>Major updates since version 0.40.0 include:</p>
<ul>
<li>Full support for namespace handling<br/><br/></li>
@@ -40,7 +40,7 @@
<li>Support for the output encoding attribute</li>
</ul>
</s3>
-<s3 title="Changes since &xslt4c; version 0.30.0">
+<s3 title="Changes for &xslt4c; version 0.40.0">
<p>Major updates since version 0.30.0 include:</p>
<ul>
<li>Permitting OS file names (as well as URLs) as command-line arguments with TestXSLT<br/><br/></li>
1.24 +2 -3 xml-xalan/c/xdocs/sources/xalan/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/index.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- index.xml 2001/02/15 16:45:09 1.23
+++ index.xml 2001/08/09 20:10:36 1.24
@@ -65,9 +65,8 @@
document types.</p>
<p>&xslt4c-current; is a robust implementation of the W3C Recommendations
for XSL Transformations (XSLT) and the XML Path Language (XPath). It includes a compatible release of the
- &xml4c; XML parser: &xml4c-used;. In addition to adding builds for HP-UX 11 and Solaris, the focus for this release
- is on bug fixes, performance enhancements, providing a simpler C++ and C API for performing standard transformations, and new samples.
- For the details, see the <link idref="readme">Release Notes</link>.</p>
+ &xml4c; XML parser: &xml4c-used;. The focus for this release is on bug fixes, performance enhancements, new
+ samples, and a preliminary set of extension functions. For the details, see the <link idref="readme">Release Notes</link>.</p>
</s2>
<s2 title="How do I get it?">
1.26 +21 -7 xml-xalan/c/xdocs/sources/xalan/readme.xml
Index: readme.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/readme.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- readme.xml 2001/06/12 13:08:20 1.25
+++ readme.xml 2001/08/09 20:10:36 1.26
@@ -2,7 +2,6 @@
<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd"[
<!ENTITY done-c SYSTEM "DONE">
<!ENTITY status-c SYSTEM "STATUS">
-<!ENTITY bugs-c SYSTEM "BUGS">
<!ENTITY history-c SYSTEM "history.xml">]>
<!--
@@ -74,16 +73,31 @@
<ul>
<li><link anchor="done">Changes since &xslt4c; version 1.1</link></li>
<li><link anchor="bugs">Bug reporting</link></li>
- <li><link anchor="xml4j">Version of &xml4c; to use</link></li>
+ <li><link anchor="xml4c">Version of &xml4c; to use</link></li>
<li><link anchor="to-do">To-do tasks for future &xslt4c; releases</link></li>
</ul>
<anchor name="done"/>
- &done-c;
+ <s3 title="Changes since &xslt4c; version 1.1">
+ <p>TO BE ADDED</p>
+ <ul>
+ <li>Extension functions</li>
+ <li></li>
+ <li></li>
+ <li></li>
+ </ul>
+ </s3>
<anchor name="bugs"/>
- &bugs-c;
- <anchor name="xml4j"/>
- &status-c;
-
+ <s3 title="Bug reporting">
+ <p>All known &xslt4c; bugs are listed in <resource-ref idref="bugzilla"/>. For a list of open bugs with links to each bug
+ report, see <resource-ref idref="buglist"/>. If you find a new bug, please enter a XalanC bug report in this
+ database.</p>
+ <note>Before you can enter your first bug report, you must submit your email address to Bugzilla and receive a password.</note>
+ <p>We strongly encourage you write patches for problems you find and submit them to
+ xalan-dev@xml.apache.org. We review the patches we receive to make sure they do not break something else, and (assuming they
+ do not) include them in our next release. In the interest of fixing bugs, adding enhancements, and addressing outstanding design
+ issues, we sincerely want (and need!) your active participation in the ongoing development of Xalan.</p>
+ </s3><anchor name="xml4c"/>
+ &status-c;
</s2><anchor name="build"/>
<s2 title="Build Notes">
<ul>
1.13 +8 -0 xml-xalan/c/xdocs/sources/xalan/resources.xml
Index: resources.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/resources.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- resources.xml 2001/02/16 21:41:49 1.12
+++ resources.xml 2001/08/09 20:10:36 1.13
@@ -48,5 +48,13 @@
<resource id="dpawsonxslfaq" title="XSL Frequently Asked Questions" location="http://www.dpawson.co.uk/xsl/xslfaq.html"/>
<human-resource id="xalandev" name="Xalan Development Mailing List" mailto="xalan-dev@xml.apache.org"/>
+
+ <resource id="bugzilla"
+ title="Bugzilla (the Apache bug database)"
+ location="http://nagoya.apache.org/bugzilla"/>
+ <resource id="buglist"
+ title="XalanC open bugs"
+ location="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=XalanC&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&cmdtype=doit&order=Reuse+same+sort+as+last+time"/>
+
</resources>
1.28 +32 -18 xml-xalan/c/xdocs/sources/xalan/samples.xml
Index: samples.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/samples.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- samples.xml 2001/06/08 19:22:02 1.27
+++ samples.xml 2001/08/09 20:10:36 1.28
@@ -64,11 +64,13 @@
<li><link anchor="simpletransform">SimpleTransform</link></li>
<li><link anchor="streamtransform">StreamTransform</link></li>
<li><link anchor="usestylesheetparam">UseStylesheetParam</link></li>
+ <li><link anchor="xalantransformercallback">XalanTransformerCallback</link></li>
<li><link anchor="tracelisten">TraceListen</link></li>
<li><link anchor="compilestylesheet">CompileStylesheet</link></li>
<li><link anchor="documentbuilder">DocumentBuilder</link></li>
<li><link anchor="threadsafe">ThreadSafe</link></li>
<li><link anchor="xpathwrapper">XPathWrapper</link></li>
+ <li><link anchor="simplexpathapi">SimpleXPathAPI</link></li>
<li><link anchor="externalfunctions">ExternalFunctions</link></li>
<li><link anchor="apachemodulexslt">ApacheModuleXSLT</link></li>
</ul>
@@ -129,7 +131,17 @@
as a single argument. For example:</p>
<p><code>UseStylesheetParam param1 "'hello out there'"</code></p>
<p>See also: <link idref="usagepatterns" anchor="params">Setting stylesheet parameters</link>.</p>
- </s2><anchor name="tracelisten"/>
+ </s2><anchor name="xalantransformercallback"/>
+ <s2 title="XalanTransformerCallback">
+ <p>What it does: it returns transformation output in blocks to a callback function, which writes the output to a file.
+ This sample illustrats the use of a callback function to incrementally process a transformation result, that is to begin
+ working with the transformation result before the transformation has beeen completed. See <link idref="usagepatterns"
+ anchor="incremental">Processing output incrementally</link>.</p>
+ <p>You can run it from the XalanTransformerCallback subdirectory with</p>
+ <p><code>XalanTransformerCallback foo.xml foo.xsl [foo.out]</code></p>
+ <note>If you omit the third argument, the transformation result is written to the screen.</note>
+ </s2>
+ <anchor name="tracelisten"/>
<s2 title="TraceListen">
<p>What it does: Trace events during a transformation; the transformation uses birds.xsl to transform birds.xml and writes the
output to birds.out.</p>
@@ -188,6 +200,8 @@
<p>See also: <link idref="usagepatterns" anchor="compiled">Compiling stylesheets</link>.</p>
</s2><anchor name="xpathwrapper"/>
<s2 title="XPathWrapper">
+ <note>For a more streamlined sample that uses the XPathEvaluator interface, see
+ <link anchor="simplexpathapi">SimpleXPathAPI</link>.</note>
<p>This sample uses an executable (TestDriver in Windows, XPathWrapper in Linux and AIX), and two classes: XPathWrapper and
XPathWrapperImp.</p>
<p>What it does: The executable passes XPathWrapper an XML file name, a context node location path, and an XPath
@@ -195,12 +209,18 @@
XPath expression from specified context node in the XML document and returns the nodes it finds (if any).</p>
<note>You can use this sample as an aid when you want to find out what a given XPath expression returns from a
given context node in an XML file.</note>
- <p>Run this sample from the XPathWrapper subdirectory with</p>
- <p>Windows:<br/>
- <code>TestDriver <ref>XMLFile ContextNode XPathExpression</ref></code></p>
- <p>UNIX:<br/>
- <code>XPathWrapper <ref>XMLFile ContextNode XPathExpression</ref></code></p>
- <p>where <ref>XMLFile</ref> is an XML source file, <ref>ContextNode</ref> is the location path to the context
+ <p>Run this sample from the XPathWrapper subdirectory with the same command line arguments described for <link
+ anchor="simplexpathapi">SimpleXPathAPI</link>. Under Windows, the executable is TestDriver; under UNIX, the
+ executable is XPathWrapper.</p>
+ </s2><anchor name="simplexpathapi"/>
+ <s2 title="SimpleXPathAPI">
+ <p>What it does: uses the XPathEvaluator interface to evaluate an XPath expression from the specified context node of
+ an XML file, and displays the nodeset returned by the expression.</p>
+ <note>You can use this sample as an aid when you want to find out what a given XPath expression returns from a
+ given context node in an XML file.</note>
+ <p>Run this sample from the SimpleXPathAPI subdirectory with</p>
+ <p><code>SimpleXPathAPI <ref>XMLFile</ref> <ref>ContextNode</ref> <ref>XPathExpression</ref></code></p>
+ <p>where <ref>XMLFile</ref> is an XML source file, <ref>ContextNode</ref> is the location path to the context
node, and <ref>XPathExpression</ref> is an XPath expression to apply to that context node. The XPathWrapper
subdirectory contains an XML file named xml.foo (part of it appears below).</p>
<source><?xml version="1.0"?>
@@ -211,18 +231,12 @@
<name first="Paul" last="Dick"/>
</doc></source>
<p>You can try command lines like</p>
- <p>Windows:<br/>
- <code>TestDriver foo.xml /doc name/@last</code></p>
- <p>UNIX:<br/>
- <code>XPathWrapper foo.xml /doc name/@last</code></p>
+ <p><code>SimpleXPathAPI foo.xml /doc name/@last</code></p>
<p>and</p>
- <p>Windows:<br/>
- <code>TestDriver foo.xml / '//name[position()="4"]/@first'</code></p>
- <p>UNIX:<br/>
- <code>XPathWrapper foo.xml / '//name[position()="4"]/@first'</code></p>
- <note>If an XPathWrapper argument includes characters (such as *) that the shell intercepts, enclose the argument
- in double quotes.</note>
- <p>See also: <link idref="usagepatterns" anchor="xpath">Working with XPath expressions</link>.</p>
+ <p><code>SimpleXPathAPI foo.xml / '//name[position()="4"]/@first'</code></p>
+ <note>If a SimpleXPathAPI argument includes characters (such as *) that the shell intercepts, enclose the argument
+ in double quotes.</note>
+ <p>See also: <link idref="usagepatterns" anchor="xpath">Working with XPath expressions</link>.</p>
</s2><anchor name="externalfunctions"/>
<s2 title="ExternalFunctions">
<p>What it does: implement, install, and illustrate the usage of three extension functions. The functions return a
1.28 +8 -4 xml-xalan/c/xdocs/sources/xalan/usagepatterns.xml
Index: usagepatterns.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/usagepatterns.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- usagepatterns.xml 2001/06/08 20:22:25 1.27
+++ usagepatterns.xml 2001/08/09 20:10:36 1.28
@@ -75,7 +75,7 @@
<s2 title="Introduction">
<p>To perform a transformation, use one of the <jump href="apdidocs/class_xalantransformer.html">XalanTransformer</jump> transform() methods. The transformation requires an XML source document and an XSL stylesheet. Both of these objects may be represented by instances of <jump href="apidocs/class_xsltinputsource.html">XSLTInputSource</jump>. You can construct an XSLTInputSource with a string (the system ID for a file or URI), an input stream, or a DOM.</p>
-<p>If you are using an XSL stylesheet to perform a series of transformations, you can improve performance by calling transfomr() with a compiled stylesheet, an instance of <jump href="apidocs/class_xalancompiledstylesheet.html">XalanCompiledStylesheet</jump>. If you are transforming an XML source more than once, you should call transform() with a parsed XML source, an instance of <jump href="apidocs/class_xalanparsedsource">XalanParsedSource</jump>. See <link anchor="compiled">Performing a series of transformations</link>.</p>
+<p>If you are using an XSL stylesheet to perform a series of transformations, you can improve performance by calling transform() with a compiled stylesheet, an instance of <jump href="apidocs/class_xalancompiledstylesheet.html">XalanCompiledStylesheet</jump>. If you are transforming an XML source more than once, you should call transform() with a parsed XML source, an instance of <jump href="apidocs/class_xalanparsedsource">XalanParsedSource</jump>. See <link anchor="compiled">Performing a series of transformations</link>.</p>
<p>If you XML source document contains a stylesheet Processing Instruction (PI), you do not need to include a stylesheet object when you call transform().</p>
<p>The transformation output is represented by an <jump href="apdidocs/class_xsltresulttarget.html">XSLTResultTarget</jump>, which you can set up to refer to an output stream, the system ID for a file or URI, or a DOM.</p>
<p>For detailed API documentation, see <jump href="apidocs/index.html">&xslt4c; API</jump>. For an overview of the
@@ -166,7 +166,7 @@
const void* theOutputHandle,
XalanOutputHandlerType theOutputHandler
XalanFlushHanderType theFlushHandler = 0);</source>
-
+<p>For an example, see <link idref="samples" anchor="xalantransformercallback">XalanTransformerCallback</link>.</p>
</s2><anchor name="compiled"/>
<s2 title="Performing a series of transformations">
<p>Before Xalan performs a standard transformation, it must parse the XML document and compile the XSL stylesheet into binary representations. If you plan to use the same XML document or stylesheet in a series of transformations, you can improve performance by parsing the XML document or compiling the styleheet once and using the binary representation when you call transform().</p>
@@ -223,8 +223,12 @@
DOM_Document domOut = theParserLiaison.mapXercesDocument(docOut)</source>
</s2><anchor name="xpath"/>
<s2 title="Working with XPath expressions">
-<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 programmatically and do your own processing without a stylesheet.</p>
-<p>For an example that executes XPath expressions against XML source files, see <link idref="samples" anchor="xpathwrapper">XPathWrapper</link>.</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 programmatically and do
+your own processing without a stylesheet. &xslt4c; provides an XPathEvaluator interface to simplify the process of
+executing XPath expressions.</p>
+<p>For an example that executes XPath expressions against XML source files, see <link idref="samples" anchor="simplexpathapi">SimpleXPathAPI</link>
+(takes advantage of the XPathEvaluator interface) and <link idref="samples" anchor="xpathwrapper">XPathWrapper</link>.</p>
</s2><anchor name="tracelistener"/>
<s2 title="Using TraceListener">
<p>TraceListener is a debugging abstract base class implemented by TraceListenerDefault. You can use TraceListener to trace any combination of the following:</p>
1.1 xml-xalan/c/xdocs/sources/xalan/extensionslib.xml
Index: extensionslib.xml
===================================================================
<?xml version="1.0" standalone="no"?>
<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd">
<!--
* The Apache Software License, Version 1.1
*
*
* Copyright (c) 1999 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution,
* if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "Xalan" and "Apache Software Foundation" must
* not be used to endorse or promote products derived from this
* software without prior written permission. For written
* permission, please contact apache@apache.org.
*
* 5. Products derived from this software may not be called "Apache",
* nor may "Apache" appear in their name, without prior written
* permission of the Apache Software Foundation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation and was
* originally based on software copyright (c) 1999, Lotus
* Development Corporation., http://www.lotus.com. For more
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
-->
<s1 title="Extensions library">
<ul>
<li><link anchor="intro">Introduction</link></li>
<li><link anchor="xalanns">Xalan namespace</link></li>
<li><link anchor="nodeset">nodeset</link></li>
<li><link anchor="intersection">intersection</link></li>
<li><link anchor="difference">difference</link></li>
<li><link anchor="distinct">distinct</link></li>
<li><link anchor="evaluate">evaluate</link></li>
<li><link anchor="hassamenodes">hasSameNodes</link></li>
</ul><anchor name="intro"/>
<s2 title= "Introduction">
<p>Extension elements and functions provide a powerful mechanism
for extending and simplifying what you can do with an XLST processor like
Xalan. With input and contributions from the XML open-source developer community, we are working on placing the most useful
extensions in an extensions library distributed with &xslt4c;. If you have ideas and/or contributions you would like to make, please email us at the <human-resource-ref idref="xalandev"/>.</p>
</s2><anchor name="xalanns"/>
<s2 title="Xalan namespace">
<p>We are placing the Xalan extension functions in the XalanExtensions module and we have defined a namespace for this module:</p>
<p> <code>http://xml.apache.org/xalan</code></p>
<p>If you are calling &xslt4c;-supplied extensions, we recommend that you define this namespace in your stylesheet element, and call the extension using the namespace prefix that you have associated with that namespace. That way, if we later reorganize how the &xslt4c;-supplied extensions are stored, you won't have to modify your stylesheet.</p>
<p>For an example that uses this namespace, see <link anchor="ex-nodeset">Example with the nodeset extension function</link>.</p>
</s2>
<anchor name="nodeset"/>
<s2 title= "nodeset">
<p>Implemented in <jump href="apidocs/class_functionnodeset.html">FunctionNodeSet</jump>, <code>nodeset (result-tree-fragment)</code> casts a result tree fragment into a node-set.</p>
<note>When you bind a variable to a template, rather than to the value generated by a select expression, the data type of the variable is result tree fragment. For more information, see <jump href="http://www.w3.org/TR/xslt#section-Result-Tree-Fragments">Result Tree Fragments</jump>.</note>
<anchor name="ex-nodeset"/>
<s3 title="Example with the nodeset extension function">
<p>The following stylesheet uses the nodeset extension function to cast a result tree fragment into a node-set that can then be navigated in standard XPath manner. It uses the http://xml.apache.org/xalan namespace to provide access to the nodeset() method in xml.apache.xalan.lib.Extensions.</p>
<source><?xml version="1.0"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0"
xmlns:xalan="http://xml.apache.org/xalan"
exclude-result-prefixes="xalan">
<xsl:template match="/">
<out>
<xsl:variable name="rtf">
<docelem>
<elem1>
<elem1a>ELEMENT1A</elem1a>
<elem1b>,ELEMENT1B</elem1b>
</elem1>
<elem2>
<elem2a>ELEMENT2A</elem2a>
</elem2>
</docelem>
</xsl:variable>
<xsl:for-each select="xalan:nodeset($rtf)/docelem//*">
<xsl:value-of select="name(.)"/><xsl:text>,</xsl:text>
</xsl:for-each>
</out>
</xsl:template>
</xsl:stylesheet></source>
<p>The output of running this stylesheet (with any XML input source) is a comma-delimited list of the element names in the node-set<br/>
<code><out>elem1,elem1a,elem1b,elem2,elem2a</out></code></p>
<note>For illustration purposes, the preceding stylesheet pays no attention to the structure and content of the XML input document. Instead, it processes the template (in the stylesheet) bound to the variable named rtf.</note>
</s3>
</s2><anchor name="intersection"/>
<s2 title="intersection">
<p>Implemented in <jump href="apidocs/class_functionintersection.html">FunctionIntersection</jump>, <code>intersection (node-set1, node-set2)</code> returns a node-set with all nodes that are in ns1 and in ns2.</p>
</s2><anchor name="difference"/>
<s2 title= "difference">
<p>Implemented in <jump href="apidocs/class_functiondifference.html">FunctionDifference</jump>, <code>difference(node-set1, node-set2)</code> returns a node-set with the nodes in node-set1 and not in node-set2.</p>
</s2><anchor name="distinct"/>
<s2 title= "distinct">
<p>Implemented in <jump href="apidocs/class_functiondistinct.html">FunctionDistinct</jump>, distinct (node-set) returns a node-set containing nodes with distinct string values. If more than one node in the node-set
contains the same text node value, distinct only returns the first of these nodes that it finds.</p>
</s2><anchor name="evaluate"/>
<s2 title= "evaluate">
<p>Implemented in <jump href="apidocs/class_functionevaluate.html">FunctionEvaluate</jump>, <code>evaluate (xpath-expression)</code> returns the result of evaluating the xpath-expression in the current
XPath expression context (automatically passed in by the extension mechanism).</p>
<p>Use the evaluation extension function when the value of the expression is not known until run time.</p>
</s2>
<anchor name="hassamenodes"/>
<s2 title= "hasSameNodes">
<p>Implemented in <jump href="apidocs/class_functionhassamenodes.html">FunctionHasSameNodes</jump>, <code>hasSameNodes(node-set1, node-set2)</code> returns true if both node-set1 and node-set2 contain exactly the same set of nodes.</p>
</s2>
</s1>
---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xalan-cvs-help@xml.apache.org