RELEASE-NOTES.txt

$Id$

           Commons Primitives Package
                 Version 1.0
                Release Notes


INTRODUCTION:

This is a first release of the Commons Primitives package.

This release is primarily composed of implementations of the 
java.util collections adapted for the primitive types.


FEATURES:

The current release is composed of four packages.

1) org.apache.commons.collections.primitives 

 <Type>Collection 
  - The java.util.Collection interface adapted for the primitive type <Type>

 <Type>Iterator
  - The java.util.Iterator interface adapted for the primitive type <Type>

 <Type>List
  - The java.util.List interface adapted for the primitive type <Type>

 <Type>ListIterator
  - The java.util.ListIterator interface adapted for the primitive type <Type>

 Abstract<Type>Collection 
  - An abstract base for <Type>Collection implementations

 RandomAccess<Type>List
  - An abstract base for <Type>List implementations backed by random access
    data structures like arrays

 Array<Type>List
  - A <Type>List backed by an array

 <Type>Collections
  - Static utility methods for working with <Type>Collection instances


2) org.apache.commons.collections.primitives.adapters

 Adapters between the Object-based and primitive-based collection types.


3) org.apache.commons.collections.primitives.adapters.io

 Adapters converting IO Streams/Readers to Byte/Char iterators, and vice versa.
 

4) org.apache.commons.collections.primitives.decorators

 Unmodifiable<Type>List
 Unmodifiable<Type>Iterator
 Unmodifiable<Type>ListIterator
  
  - Unmodifiable decorators around <Type>List, <Type>Iterator and <Type>ListIterator