diff --git a/src/java/org/apache/commons/collections/primitives/package.html b/src/java/org/apache/commons/collections/primitives/package.html index 818003c1d..781f4ad41 100644 --- a/src/java/org/apache/commons/collections/primitives/package.html +++ b/src/java/org/apache/commons/collections/primitives/package.html @@ -1,18 +1,29 @@ - -Contains collection implementations that use primitive elements. Currently -the package offers lists of primitive elements that are backed by primitive -arrays, offering substantial memory and performance savings.

- -There are generally two layers of abstract per primitive list type. The -first layer, implemented by the Abstract*List classes, provides -default implementations for all of the java.util.List methods -and most of their primitive counterparts. The second layer of abstraction, -implemented by the Abstract*ArrayList classes, provides -additional method signatures for manipulating a list that's backed by a -primitive array.

- -Note that these layers are not provided for FloatArrayList, -and that many primitive types are not represented in this package at all; -these inconsistencies may be addressed by a future release. - - + + + + Package Documentation for org.apache.commons.collections.primitives + + +

+ Collections that are based upon primitive + types. Generally these extensions offer memory + and performance improvements over the + Object wrapped alternative. +

+

+ The package provides (or will provide) versions of + the major collections framework interfaces + (Collection, List, + Map, Set) and their + helpers (Iterator, ListIterator, + etc) for each primitive type, and various concrete + implementations of these. +

+

+ Adapters are provided for converting between the + primitive and object based versions of the collections + framework. +

+ + +