RELEASE-NOTES.txt

        Commons Collections Generics Package
                Version X.X
               Release Notes


INTRODUCTION:

Commons collections is a project to develop and maintain collection classes
based on and inspired by the JDK collection framework.
This version uses the generics features of JDK1.5 and is not compatible with
earlier JDK versions.

The process of generifying an API is complex.
For commons-collections, we have chosen to break the API in various ways.
The aim behind this is to provide an API design that better suits generics.
We have also removed all deprecated classes and fixed oddities in the previous
API that we couldn't fix due to backwards compatability restrictions.

As such, this release should not be considered to be a simple, drop-in, replacement
for commons-collections. You will probably receive compile errors, and you will
certainly have generification warnings to solve. These release notes will try
to guide you in the process of upgrading, however you should remember that this
is a new API based on the original, so some concepts have changed.


Changes from commons-collections
--------------------------------
- Removed all deprecated classes and methods

- Removed FastArrayList
  - use CopyOnWriteList
- Removed FastHashMap
  - use ConcurrentHashMap, but beware null keys and values
- Removed FastTreeSet
  - no direct replacement - use ConcurrentHashMap or synchronized TreeMap

- Removed Typed* containers such as TypedList and TypedMap
  - use generics for type safety, or Collections.checked*()

- Switch Abstract*Decorator classes to expose decorated() protected method
  instead of the decorated collection directly. Each class overrides decorated()
  to add its type covariantly, thus getList()/getSet() etc. methods are removed


Feedback
--------
Open source works best when you give feedback:
http://jakarta.apache.org/commons/collections/

Please direct all bug reports to JIRA
http://issues.apache.org/jira/browse/COLLECTIONS

Or subscribe to the commons-user mailing list (prefix emails by [collections])
http://jakarta.apache.org/site/mail.html

The Commons-Collections-Generics Team