Package types

Both binary and source code packages are available, and they come in following flavours:

• The stable version is the latest release from a branch that has been frozen, i.e. no API changes will be made, only critical fixes.
• The current version is the latest release from the current development branch. Although API may still evolve (until this branch becomes the stable one), release are functional, and changes between releases are documented.
• Last revisions of earlier major releases may also be included as necessary.

You can also access current source code from the Subversion repository. Anonymous access can be used like:

svn co svn://svn.woodstox.codehaus.org/woodstox/scm

In addition to the core Woodstox packages, there are couple of additional packages available:

• Stax API is needed when accessing Woodstox via Stax API (the usual case). (note: latest revision, 1.0.1, is recommended)
• Extended experimental Stax2 API jars are distributed along with Woodstox jars (see below): this a proposed set of extended functionality that extends Stax 1.0 API. Note. It is possible to get these as a separate package too, though, for example to allow more dynamic access to this functionality subset, or by other Stax implementations.

Note: Stax2 interface is used by StaxMate stax helper library.

Licensing

Woodstox is dual-licensed under 2 alternative Open Source/Free licenses: LGPL 2.1 and ASL 2.0. (starting with Woodstox 2.0 release). This is because of perceived incompatibility between these two popular licenses: while I do not agree in that there is a problem (the way I interpret LGPL, Java class loading is not static linking, ergo there is no virality), I nonetheless find it easier to just provide alternative downloads to risk alienating Apache/Jakarta or GPL users.

What this means is that one can choose either one of these licenses (for purposes of re-distributing Woodstox; usually by including it as one of jars another application or library uses) by downloading corresponding jar file, using it, and living happily everafter. With source code distribution licensing does not matter; except that it is good to know that by default Ant will build 2 distributions, one under each license.

Current (3.9.2 (pre-4.0))

• Version: 3.9.2
• Release date: 06-May-2008
• WebDav directory: https://dav.codehaus.org/woodstox/3.9.2
• Binaries (jar):
  • wstx-asl-3.9.2.jar (ASL 2.0)
  • wstx-lgpl-3.9.2.jar (LGPL 2.1)
  • stax2 jar (v3.0pr1) (extended API WoodSToX implements above and beyond standard Stax (1.0) API)
  • For MSV-based Relax NG validation you will also need MSV jars. The best place for getting these is from MSV home page , but here are snapshots (from July 2006) of 3 relevant jars (of which only first one is obligatory):
    • wstx-msv.jar
    • wstx-msv-rng-datatype.jar
    • wstx-msv-xsdlib.jar
• Source packages:
  • Gzipped tar: wstx-src-V.tar.gz
  • Zip: wstx-src-V.zip
• Documentation:
  • Release notes
  • README
  • CREDITS
  • JavaDocs

Stable (3.2.5)

• Version: 3.2.5
• Release date: 24-Apr-2008
• WebDav directory: https://dav.codehaus.org/woodstox/3.2.5
• Binaries (jar):
  • wstx-asl-3.2.5.jar (ASL 2.0)
  • wstx-lgpl-3.2.5.jar (LGPL 2.1)
  • stax2 jar (v2.1) (extended API WoodSToX implements above and beyond standard Stax (1.0) API)
  • For MSV-based Relax NG validation you will also need MSV jars. The best place for getting these is from MSV home page , but here are snapshots (from July 2006) of 3 relevant jars (of which only first one is obligatory):
    • msv.jar
    • relaxngDatatype.jar
    • xsdlib.jar
• Source packages:
  • Gzipped tar: wstx-src-V.tar.gz
  • Zip: wstx-src-V.zip
• Documentation:
  • Release notes
  • README
  • CREDITS
  • JavaDocs

Earlier releases:

These releases are only provided for legacy support purposes (maybe you have an old system that used non-latest 1.0.x or 2.0.x release), and should not be used with new applications.

• 3.1.2 (release date: 05-Jun-2007)
  • WebDav directory: https://dav.codehaus.org/woodstox/3.1.2
  • Binaries (jar): wstx-asl-3.1.2.jar (ASL 2.0) , wstx-lgpl-3.1.2.jar (LGPL 2.1) , stax2.jar (v3.0) (extended API, also included in base jar)
  • Additional MSV jars for RNG validation (note: MSV home page is the main page): msv.jar , relaxngDatatype.jar , xsdlib.jar
  • Source packages: wstx-src-V.tar.gz, wstx-src-V.zip
  • Documentation: Release notes , README, CREDITS, JavaDocs
• 2.0.6 (release date: 31-Mar-2006)
  • WebDav directory: https://dav.codehaus.org/woodstox/2.0.6
  • Binaries (jar): wstx-asl-2.0.6.jar (ASL 2.0) , wstx-lgpl-2.0.6.jar (LGPL 2.1) , stax2.jar (v1.0) (extended API, also included in base jar)
  • Source packages: wstx-src.tar.gz, wstx-src.zip
  • Documentation: Release notes , README , CREDITS , JavaDocs
• 1.0.7 (release date: 22-Jun-2005)
  • Webdav directory: https://dav.codehaus.org/woodstox/1.0.7/
  • Binary: wstx-1.0.7.jar
  • Sources: wstx-src-1.0.7.tar.gz

And that's all folks!