




















|
| |
| |
Outstanding bugs are recorded in the Apache XML Bug Tracking System.
If you find a bug, please use this system to report it.
|
| |
Xalan-J version 1.0.1 has been tested with Xerces-j version 1.0.3. The Xalan download from xml.apache.org includes xerces.jar from Xerces-j version 1.0.3. For information about including xerces.jar on the system class path, see Setting up the system class path.
Important 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.
|
|
| |
| |
The Xalan build is in xalan.jar. The Xalan source code tree is in the src directory.
If you want to rebuild xalan.jar, you can do the following:
- Set up GNU or the equivalent build environment on your workstation.
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 Cygwin.
- Place Version 1.0.3 of Xerces-Java xerces.jar in the Java class path.
- If you are working in Windows, set MAKE_MODE as follows:
set MAKE_MODE=UNIX
- Run the make file in the Xalan root directory:
make build
If you want to do the build without the GNU build environment, keep the following in mind:
- Set the class path to include the src directory, xerces.jar, bsf.jar, and bsfengines.jar.
- 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
tree.
- Use the Sun jar utility to store the resulting .class files in xalan.jar
|
 |  |  |  | Rebuilding the Xalan documentation |  |  |  |  |
| |
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.
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.
To generate the Xalan HTML User's Guide, run the Xalan make file in the Xalan xdocs directory:
make makesbook
To generate Xalan API documentation, set up the make file to use the Javadoc tool in the Java JDK 1.2.2 bin
directory.
Do the following:
- Put the Java JDK 1.2.2 bin directory on your path (in front of any JDK 1.1.x bin
directory that appears on the path).
- In the Xalan docs directory, run the Xalan make file as follows:
make makejavadoc
If you want to rebuild the documentation without using the GNU build environment, keep the following in
mind:
- Unzip xml-site-style.tar.gz into the xdocs directory (the operation creates a number of subdirectories).
- Be sure stylebook-1.0-b2.jar, xalanjdoc.jar, xalan.jar, bsf.jar, bsfengines.jar, and xerces.jar are on the class
path.
- To build doc in a build/docs subdirectory, run StyleBook from the xdocs directory as follows:
java org.apache.stylebook.StyleBook "targetDirectory=../build/docs/" sources/xalanLocal.xml style
- To build the HTML source files that javadoc needs for top-level and package-level documentation, run
StyleBook from the xdocs directory as follows:
java org.apache.stylebook.StyleBook "loaderConfig=sbk:/style/loaderjdoc.xml" targetDirectory=../src sources/javadocPackages.xml style
- Before you run javadoc, make sure the following directory structure exists under the Xalan root
directory: build/docs/apidocs.
- To build the API documentation, run the JDK 1.2.2 javadoc tool from the xdocs directory:
-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
|
|
| |
Your feedback is more than welcome. Offers of help are even more so! Perhaps you would like to contribute to the ongoing development, testing, or documentation of Xalan?
Please email your comments, questions, suggestions, bug reports, and offers to help to Xalan Development Mailing List.
|
|
|