<commit_before>$Id$


                          Commons Digester Package
                                Version 1.8-dev
                               Release Notes


*** Release notes current as of 2006-10-29

INTRODUCTION
============

This is a minor bugfix and maintenance release. A few small features have been added.
New projects are encouraged to use this release of digester, but there is no urgency
for existing projects to upgrade; Digester 1.7 has proven to be a stable release.

This release is 100% binary and source compatible with the previous release.

IMPORTANT NOTES
===============

none

Dependencies
=============
Release 1.8 has the same dependencies as release 1.7.

Compatible Dependency Sets:
   Digester 1.8 + Logging 1.0.x + BeanUtils 1.x + Collections 2.x
   Digester 1.8 + Logging 1.0.x + BeanUtils 1.x + Collections 3.x
   Digester 1.8 + Logging 1.0.x + BeanUtils 1.7

NEW FEATURES
=============

Kaffe/GNU-Classpath compatibility
-------------------
All Digester unit tests now pass with the Kaffe 1.1.6 JVM. It is expected
that Digester works with other free Java implementations that also use the
GNU Classpath libraries.

Xmlrules Enhancements
----------------------
The xmlrules module has had the following updates to provide access
to functionality that was previously accessable only via the digester
API:
     -- node-create-rule tag added to provide access to NodeCreateRule.
        Patch provided by <NAME>; bugzilla 36482

Stack Monitoring
----------------

Method "setStackAction" has been added to the Digester class. This allows user
code to monitor all objects pushed onto and popped off digester stacks. In
particular, this makes it easier to store source file/line info for all
objects created during parsing.

Namespace Access
----------------

Method "getCurrentNamespaces" has been added to the Digester class. This allows user
code to get a snapshot of all the prefix->url mappings applicable at a point in time.
This is particularly useful for elements that contain xpath expressions that should
be evaluated later using the same namespaces defined for the element.

BUGS FROM PREVIOUS RELEASE
==========================

Reports Addressed
------------------
* Bugzilla #37034 raises issue with jarfiles being "locked" on Windows machines.
  A bug in Sun's java libraries can cause a jarfile to become "locked"
  when a jarfile is the source of an xml or dtd file used by Digester.
  In particular, this can cause problems when redeploying a J2EE webapp.
  A workaround for the Sun bug has been added to Digester to resolve this.

Fixes without Bugzilla entries
------------------------------<commit_msg>Add info re support for maven2.<commit_after>$Id$


                          Commons Digester Package
                                Version 1.8-dev
                               Release Notes


*** Release notes current as of 2006-10-29

INTRODUCTION
============

This is a minor bugfix and maintenance release. A few small features have been added.
New projects are encouraged to use this release of digester, but there is no urgency
for existing projects to upgrade; Digester 1.7 has proven to be a stable release.

This release is 100% binary and source compatible with the previous release.

IMPORTANT NOTES
===============

none

Dependencies
=============
Release 1.8 has the same dependencies as release 1.7.

Compatible Dependency Sets:
   Digester 1.8 + Logging 1.0.x + BeanUtils 1.x + Collections 2.x
   Digester 1.8 + Logging 1.0.x + BeanUtils 1.x + Collections 3.x
   Digester 1.8 + Logging 1.0.x + BeanUtils 1.7

NEW FEATURES
=============

Kaffe/GNU-Classpath compatibility
-------------------
All Digester unit tests now pass with the Kaffe 1.1.6 JVM. It is expected
that Digester works with other free Java implementations that also use the
GNU Classpath libraries.

Xmlrules Enhancements
----------------------
The xmlrules module has had the following updates to provide access
to functionality that was previously accessable only via the digester
API:
     -- node-create-rule tag added to provide access to NodeCreateRule.
        Patch provided by <NAME>; bugzilla 36482

Stack Monitoring
----------------

Method "setStackAction" has been added to the Digester class. This allows user
code to monitor all objects pushed onto and popped off digester stacks. In
particular, this makes it easier to store source file/line info for all
objects created during parsing.

Namespace Access
----------------

Method "getCurrentNamespaces" has been added to the Digester class. This allows user
code to get a snapshot of all the prefix->url mappings applicable at a point in time.
This is particularly useful for elements that contain xpath expressions that should
be evaluated later using the same namespaces defined for the element.

Maven 2.x build support
-----------------------

This release now comes with a pom.xml file to allow digester to be built using maven 2.x.

BUGS FROM PREVIOUS RELEASE
==========================

Reports Addressed
------------------
* Bugzilla #37034 raises issue with jarfiles being "locked" on Windows machines.
  A bug in Sun's java libraries can cause a jarfile to become "locked"
  when a jarfile is the source of an xml or dtd file used by Digester.
  In particular, this can cause problems when redeploying a J2EE webapp.
  A workaround for the Sun bug has been added to Digester to resolve this.

Fixes without Bugzilla entries
------------------------------
{'fraction_non_alphanumeric': 0.10989412194231471, 'fraction_numerical': 0.019167579408543262, 'mean_word_length': 2.858450704225352, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 7, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 5}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5140836', 'n_tokens_mistral': 1447, 'n_tokens_neox': 1316, 'n_words': 726}