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
