About SAXON

version 7.6


 

Contents
On this page On other pages
What is Saxon?
Installation
Technical Support
Historical Note
Conditions of Use
Changes in this release
Using XSLT Stylesheets
Using XQuery
XSLT Elements
XPath 2.0 Expression syntax
XPath 2.0 Functions
XSLT Pattern syntax
Standards Conformance
Saxon Extensions
The SQL Extension
Extensibility mechanisms
Java API Overview
Sample applications

Please note: a copy of the documentation on this site is also included in the download file. On occasions the on-line version may be more up-to-date. The download file also includes full API documentation, which is not present on the web site: see the doc/api directory.

Saxon 7.6 introduces support for XQuery alongside XSLT

Release 7.6 is the latest installment of my experimental implementation of the new XPath 2.0 and XSLT 2.0 specifications. For the first time, this release also includes support for XQuery 1.0. In all cases, the product is aligned with the working drafts published on 2 May 2003, though of course not all features are implemented.

As always, all changes are listed in changes.html

This release is not recommended for production use, since neither the specifications nor the code are yet stable. The preferred version for production use is Saxon 6.5.2.

Saxon 7.6 requires Java JDK 1.4

I have recently switched over Saxon development to use the IDEA development environment from IntelliJ. Many thanks to IntelliJ for sponsoring this, and I can thoroughly recommend the product.

What is Saxon?

The Saxon package is a collection of tools for processing XML documents. The main components are:

So you can use Saxon by writing XSLT stylesheets, by writing XQuery queries by writing Java applications, or by combinations of the approaches.

Saxon implements the XSLT 1.0 recommendation, including XPath 1.0, in its entirety. Saxon 7.5 also implements many features defined in the XSLT 2.0, XPath 2.0, and XQuery 1.0 working drafts, in particular:

Saxon does not yet implement all of XSLT 2.0, XPath 2.0, or XQuery 1.0. The most notable omission is support for XML Schema data typing. Most of the important built-in types are supported, but not user-defined types.

In addition, Saxon provides an extensive library of extension elements and extension functions, all implemented in conformance with the XSLT Recommendation to ensure that portable stylesheets can be written. These include the EXSLT extension libraries common, sets, math, and dates-and-times. Many of these extensions were pioneered in Saxon and have since become available in other products.

These functions are in general accessible from XQuery as well as XSLT, except where they depend on stylesheet information.

Saxon also provides an API allowing a Java application to execute XPath and XQuery expressions and process the results. The XPath API is modelled on the proposed DOM Level 3 API, but adapted to the requirements of XPath 2.0. A separate API is available for XQuery 1.0, reflecting differences in the way the context is set up.


Historical Note

Saxon is essentially a one-man project: I have done almost all the development myself, except for a small number of routines which I "borrowed" from other open source products, and a few add-ons contributed by users.

I originally wrote Saxon to support an internal project in ICL, and ICL continued to sponsor development of Saxon until my departure from the company in January 2001. However, it was never a supported ICL product. My new employers, Software AG, are continuing to sponsor the development of Saxon, but again without making it a corporate product. There is no remaining connection with ICL. As always, the software is available entirely without support or warranty, and with no commitments to any future releases.

The name Saxon was chosen because originally it was a layer on top of SAX. Also, it originally used the Ælfred parser (among others); Ælfred of course was a Saxon king...

I have been asked to point out that the product has no connection with a company called Saxon Software.


Please read the Conditions of Use.


Technical Support

Saxon comes with no warranty and no formal technical support service.

If you have questions, however, you can usually get an answer by raising them on the Saxon discussion list at http://lists.sourceforge.net/lists/listinfo/saxon-help.

Once registered, you can post messages to saxon-help@lists.sourceforge.net.

If you hit something that looks like a bug, please check the known errors on the Saxon project pages at SourceForge. Also check the list archives.

If the query relates to the XSLT/XPath language rather than Saxon itself, it is better to use the XSL-list: check first that the query isn't already covered in the FAQ. Other useful sites for XSLT information are www.xslt.com, www.xmlsoftware.com and www.jenitennison.com.

Help forums for XQuery are less active at the moment, for details see the XQuery home page at http://www.w3.org/XML/Query


Installation

Existing users please see the file changes.html for details of incompatible changes in this release.

The full Saxon distribution includes source and object code, documentation, and sample applications.

Saxon can be used either from the command line, or from a Java application, using the JAXP 1.2 API which is included as a standard feature of JDK 1.4. Object code is issued as a JAR file, saxon7.jar, which you must include on your class path.

Saxon no longer includes a built-in XML parser: by default it uses the XML parser supplied with the Java VM. But you can use it with a different XML parser if you wish. To do this from the command line, specify the required parser using the -x or -y options; from the Java API, set the name of the parser class as an attribute of the TransformerFactory object.

User documentation, covering both the XSLT and Java interfaces, is included in the download in the form of extensive javadoc specifications. Be sure to read the package summaries, which give an overview in the form of a user guide. In addition there is an introductory overview.

Prerequisites:

The following software must be installed separately, it is not included with the Saxon download.

Saxon has been tested successfully in the past with a wide variety of parsers including Xerces, Lark, SUN Project X, Crimson, Piccolo, Oracle XML, xerces, xml4j, and xp. Use of a SAX2-compliant parser is now mandatory. All the relevant classes must be installed on your Java CLASSPATH.

Saxon doesn't work with the XML parser in Resin, because the Resin parser fails (in numerous ways) to conform to the SAX2 specification. The version tested was 2.1.1.

Because Saxon is run from the command line, you might find it useful (under Microsoft Windows) to have a text editor with better command-line support than the standard DOS window. I use Programmer's File Editor (PFE), a free product available from a number of download sites, listed here, and also UltraEdit, shareware available from www.ultraedit.com

Download

An index of all currently-available versions of Saxon is on the home page at SourceForge: see http://saxon.sf.net/


Michael H. Kay
22 June 2003

Personal home page: http://homepage.ntlworld.com/michael.h.kay

My home page displays an email address which can be used to bypass my spam filters