dleslie 00/06/22 10:02:03
Modified: xdocs xml-site-style.tar.gz
xdocs/sources entities.ent xalan.xml
xdocs/sources/xalan DONE STATUS faq.xml getstarted.xml
index.xml readme.xml resources.xml
Log:
1st draft of ipdates for 1.1.D01
Revision Changes Path
1.3 +107 -89 xml-xalan/xdocs/xml-site-style.tar.gz
<<Binary file>>
1.5 +3 -2 xml-xalan/xdocs/sources/entities.ent
Index: entities.ent
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/entities.ent,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- entities.ent 2000/05/31 15:57:43 1.4
+++ entities.ent 2000/06/22 17:01:47 1.5
@@ -1,9 +1,10 @@
<?xml encoding="US-ASCII"?>
<!ENTITY xslt4j "Xalan-Java">
-<!ENTITY xslt4j-current "Xalan-Java version 1.1.0">
+<!ENTITY xslt4j-dist "xalan-j_1_1_D01">
+<!ENTITY xslt4j-current "&xslt4j; version 1.1.D01">
<!ENTITY xml4j "Xerces-Java">
-<!ENTITY xml4j-used "Xerces-Java version 1.1.0">
+<!ENTITY xml4j-used "&xml4j; version 1.1.1">
<!ENTITY xslt4c "Xalan-C++">
<!ENTITY xml4c "Xerces-C++">
<!ENTITY done-j SYSTEM "sbk:/sources/xalan/DONE">
1.8 +1 -1 xml-xalan/xdocs/sources/xalan.xml
Index: xalan.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- xalan.xml 2000/05/31 15:57:44 1.7
+++ xalan.xml 2000/06/22 17:01:47 1.8
@@ -67,7 +67,7 @@
<separator/>
<document id="index"
- label="Xalan-Java 1.1.0"
+ label="Xalan-Java 1.1.D01"
source="xalan/index.xml"/>
<external href="getstarted.html#download" label="Downloads"/>
1.11 +2 -1 xml-xalan/xdocs/sources/xalan/DONE
Index: DONE
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/DONE,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- DONE 2000/05/31 15:57:46 1.10
+++ DONE 2000/06/22 17:01:58 1.11
@@ -1,6 +1,6 @@
<s3 title="Changes since &xslt4c; version 1.0.1">
<p>&xml4j; version 1.0.4 introduced some API changes that caused problems
for &xslt4j; version 1.0.1. The two teams have collaborated to bring Xalan-Java
and Xerces-Java back into synch with &xslt4j-current; and &xml4j-used;.</p>
-<p>We have also addressed several bugs found in version 1.0.1:</p>
+<p>We have also addressed several bugs found in &xslt4j; version 1.0.1:</p>
<ul>
<li>A function or variable reference on the left-hand-side of a union was
sometimes incorrectly evaluated. This has been fixed.<br/><br/></li>
<li>Numbered entity references were sometimes output in hexadecimal, not
decimal. Numbered entity references are now always output in
decimal.<br/><br/></li>
@@ -9,4 +9,5 @@
<code>org.apache.xalan.xslt.XSLTProcessor xsltProc =</code><br/>
<code>org.apache.xalan.xslt.XSLTProcessorFactory.getProcessor(</code><br/>
<code> new
org.apache.xalan.xpath.xdom.XercesLiaison());</code></li>
</ul>
+<p>We have upgraded support for using Apache Ant to build &xslt4j;. For the
details, see <link anchor="ant">Using Ant</link>.</p>
</s3>
1.10 +16 -10 xml-xalan/xdocs/sources/xalan/STATUS
Index: STATUS
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/STATUS,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- STATUS 2000/05/31 15:57:46 1.9
+++ STATUS 2000/06/22 17:01:58 1.10
@@ -1,16 +1,22 @@
<s3 title="Version of Xerces to use">
-<p>The &xslt4j-current; has been tested with &xml4j-used; <ref>(the match in
version numbers is coincidental; as a general rule, the version numbers do not
match)</ref>. &download; For information about including xerces.jar on the
system class path, see <link idref="getstarted" anchor="classpath">Setting up
the system class path</link>.</p>
+<p>The &xslt4j-current; has been tested with &xml4j-used;. &download; For
information about including xerces.jar on the system class path, see <link
idref="getstarted" anchor="classpath">Setting up the system class
path</link>.</p>
<p><em>Important</em> You may experience unpredictable anomalies if your
Xalan and Xerces builds are not in synch. If you download an update to Xalan,
check the release notes to determine which version of Xerces you should use.</p>
<note>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
<resource-ref idref="XMLParserLiaisonDefaultDoc"/> and implement <resource-ref
idref="XMLParserLiaisonDoc"/>.</note>
</s3>
<s3 title="To-do tasks for future &xslt4j; releases">
- <p>A top priority for the &xslt4j; team in the ongoing development of
&xslt4j; is to improve performance. This includes
- enhanced support for SAX and incremental transformations, more efficient
trees than current implementations of the DOM
- interfaces provide, and a number of possibilities pertaining to the
compilation of stylesheets, preprocessing XML/XPaths,
- and so on.</p>
- <p>As part of the xml.apache team, the &xslt4j; team is exploring
options to upgrade the integration of all the xml.apache
- projects, including Xalan, Xerces, Cocoon, and FOP.</p>
- <p><human-resource-ref idref="scurcuru"/> is looking into replacing our
current make system with the Java Ant
- system.</p>
- <p>Watch the <human-resource-ref idref="xalandev"/> for more information
and for ideas about how you can get involved.</p>
+ <p>The &xslt4j; team is hard at work on &xslt4j; version 2.0, which
represents a major redesign of the Xalan XSLT Processor. The
+ main goals of this redesign are as follows:</p>
+ <ol>
+ <li>Improvide ease of access and usability of &xslt4j;, and
encourage greater participation from the open source community
+ in the ongoing design and development process</li>
+ <li>Reduce code size and complexity</li>
+ <li>Improvide performance and simplify optimization.</li>
+ <li>Produce more localized, less-intertangled modules</li>
+ <li>Begin the adoption of the TRaX (Transformations for XML)
interfaces.</li>
+ </ol>
+ <p>As part of the xml.apache team, members of the &xslt4j; team are also
exploring options to upgrade the integration of all
+ the xml.apache projects, including Xalan, Xerces, Cocoon, and FOP.</p>
+ <p>The more individuals who join in the design, development, testing,
documention, and use of
+ &xslt4j; the better for us all in the xml.apache.org open source
community! Watch the <human-resource-ref idref="xalandev"/>
+ for more information and for ideas about how you can get involved.</p>
</s3>
1.10 +1 -1 xml-xalan/xdocs/sources/xalan/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/faq.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- faq.xml 2000/05/31 15:57:47 1.9
+++ faq.xml 2000/06/22 17:01:58 1.10
@@ -34,7 +34,7 @@
<resource-ref idref="XSLTProcessorDoc"/> object) to function as a SAX
DocumentHandler in conjunction with a second
XSLTProcessor object that uses the second stylesheet and also
functions as a DocumentHandler.</p>
<p>To walk through a brief example, see <link idref="usagepatterns"
anchor="sax">Generating and responding to
- SAX events</link></p>.</a>
+ SAX events</link>.</p></a>
</faq>
<faq title="Are the XSLTProcessor and StylesheetRoot (compiled stylesheet)
objects thread-safe?">
1.16 +1 -1 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.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- getstarted.xml 2000/05/31 15:57:47 1.15
+++ getstarted.xml 2000/06/22 17:01:58 1.16
@@ -18,7 +18,7 @@
<li>xerces.jar</li>
</ul>
<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 <jump
href="http://xml.apache.org/dist/xalan-j/xalan-j_1_1_0.zip";>xalan-j_1_1_0.zip</jump>
or <jump
href="http://xml.apache.org/dist/xalan-j/xalan-j_1_1_0.tar.gz";>xalan-j_1_1_0.tar.gz</jump>.
Both of these files contain <resource-ref idref="xalan-current"/> (with
xalan.jar) and xerces.jar from <resource-ref idref="xerces-used"/>. You can use
a zip or tar utility to expand these files into a full build.</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>
</s2><anchor name="classpath"/>
1.4 +3 -3 xml-xalan/xdocs/sources/xalan/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/index.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- index.xml 2000/05/31 15:57:48 1.3
+++ index.xml 2000/06/22 17:01:58 1.4
@@ -75,14 +75,14 @@
<s2 title="How do I get it?">
<p>Download and unzip either of the following:</p>
<ul>
- <li><jump
href="http://xml.apache.org/dist/xalan-j/xalan-j_1_1_0.zip";>xalan-j_1_1_0.zip</jump></li>
- <li><jump
href="http://xml.apache.org/dist/xalan-j/xalan-j_1_1_0.tar.gz";>xalan-j_1_1_0.tar.gz</jump></li>
+ <li><resource-ref idref="xslt4j-dist-zip"/></li>
+ <li><resource-ref idref="xslt4j-dist-targz"/></li>
</ul>
</s2>
<s2 title="Where do I get the Xerces XML parser?">
<p>The Xalan dowload includes xerces.jar from &xml4j-used;. This is all
you need to run Xalan.
- You can, however, download the complete Xerces distribution from the
<resource-ref idref="xerces-j-dist"/>.</p>
+ You can, however, download the complete Xerces distribution from the
<resource-ref idref="xml4j-distdir"/>.</p>
</s2>
<s2 title="What else do I need?">
<p>You need the Java Development Kit or Java Runtime 1.1.8 or 1.2.2,
which you can obtain from <jump
1.11 +67 -16 xml-xalan/xdocs/sources/xalan/readme.xml
Index: readme.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/readme.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- readme.xml 2000/05/31 15:57:50 1.10
+++ readme.xml 2000/06/22 17:01:59 1.11
@@ -82,26 +82,70 @@
<anchor name="build"/>
<s2 title="Build Notes">
<ul>
+<li><link anchor="ant">Using Ant</link></li>
<li><link anchor="jar">Rebuilding xalan.jar</link></li>
<li><link anchor="samples">Rebuilding sample applications</link></li>
<li><link anchor="doc">Rebuilding the &xslt4j; documentation</link></li>
</ul>
-<anchor name="jar"/>
- <s3 title="Rebuilding &xslt4j;">
- <p>The &xslt4j; build is in xalan.jar. The &xslt4j; source code tree is
in the src directory.
- If you want to rebuild xalan.jar, you can do the following:</p>
+<anchor name="ant"/>
+ <s3 title="Using Ant">
+ <p>Apache <resource-ref idref="ant"/> is a flexible, powerful, and
easy-to-use Java build tool that we include with the
+ &xslt4j; distribution. The Ant JAR file is in the root directory along
with a cross-platform XML build file (build.xml), a
+ Windows32 batch file (build.bat) and a UNIX shell file (build.sh). The
build file defines the "targets" that you can use Ant
+ to build. The batch and shell files set up the classpath and launch Ant
with the target (and any other arguments) you
+ provide.</p>
+ <p><em>Instructions for using Ant</em></p>
<ol>
+ <li>Set the JAVA_HOME environment variable to the JDK root
directory.<br/><br/>
+ If you are using JDK 1.1.8, you must also put classes.zip in the JDK
bin directory on the classpath. You can use Ant
+ with JDK 1.1.8 to compile and jar the &xslt4j; source files, but you
must have JDK 1.2.2 or higher to build the
+ documentation.<br/><br/></li>
+ <li>Depending on your environment, run the batch file (build.bat) or
shell file (bmild.sh) from the &xslt4j; root
+ directory, optionally with arguments (see the table of targets
below).<br/><br/>
+ The batch/shell file adds several JAR files to the classpath and
launches Ant with any arguments you provide. If you
+ provide no target, Ant compiles the source files and rebuilds
xalan.jar (the "jar" target).</li>
+ </ol>
+ <p>You can also set up your classpath manually (see build.bat or
build.sh for the details), and then run Ant as
+ follows:<br/><br/>
+ <code>java org.apache.tools.ant.Main <ref>target</ref></code><br/><br/>
+ where <ref>target</ref> is nothing (for the default target) or one of
the following.</p>
+ <table>
+ <tr><td><em>Target</em></td><td><em>What Ant does</em></td></tr>
+ <tr><td>compile</td><td>compiles Xalan-J in build/classes.</td></tr>
+ <tr><td>jar</td><td>creates xalan.jar in the build directory (the
default)</td></tr>
+ <tr><td>samples</td><td>compiles and jars the sample apps</td></tr>
+ <tr><td>docs</td><td>creates the HTML User's Guide in
build/docs</td></tr>
+ <tr><td>javadocs</td><td>generates the API documentation in
./build/docs/apidocs</td></tr>
+ <tr><td>dist</td><td>creates a complete distribution in
xalan-j_<ref>x</ref>_<ref>y</ref>_<ref>z</ref></td></tr>
+ <tr><td>site</td><td> creates the website documentation tree in
xml-site/target/xalan</td></tr>
+ <tr><td>clean</td><td>purges the build, distribution, and site
trees</td></tr>
+ </table>
+ <p>If you build a target that depends on other targets, Ant creates those
other targets in the correct order.</p>
+ <p><em>Other build tools</em></p>
+ <p>The distribution also includes makefiles that you can use with the GNU
development tools. And of course you can also use
+ the underlying utilities to compile source files, create JAR files,
generate Javadoc, and generate the HTML User's Guide. One
+ utility that you may not be familiar with is
org.apache.stylebook.StyleBook (in stylebook-1.0-b2.jar), a tool from the
+ xml-stylebook module that we use along with Xalan and Xerces to help
generate the documentation. For the details, you can
+ inspect the makefiles.</p>
+
+ </s3><anchor name="jar"/>
+ <s3 title="Rebuilding &xslt4j;">
+ <p>The &xslt4j; build is in xalan.jar. The &xslt4j; source code tree is
in the src directory.</p>
+ <p>If you are using Ant, the target is jar (the default). For more
information, see <link anchor="ant">Using
+ Ant</link>.</p>
+ <p>To use GNU development tools, do the following:</p>
+ <ol>
<li>Set up GNU or the equivalent build environment on your
workstation.<br/><br/>
If you are running Windows 95/98/2000/NT, you can use the Cygwin port
of GNU. Be sure to put the
appropriate Cygwin bin directory at the beginning of your system
path. For information about
Cygwin, see <jump
href="http://www.sourceware.cygnus.com/cygwin/";>Cygwin</jump>.<br/><br/></li>
- <li>Place <resource-ref idref="xerces-j-used"/> xerces.jar in the
Java class path.<br/><br/></li>
+ <li>Place <resource-ref idref="xml4j-used"/> xerces.jar in the Java
class path.<br/><br/></li>
<li>If you are working in Windows, set MAKE_MODE as follows:<br/><br/>
<code>set MAKE_MODE=UNIX</code><br/><br/></li>
<li>Run the make file in the &xslt4j; root directory:<br/><br/>
<code>make build</code><br/><br/></li>
</ol>
- <p>If you want to do the build without the GNU build environment, keep
the following in mind:</p>
+ <p>If you want to do the build without Ant or the GNU build
environment, keep the following in mind:</p>
<ul>
<li>Set the class path to include the src directory, xerces.jar,
bsf.jar, and bsfengines.jar.</li>
<li>Use a Java compiler (such as the IBM Just-In-Time compiler or the
Sun javac) to compile all the .java files in the src
@@ -116,20 +160,27 @@
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
xalansamples.jar.</p>
+ <p>You can use Ant with the samples target to recompile the samples and
place the unpackaged class files in xalansamples.jar.
+ For more information, see <link anchor="ant">Using Ant</link>.</p>
+ <note>To rebuild (and to run) the sample servlet, the javax.servlet and
javax.servlet.http packages must be on your
+ classpath.</note>
</s3><anchor name="doc"/>
<s3 title="Rebuilding the &xslt4j; documentation">
<p>&xslt4j; 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 a Stylebook tool from
xml.apache.org and the JDK 1.2.2 java and javadoc
- tools. Stylebook (which uses Xalan and Xerces) and the required
document definition files, stylesheets, and resources
- are stored in xml-site-style.tar.gz, and are unzipped when you run the
make files as described below. 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/>
+ <p>To rebuild the documentation, you must use the StyleBook tool and
the JDK 1.2.2 java and javadoc
+ tools. StyleBook (which uses Xalan and Xerces) is in
stylebook-1.0-b2.jar. Some of the document definition files,
+ stylesheets, and resources are stored in xml-site-style.tar.gz, and
are unzipped when you run the make files as described
+ below. 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>You can use Ant with the docs target to regenerate the User's Guide
and with the javadocs target to regenerate the
+ Javadoc API documentation. For more information, see <link
anchor="ant">Using Ant</link>.</p>
+ <p>To generate the Xalan HTML User's Guide with the GNU development
tools, run the Xalan make file in the Xalan xdocs
+ directory:<br/><br/>
<code>make makesbook</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
+ <p>To generate the Xalan API documentation with GNU, set up the make
file to use the Javadoc tool in the Java JDK 1.2.2 bin
directory.</p>
<p>Do the following:</p>
<ol>
@@ -138,10 +189,10 @@
<li>In the Xalan docs directory, run the Xalan make file as
follows:<br/><br/>
<code>make makejavadoc</code><br/><br/></li>
</ol>
- <p>If you want to rebuild the documentation without using the GNU
build environment, keep the following in
+ <p>If you want to rebuild the documentation without using Ant or the
GNU build environment, keep the following in
mind:</p>
<ul>
- <li>Unzip xml-site-style.tar.gz into the xdocs directory (the
operation creates a number of subdirectories).
+ <li>Unzip xml-site-style.tar.gz into the xdocs directory (the
operation places files in a number of subdirectories).
<br/><br/></li>
<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>
1.12 +11 -5 xml-xalan/xdocs/sources/xalan/resources.xml
Index: resources.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/resources.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- resources.xml 2000/05/31 15:57:51 1.11
+++ resources.xml 2000/06/22 17:01:59 1.12
@@ -1,5 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE resources [
+ <!ENTITY % externalEntity SYSTEM "sbk:/sources/entities.ent">
+ %externalEntity;
<!ENTITY apiResources SYSTEM "apiResources.xml">
<!ELEMENT resources (resource|human-resource)+>
<!ELEMENT resource EMPTY>
@@ -14,11 +16,15 @@
<resources>
&apiResources;
- <resource id="xalan-j-current" title="Xalan-Java 1.1.0 XSLT Processor"
location="http://xml.apache.org/xalan"/>
- <resource id="xalan-j-dist" title="Xalan-Java distribution directory"
location="http://xml.apache.org/dist/xalan-j/"/>
- <resource id="LotusXSL-current" title="LotusXSL 1.0.0"
location="http://www.alphaworks.ibm.com/tech/LotusXSL"/>
- <resource id="xml4j-used" title="the XML Parser for Java Version 3.0.0EA3"
location="http://www.alphaworks.ibm.com/tech/xml4j"/>
- <resource id="xerces-j-used" title="Xerces-Java Version 1.1.0"
location="http://xml.apache.org/xerces-j/index.html"/>
+ <resource id="xslt4j-current" title="&xslt4j-current;"
location="http://xml.apache.org/xalan"/>
+ <resource id="xslt4j-dist-zip" title="&xslt4j-dist;.zip"
+ location="http://xml.apache.org/dist/xalan-j/&xslt4j-dist;.zip"/>
+ <resource id="xslt4j-dist-targz" title="&xslt4j-dist;.tar.gz"
+ location="http://xml.apache.org/dist/xalan-j/&xslt4j-dist;.tar.gz"/>
+ <resource id="xslt4j-distdir" title="xalan-j distribution directory"
location="http://xml.apache.org/dist/xalan-j/"/>
+ <resource id="xml4j-used" title="&xml4j-used;"
location="http://xml.apache.org/xerces-j/index.html"/>
+ <resource id="xml4j-distdir" title="xerces-j distribution directory"
location="http://xml.apache.org/dist/xerces-j/"/>
+ <resource id="ant" title="Ant"
location="http://jakarta.apache.org/ant/index.html"/>
<resource id="ApacheLicense" title="The Apache Software License, Version
1.1" location="http://xml.apache.org/dist/LICENSE.txt"/>
