Release notes for Xalan-C++ version 1.6
| |
| |
All known Xalan-C++ bugs are listed in Bugzilla (the Apache bug database). For a list of open bugs with links to each bug
report, see XalanC open bugs. If you find a new bug, please enter a XalanC bug report in this
database.
 | Before you can enter your first bug report, you must submit your email address to Bugzilla and receive a password. |
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.
|
|
| |
 |  |  |  | Steps for doing a UNIX build |  |  |  |  |
| |
- The Xalan build files are written for GNU make, and will not work with other make utilities.
- Set the XERCESCROOT environment variable to the path to the root of Xerces-C++.
- Set the XALANCROOT environment variable to the path to the c directory in the root of the Xalan-C++
distribution. For example, if the distribution is located in "/home/xalan", you would set the XALANCROOT to "/home/xalan/xml-xalan/c".
- (Optional) If you are including the ICUBridge, install the ICU, use the shell to define XALAN_USE_ICU and to set the ICUROOT environment variable to the path to the ICU root. For more information, see (see Using the ICU)
- Change directory to xml-xalan/c/src/xalanc in the Xalan-C++ distribution. You can also build Xalan-C outside of the source tree, but you will need to adjust the path to the runConfigure script in the next step.
- Run the runConfigure utility with the platform, C compiler, and C++ compiler flags as indicated below.
Linux using GCC: ./runConfigure -p linux -c gcc -x c++
Linux using the Intel compiler: ./runConfigure -p linux -c icc -x icpc
AIX (32 bit): ./runConfigure -p aix -c xlc -x xlC
AIX (64-bit): ./runConfigure -p aix -c xlc -x xlC -b 64
HP-UX 11 (32 bit): ./runConfigure -p hp-11 -c cc -x aCC
HP-UX 11 (64 bit): ./runConfigure -p hp-11 -c cc -x aCC -b 64
Solaris (32 bit): ./runConfigure -p Solaris -c cc -x CC
Solaris (64 bit): ./runConfigure -p Solaris -c cc -x CC -b 64
To see the other runConfigure flags you may include, use the help flag:
./runConfigure -h
- Purge the previous build:
make clean
- Build the Xalan library and command-line executables:
make
or
make targ
where targ is omitted or is all (rebuild all), lib (the XSLT library), Xalan (the Xalan executable), or
testXSLT (the testXSLT executable). ICUBridge is included in the build of Xalan and TestXSLT if XALAN_USE_ICU is
defined. You can build the sample applications using the target samples .
 | To recompile existing applications without changing your source code, be sure to modify the command line in your Makefile to pick up the Xalan headers from it's new location. e.g: if your xalan source location is in /home/xml-xalan, |
CC ... -I/home/xml-xalan/c/src -I/home/xml-xalan/c/src/xalanc mysrc.cpp
|
 |  |  |  | Rebuilding a Sample application |  |  |  |  |
| |
In the Windows32 distribution, all of the sample applications can be built from the Xalan.dsw Visual C++ workspace. If you modify a sample and want to recompile it, you can recompile the .cpp file(s) and rebuild the executable.
The Makefile that come with the UNIX distributions include targets for rebuilding one or all of the sample applications (with the exception of the ThreadSafe sample, which in its current form only runs under Windows). To rebuild one or more sample applications, go to the xml-xalan/c/src/xalanc directory and run
gmake Target
where Target is Samples (all the samples), ApacheModuleXSLT , CompileStylesheet , DocumentBuilder , ExternalFunctions , ParsedSourceWrappers , SerializedNodeSet , SimpleTransform , SimpleXPathAPI , SimpleXPathCAPI , StreamTransform , ThreadSafe (Windows only), TraceListen , TransformToXercesDOM , UseStylesheetParam , XPathWrapper , XalanTransform , or XalanTransformerCallback .
|
|
| |
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-C++.
Please email your comments, questions, suggestions, bug reports, and offers to help to Xalan Development Mailing List.
|
|