You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by dl...@locus.apache.org on 2000/09/25 23:16:06 UTC
cvs commit: xml-xalan/xdocs/sources/xalan extensions.xml getstarted.xml overview.xml samples.xml
dleslie 00/09/25 14:16:06
Modified: xdocs/sources/xalan extensions.xml getstarted.xml
overview.xml samples.xml
Log:
New bsf.jar replaces old bsf.jar and bsfengine.jar -- and works
with Rhino 1.5 js.jar for Javascript extensions.
Revision Changes Path
1.9 +3 -3 xml-xalan/xdocs/sources/xalan/extensions.xml
Index: extensions.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/extensions.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- extensions.xml 2000/05/31 15:57:47 1.8
+++ extensions.xml 2000/09/25 21:16:05 1.9
@@ -27,7 +27,7 @@
</s2><anchor name="supported-lang"/>
<s2 title="Supported languages">
<p>&xslt4j; uses the <jump href="http://www.alphaworks.ibm.com/tech/bsf">Bean Scripting Framework (BSF)</jump>, an architecture for incorporating scripting into Java applications and applets. BSF allows an application to take advantage of scripting while being independent of any specific scripting language. To date, we have tested extensions implemented in Java and JavaScript. Other languages with BSF support appear in the table below.</p>
-<p>BSF requires two JAR files on the class path: bsf.jar and bsfengines.jar. These two JAR files are shipped with &xslt4j;, and that is all that is required for Java extensions. The additional JAR files or DLLs required to support extensions in other languages are listed in the table below. These files are available from the sources indicated and are not shipped with &xslt4j;.</p>
+<p>BSF requires bsf.jar on the class path. This JAR file is shipped with &xslt4j;, and that is all that is required for Java extensions. The additional JAR files or DLLs required to support extensions in other languages are listed in the table below. These files are available from the sources indicated and are not shipped with &xslt4j;.</p>
<table>
<tr>
<td><em>Language</em></td>
@@ -36,7 +36,7 @@
</tr>
<tr>
<td>Mozilla Rhino<br/><br/></td>
- <td>1.4 R3<br/><br/></td>
+ <td>1.5<br/><br/></td>
<td>js.jar available from
http://www.mozilla.org/rhino<br/><br/></td>
</tr>
@@ -136,7 +136,7 @@
</source>
</s2><anchor name="setup-runtime"/>
<s2 title="Setting up the runtime environment">
-<p>To run the preceding example, bsf.jar, bsfengines.jar, and js.jar must be on the class path. Remember that bsf.jar and bsfengines.jar must be on the class path to run any extension. For extensions implemented in a scripting language, see the additional requirements in <link anchor="supported-lang">Supported languages</link>.</p>
+<p>To run the preceding example, bsf.jar and js.jar must be on the class path. Remember that bsf.jar must be on the class path to run any extension. For extensions implemented in a scripting language, see the additional requirements in <link anchor="supported-lang">Supported languages</link>.</p>
</s2><anchor name="basic-syntax"/>
<s2 title="Syntax">
<p>You can always use the pattern illustrated above to set up and use extension elements and extension functions. For extension functions implemented in Java, you can also use the java namespace, described in <link anchor="java-namespace">Alternative: using the predefined java extension namespace</link>. Unless you are using the predefined java extension namespace, do the following:</p>
1.17 +2 -2 xml-xalan/xdocs/sources/xalan/getstarted.xml
Index: getstarted.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/getstarted.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- getstarted.xml 2000/06/22 17:01:58 1.16
+++ getstarted.xml 2000/09/25 21:16:05 1.17
@@ -20,10 +20,10 @@
<p>You can get the JDK or JRE from <jump href="http://www.ibm.com/java/jdk">ibm.com/java/jdk/</jump> or <jump href="http://www.java.sun.com">java.sun.com</jump>.</p>
<p>Download <resource-ref idref="xslt4j-dist-zip"/> or <resource-ref idref="xslt4j-dist-targz"/>. Both of these files contain <resource-ref idref="xslt4j-current"/> (with xalan.jar) and xerces.jar from <resource-ref idref="xml4j-used"/>. You can use a zip or tar utility to expand these files into a full build.</p>
-<p>If you plan to run <link idref="extensions">XSLT extensions</link>, you need bsf.jar and bsfengines.jar, both of which are included in the &xslt4j; distribution. If you plan to run XSLT extensions implemented in JavaScript or another scripting language, you will need one or more additional files as indicated in <link idref="extensions" anchor="supported-lang">extensions language requirements</link>.</p>
+<p>If you plan to run <link idref="extensions">XSLT extensions</link>, you need bsf.jar, which is included in the &xslt4j; distribution. If you plan to run XSLT extensions implemented in JavaScript or another scripting language, you will need one or more additional files as indicated in <link idref="extensions" anchor="supported-lang">extensions language requirements</link>.</p>
</s2><anchor name="classpath"/>
<s2 title="Setting up the system class path">
-<p>At the very minimum, you must include xalan.jar and xerces.jar on the system class path. To run the sample applications, include xalansamples.jar. To run extensions, include bsf.jar and bsfengines.jar. All these JAR files are distributed with &xslt4j;. For extensions implemented in JavaScript or another scripting language, see <link idref="extensions" anchor="supported-lang">extensions language requirements</link> to identify any additional JAR files you must place on the class path and where you can get them.</p>
+<p>At the very minimum, you must include xalan.jar and xerces.jar on the system class path. To run the sample applications, include xalansamples.jar. To run extensions, include bsf.jar. All these JAR files are distributed with &xslt4j;. For extensions implemented in JavaScript or another scripting language, see <link idref="extensions" anchor="supported-lang">extensions language requirements</link> to identify any additional JAR files you must place on the class path and where you can get them.</p>
<p>If you are using JDK or JRE 1.1.8, also include classes.zip on the class path.</p>
</s2><anchor name="samples"/>
<s2 title="Trying out the samples">
1.12 +11 -11 xml-xalan/xdocs/sources/xalan/overview.xml
Index: overview.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/overview.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- overview.xml 2000/06/05 20:05:23 1.11
+++ overview.xml 2000/09/25 21:16:05 1.12
@@ -67,8 +67,8 @@
<li><link anchor="glossary">Glossary</link></li>
</ul><anchor name="intro"/>
<s2 title="Introduction">
- <p>&xslt4j; (named after a rare musical instrument) fully implements the <resource-ref idref="XSLT"/> and the
- <resource-ref idref="XPath"/>. XSLT is the first part of the XSL stylesheet language for XML. It includes the XSL
+ <p>&xslt4j; (named after a rare musical instrument) fully implements the <resource-ref idref="xslt"/> and the
+ <resource-ref idref="xpath"/>. 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 <link anchor="uptospeed">Getting up
to speed with XSLT</link>.</p>
@@ -99,10 +99,9 @@
</s2><anchor name="features"/>
<s2 title="&xslt4j; Features">
<ul>
- <li>Implements the <resource-ref idref="XSLT"/></li>
- <li>Incorporates the <resource-ref idref="XPath"/></li>
- <li>Optionally uses the high-performance DTM (Document Table Model) to avoid the object overhead involved in the
- construction and manipulation of DOM trees</li>
+ <li>Implements the <resource-ref idref="xslt"/></li>
+ <li>Incorporates the <resource-ref idref="xpath"/></li>
+ <li>May be run through the <resource-ref idref="trax"/> interfaces</li>
<li>Interfaces directly to the <jump href="http://xml.apache.org/xerces-j/index.html">&xml4j; XML parser</jump></li>
<li>Can interface to a SAX document handler or to any XML parser that produces Java DOM Trees</li>
<li>Can output to SAX or DOM</li>
@@ -112,8 +111,7 @@
<li>May be used in a <link idref="samples" anchor="servlet">servlet</link> to transform XML documents into HTML
and serve the results to clients</li>
<li>Supports <link idref="extensions">Java and scripting language extensions</link></li>
- <li>Provides <link idref="extensions" anchor="redirect">a redirect extension to support the production of multiple
- output documents in a single operation</link></li>
+ <li>Provides a growing number of proprietary <link idref="extensions">extension elements and functions</link></li>
</ul>
</s2><anchor name="towork"/>
<s2 title="Getting to work with &xslt4j;">
@@ -125,6 +123,10 @@
<p>If you are still working through the details of the XSLT spec (the W3C 1.0 Recommendation), you may want
to consult one or more of the following:</p>
<ul>
+ <li>Michael Kay's <jump href="http://www.wrox.com/Consumer/Store/Details.asp?ISBN=1861003129">XSLT Programmer's
+ Reference</jump>, Wrox Press, 2000<br/><br/></li>
+ <li>Neil Bradley's <jump href="http://cseng.aw.com/bookpage.taf?ISBN=0-201-67487-4">XSL Companion</jump>,
+ Addison-Wesley, 2000<br/><br/></li>
<li>Elliotte Rusty Harold's <jump href="http://metalab.unc.edu/xml/books/bible/updates/14.html">Chapter 14 of
the XML Bible: XSL Transformations</jump><br/><br/></li>
<li>Crane Softwright's <jump href="http://www.CraneSoftwrights.com/training/">Free preview of Practical
@@ -144,9 +146,7 @@
<li>Donald Ball's <jump href="http://www.webslingerZ.com/balld/xsl/designer_manual.xml">A Guide to XML and XSL for Designers</jump><br/><br/></li>
<li>XSLT - XSL Transformations in
<jump href="http://www.brics.dk/~amoeller/XML/">The XML Revolution: Technologies for the future Web</jump> by
- Anders Møller and Michael I. Schwartzbach<br/><br/></li>
- <li>Michael Kay's <jump href="http://www.wrox.com/Consumer/Store/Details.asp?ISBN=1861003129">XSLT Programmer's
- Reference</jump>, Wrox Press, April 2000</li>
+ Anders Møller and Michael I. Schwartzbach</li>
</ul>
<p>When you come across other useful introductory or background materials, please email <human-resource-ref
idref="dleslie"/>, so he can add them to this list.</p>
1.18 +4 -3 xml-xalan/xdocs/sources/xalan/samples.xml
Index: samples.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/samples.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- samples.xml 2000/03/22 15:59:43 1.17
+++ samples.xml 2000/09/25 21:16:05 1.18
@@ -76,7 +76,7 @@
<p>With most of the samples, you can use the following procedure:</p>
<ol>
<li>Be sure xalan.jar, xalansamples.jar, and xerces.jar are on the system class path. For the extension
- examples, bsf.jar, bsfengines.jar, and (for the JavaScript extensions) js.jar must also be on the class
+ examples, bsf.jar and (for the JavaScript extensions) js.jar must also be on the class
path.</li>
<li>Be sure the java executable is on your path.</li>
<li>Go to the samples subdirectory containing the sample (use the DOS shell if you are running Windows).</li>
@@ -155,8 +155,9 @@
<p>The extensions subdirectory contains four samples with &xslt4j; extensions. Two of the samples use
extensions implemented in JavaScript, and two of the samples use extensions implemented in Java. All of
the samples are documented in <link idref="extensions">Extensions</link>.</p>
- <p>To run these examples, you must place bsf.jar and bsfengines.jar (distributed with &xslt4j;), and js.jar (version 1.4
- release 3, available from <jump href="http://www.mozilla.org/rhino">http://www.mozilla.org/rhino</jump>) on the class path.
+ <p>To run these examples, you must place bsf.jar (distributed with &xslt4j;) and js.jar (version 1.5,
+ available from <jump href="http://www.mozilla.org/rhino">http://www.mozilla.org/rhino</jump>) on the class
+ path.
You do not need js.jar on the class path for the samples that use Java extensions. </p>
<p>Use java.org.apache.xalan.xslt.Process, the &xslt4j; command-line utility, to run these samples from
the <link idref="commandline">command line</link>. The command line must include an -in flag with the