Apache
/
commons-collections
mirror of https://github.com/apache/commons-collections.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge in the build from the trunk, finish updating license headers and prepare site for 3.2.1 release 

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/collections/branches/COLLECTIONS_3_2_BRANCH@646782 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Niall Kegan Pemberton 2008-04-10 12:58:57 +00:00
parent 91e368d0b7
commit d9d85d17a1
31 changed files with 1220 additions and 381 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
DEVELOPERS-GUIDE.html
View File

@ -1,9 +1,10 @@
<!-- <!--
Copyright 2002-2004 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -15,13 +16,13 @@
--> -->
<html> <html>
<head> <head>
<title>Developers guide for Jakarta Commons "Collections" Package</title> <title>Developers guide for Apache Commons "Collections" Package</title>
</head> </head>
<body bgcolor="white"> <body bgcolor="white">
<div align="center"> <div align="center">
<h1>The Jakarta Commons <em>Collections</em> Package</h1> <h1>The Apache Commons <em>Collections</em> Package</h1>
<h2>Developers Guide</h2> <h2>Developers Guide</h2>
$Id$<br /> $Id$<br />
<a href="#Introduction">[Introduction]</a> <a href="#Introduction">[Introduction]</a>

3
NOTICE.txt
View File

@ -1,2 +1,5 @@
Apache Commons Collections
Copyright 2001-2008 The Apache Software Foundation
This product includes software developed by This product includes software developed by
The Apache Software Foundation (http://www.apache.org/). The Apache Software Foundation (http://www.apache.org/).

11
PROPOSAL.html
View File

@ -1,9 +1,10 @@
<!-- <!--
Copyright 2001-2004 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0

5
README.txt
View File

@ -1,7 +1,7 @@
Jakarta Commons Collections Apache Commons Collections
=========================== ===========================
Welcome to the Collections component of the Jakarta Commons project. Welcome to the Collections component of the Apache Commons project.
This component contains many new collections and collection utilities. This component contains many new collections and collection utilities.
Two jar files are produced by this component. Two jar files are produced by this component.
@ -49,3 +49,4 @@ It can be found here :
http://maven.apache.org/ http://maven.apache.org/
Once installed, the jars may be built with 'maven jar'. Once installed, the jars may be built with 'maven jar'.

111
RELEASE-NOTES.html
View File

@ -1,9 +1,10 @@
<!-- <!--
Copyright 2003-2005 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -15,10 +16,10 @@
--> -->
<html> <html>
<head> <head>
<title>RELEASE NOTES: COLLECTIONS 3.2</title> <title>RELEASE NOTES: COLLECTIONS 3.2.1</title>
</head> </head>
<body> <body>
<center><h2>RELEASE NOTES: COLLECTIONS 3.2</h2></center> <center><h2>RELEASE NOTES: COLLECTIONS 3.2.1</h2></center>
<p> <p>
Commons collections is a project to develop and maintain collection classes Commons collections is a project to develop and maintain collection classes
@ -26,104 +27,14 @@ based on and inspired by the JDK collection framework.
This project is JDK1.2 compatible, and does not use JDK1.5 generics. This project is JDK1.2 compatible, and does not use JDK1.5 generics.
</p> </p>
<p> <p>
This release adds various new classes and fixes a number of bugs. This v3.2.1 release is simply a re-packaging of the v3.2 release, with appropriate
All feedback should be directed to commons-user at jakarta.apache.org. OSGi meta data added to the jar's manifest file.
</p> </p>
<hr /> <hr />
<center><h3>COMPATIBILITY</h3></center> <center><h3>COMPATIBILITY</h3></center>
<p> <p>
This release is fully source and binary compatible with v3.1. This release is fully source and binary compatible with v3.2.
(Checks performed using JDiff and Clirr, thanks).
Please check the bug fixes to ensure you weren't relying on the behaviour of a bug.
</p> </p>
<p>
There are two new <i>deprecations</i>:<br />
BeanMap is now deprecated and will be removed in v4.0.
The class is now available in commons-beanutils (full jar version).
This change was made to ensure that all bean related collections were in one place (ie. beanutils).
If this causes major headaches to anyone please contact commons-dev at jakarta.apache.org.
</p>
<p>
MultiHashMap is now deprecated and will be removed in v4.0.
The class is now available as MultiValueMap in the map subpackage.
This new version of the class is a decorator and can wrap maps other than HashMap
making it much more flexible.
If this causes major headaches to anyone please contact commons-dev at jakarta.apache.org.
</p>
<center><h3>NEW CLASSES</h3></center>
<ul>
<li>MultiValueMap - Decorator implementation of MultiMap providing control over the map and collection implementations, updated MapUtils to match [29440]</li>
<li>DefaultedMap - Returns a default value when the key is not found, without adding the default value to the map itself [30911]</li>
<li>GrowthList - Decorator that causes set and indexed add to expand the list rather than throw IndexOutOfBoundsException [34171]</li>
<li>LoopingListIterator - When the end of the list is reached the iteration continues from the start, updated IteratorUtils to match [30166]</li>
<li>ReverseListIterator - A list iterator that returns the elements from the list in reverse order [39224]</li>
<li>BoundedBuffer - A new wrapper class which can make any buffer bounded, updated BufferUtils to match [37473]</li>
</ul>
<center><h3>ENHANCEMENTS</h3></center>
<ul>
<li>CollectionUtils.addIgnoreNull - Adds to the collection if the value being added is not null [30020]</li>
<li>MapUtils.putAll - Puts an array of key/value pairs into a map [30882]</li>
<li>CollectionUtils/MapUtils.isEmpty/isNotEmpty - Null-safe checks of collection emptyness [35890]</li>
<li>CollectionUtils.sizeIsEmpty - Checks if a collection, array, map, iterator or enumeration is empty</li>
<li>CollectionUtils/ListUtils - retainAll/removeAll that don't change original colllection</li>
<li>ExtendedProperties - Accepts List elements (does not enforce Vector) as values [36812]</li>
<li>ExtendedProperties - new Methods getList(String key) and getList(String key, List defaults) [36812]</li>
<li>ExtendedProperties - No longer uses an exception in normal processing [30497]</li>
<li>BlockingBuffer - now includes stack trace if InterupttedException occurs [33700]</li>
<li>BlockingBuffer - new methods that allow get and remove with a timeout, updated BufferUtils to match [27691]</li>
<li>BlockingBuffer - now allows you to specify a default timeout value for get/remove operations [37607]</li>
<li>TransformedMap/TransformedSortedMap - new factory decorateTransform() that transforms any existing entries in the map [30959]</li>
<li>ListOrderedMap - values can now be accessed as a List using valueList() [37015]</li>
<li>ListOrderedMap - additional list-like method, setValue(int,Object)</li>
<li>ListOrderedMap - additional method, put(int,Object,Object)</li>
<li>PriorityBuffer - now Serializable [36163]</li>
<li>ListIteratorWrapper - now implements ResettableListIterator [39449]</li>
<li>IfClosure - add single argument constructor, updated CllosureUtils to match [38495]</li>
<li>All/Any/One/None Predicate - allow construction with zero or one predicates [37979]</li>
</ul>
<center><h3>BUG FIXES</h3></center>
<ul>
<li>FastArrayList - Fix iterators and views to work better in multithreaded environments</li>
<li>FastArrayList - Fix iterator remove where ConcurrentModificationException not as expected [34690]</li>
<li>CursorableLinkedList (list subpackage) - Fix iterator remove/set not throwing IllegalStateException after next-previous-removeByIndex [35766]</li>
<li>TreeList/CursorableLinkedList/NodeCachingLinkedList/AbstractLinkedList - Fix iterator remove not working properly when called after previous [35258]</li>
<li>TreeList - remove(int) could break class invariants, breaking iterator previous [35258]</li>
<li>SetUniqueList.set(int,Object) - Destroyed set status in certain circumstances [33294]</li>
<li>AbstractLinkedMap.init() - Now calls createEntry() to create the map entry object [33706]</li>
<li>AbstractHashedMap deserialization - Fix to prevent doubling of internal data array [34265]</li>
<li>AbstractHashedMap initialization - Fix to setup threshold correctly, improving performance [35012]</li>
<li>BeanMap.initialize() - Internal variable now correctly initialised with only write methods that actually exist [15895]</li>
<li>MultiHashMap.remove(key, item) - Was returning the item even when nothing was removed [32366]</li>
<li>MultiHashMap.putAll(multimap) - Was adding the collection as a single item rather than individually [35631]</li>
<li>MultiHashMap - Enable compilation using J#</li>
<li>Flat3Map.equals() - Fix to make flat mode comparison actually work [34917]</li>
<li>TransformedMap.putAll - Now allows putAll of an empty map [34686]</li>
<li>StaticBucketMap.containsKey - Fix incorrect null checking [37567]</li>
<li>AbstractMapBag.BagIterator.remove - Removing the last entry used to break the class invariants [35747]</li>
<li>BoundedFifoBuffer/CircularFifoBuffer - Fix serialization to work in case where buffer serialized when full [31433]</li>
<li>BoundedFifoBuffer - Fix iterator remove bug causing ArrayIndexOutOfBounds error [33071]</li>
<li>UnboundedFifoBuffer - Fix iterator remove bug causing ArrayIndexOutOfBounds error [35733]</li>
<li>UnboundedFifoBuffer - Fix deserialization to work with subsequant object manipulation [35763]</li>
<li>BlockingBuffer - Fix internal locking code (internal fix, no effect on users of BlockingBuffer) [37028]</li>
<li>IteratorChain.remove() - Fix to avoid IllegalStateException when one of the underlying iterators is a FilterIterator [34267]</li>
<li>FilterIterator - Correctly handle setting of iterator and predicate after object creation [38074]</li>
<li>ExtendedProperties.convertProperties() - Fix to handle default properties maps correctly [32204]</li>
<li>Add casts to avoid some JDK1.5 compilation warnings [35474]</li>
<li>Make serialization version ids private [37106]</li>
</ul>
<center><h3>JAVADOC</h3></center>
<ul>
<li>MapUtils.safeAddToMap - Better comment</li>
<li>MapUtils.transformed*Map - Better comment</li>
<li>ListOrderedSet.decorate(List) - Better comment [32073]</li>
<li>BlockingBuffer - Add comments</li>
<li>Maps - synchronization comments [32573]</li>
<li>SwitchTransformer - defaultTransformer comment fix [39207]</li>
</ul>
</body> </body>
</html> </html>

19
STATUS.html
View File

@ -1,9 +1,10 @@
<!-- <!--
Copyright 2001-2004 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -15,13 +16,13 @@
--> -->
<html> <html>
<head> <head>
<title>Status File for Jakarta Commons "Collections" Package</title> <title>Status File for Apache Commons "Collections" Package</title>
<head> <head>
<body bgcolor="white"> <body bgcolor="white">
<div align="center"> <div align="center">
<h1>The Jakarta Commons <em>Collections</em> Package</h1> <h1>The Apache Commons <em>Collections</em> Package</h1>
$Id$<br> $Id$<br>
<a href="#Introduction">[Introduction]</a> <a href="#Introduction">[Introduction]</a>
<a href="#Dependencies">[Dependencies]</a> <a href="#Dependencies">[Dependencies]</a>
@ -59,9 +60,9 @@ components for development and use:</p>
<h3>3. RELEASE INFO</h3> <h3>3. RELEASE INFO</h3>
<p>Current Release: <p>Current Release:
<a href="http://jakarta.apache.org/site/binindex.cgi">Version 3.1</a> <a href="http://jakarta.apache.org/site/binindex.cgi">Version 3.2</a>
<p>Planned Next Release: 3.2</p> <p>Planned Next Release: 3.3</p>
<a name="Committers"></a> <a name="Committers"></a>
<h3>4. COMMITTERS</h3> <h3>4. COMMITTERS</h3>

70
build-testframework.xml Normal file
View File

@ -0,0 +1,70 @@
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<project name="Collections Test Framework jar" default="jar" basedir=".">
<!--
$Id$
-->
<!-- ========== Component Declarations ==================================== -->
<!-- The current version number of this component -->
<property name="component.version" value=""/>
<!-- The base directory for compiled test classes -->
<property name="test.classes" value="target/test-classes"/>
<!-- The base directory for distribution targets -->
<property name="dist.home" value="target"/>
<!-- JDK versions -->
<property name="maven.compile.source" value=""/>
<property name="maven.compile.target" value=""/>
<!-- ========== Executable Targets ======================================== -->
<target name="jar" description="Create Collections Test Framework jar">
<mkdir dir="${dist.home}"/>
<mkdir dir="${test.classes}/META-INF"/>
<copy file="LICENSE.txt" tofile="${test.classes}/META-INF/LICENSE.txt"/>
<copy file="NOTICE.txt" tofile="${test.classes}/META-INF/NOTICE.txt"/>
<jar jarfile="${dist.home}/commons-collections-testframework-${component.version}.jar">
<manifest>
<attribute name="Specification-Title" value="Commons Collections Test Framework"/>
<attribute name="Specification-Version" value="${component.version}"/>
<attribute name="Specification-Vendor" value="The Apache Software Foundation"/>
<attribute name="Implementation-Title" value="Commons Collections Test Framework"/>
<attribute name="Implementation-Version" value="${component.version}"/>
<attribute name="Implementation-Vendor" value="The Apache Software Foundation"/>
<attribute name="Implementation-Vendor-Id" value="org.apache"/>
<attribute name="X-Compile-Source-JDK" value="${maven.compile.source}"/>
<attribute name="X-Compile-Target-JDK" value="${maven.compile.target}"/>
</manifest>
<fileset dir="${test.classes}">
<include name="**/LICENSE.txt"/>
<include name="**/NOTICE.txt"/>
<include name="**/AbstractTest*.class"/>
<include name="**/BulkTest*.class"/>
</fileset>
</jar>
</target>
</project>

49
build.xml
View File

@ -1,9 +1,10 @@
<!-- <!--
Copyright 2001-2006 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -32,10 +33,10 @@
<property name="component.title" value="Commons Collections"/> <property name="component.title" value="Commons Collections"/>
<!-- The full title of this component --> <!-- The full title of this component -->
<property name="component.title.full" value="Apache Jakarta Commons Collections"/> <property name="component.title.full" value="Apache Commons Collections"/>
<!-- The current version number of this component --> <!-- The current version number of this component -->
<property name="component.version" value="3.2"/> <property name="component.version" value="3.2.1"/>
<!-- The base directory for component configuration files --> <!-- The base directory for component configuration files -->
<property name="source.conf" value="src/conf"/> <property name="source.conf" value="src/conf"/>
@ -373,7 +374,7 @@
<property name="tf.name" value="commons-collections-testframework"/> <property name="tf.name" value="commons-collections-testframework"/>
<property name="tf.package" value="org.apache.commons.collections"/> <property name="tf.package" value="org.apache.commons.collections"/>
<property name="tf.title" value="Commons Collections Test Framework"/> <property name="tf.title" value="Commons Collections Test Framework"/>
<property name="tf.title.full" value="Apache Jakarta Commons Collections Test Framework"/> <property name="tf.title.full" value="Apache Commons Collections Test Framework"/>
<property name="tf.version" value="${component.version}"/> <property name="tf.version" value="${component.version}"/>
<property name="tf.build.conf" value="${build.home}/tfconf"/> <property name="tf.build.conf" value="${build.home}/tfconf"/>
@ -431,28 +432,15 @@
</fileset> </fileset>
</copy> </copy>
<mkdir dir="${tf.build.tf}/META-INF"/>
<copy file="LICENSE.txt"
tofile="${tf.build.tf}/META-INF/LICENSE.txt"/>
<copy file="NOTICE.txt"
tofile="${tf.build.tf}/META-INF/NOTICE.txt"/>
<tstamp/>
<mkdir dir="${tf.build.conf}"/>
<copy todir="${tf.build.conf}" filtering="on">
<filterset>
<filter token="name" value="${tf.name}"/>
<filter token="title" value="${tf.title}"/>
<filter token="package" value="${tf.package}"/>
<filter token="version" value="${tf.version}"/>
</filterset>
<fileset dir="${source.conf}" includes="*.MF"/>
</copy>
<!-- NOTE: A jar built using JDK1.4 is incompatible with JDK1.2 --> <!-- NOTE: A jar built using JDK1.4 is incompatible with JDK1.2 -->
<jar jarfile="${tf.build.jar.name}" <ant antfile="build-testframework.xml" target="jar">
basedir="${tf.build.tf}" <property name="test.classes" value="${tf.build.tf}"/>
manifest="${tf.build.conf}/MANIFEST.MF"/> <property name="dist.home" value="${build.home}"/>
<property name="component.version" value="${tf.version}"/>
<property name="maven.compile.source" value="1.2"/>
<property name="maven.compile.target" value="1.2"/>
</ant>
</target> </target>
<!-- ====================================================================== --> <!-- ====================================================================== -->
@ -539,9 +527,12 @@
<include name="PROPOSAL.html"/> <include name="PROPOSAL.html"/>
<include name="STATUS.html"/> <include name="STATUS.html"/>
<include name="build.xml"/> <include name="build.xml"/>
<include name="build-testframework.xml"/>
<include name="checkstyle.xml"/>
<include name="maven.xml"/> <include name="maven.xml"/>
<include name="project.xml"/> <include name="project.xml"/>
<include name="project.properties"/> <include name="project.properties"/>
<include name="pom.xml"/>
</fileset> </fileset>
</copy> </copy>
<copy todir="${build.dist.src.work}"> <copy todir="${build.dist.src.work}">

51
maven.xml
View File

@ -1,9 +1,10 @@
<!-- <!--
Copyright 2002-2004 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -28,37 +29,11 @@
<!-- ============== JAR ================== --> <!-- ============== JAR ================== -->
<postGoal name="jar:jar"> <postGoal name="jar:jar">
<j:set var="finalName" value="${pom.getPluginContext('maven-jar-plugin').getVariable('maven.final.name')}"/> <ant:ant antfile="build-testframework.xml" target="jar">
<j:set var="finalVersion" value="${finalName.substring(20)}" /> <property name="component.version" value="${pom.currentVersion}"/>
<j:set var="testfwkBase" value="${pom.artifactId}-testframework" /> <property name="test.classes" value="${maven.build.dir}/test-classes"/>
<j:set var="testfwkName" value="${testfwkBase}-${finalVersion}" /> <property name="dist.home" value="${maven.build.dir}"/>
</ant:ant>
<ant:jar
jarfile="${maven.build.dir}/${testfwkName}.jar">
<j:set var="licenseFileName"><license:fileName/></j:set>
<util:file name="${licenseFileName}" var="licenseFile"/>
<ant:metainf dir="${licenseFile.canonicalFile.parent}">
<ant:include name="${licenseFile.canonicalFile.name}"/>
</ant:metainf>
<ant:manifest>
<ant:attribute name="Built-By" value="${user.name}"/>
<ant:attribute name="Created-By" value="Apache Jakarta Maven"/>
<ant:attribute name="Package" value="${pom.package}"/>
<ant:attribute name="Build-Jdk" value="${java.version}"/>
<!-- added supplementary entries -->
<ant:attribute name="Extension-Name" value="Commons Collections Test Framework"/>
<ant:attribute name="Specification-Version" value="${pom.specificationVersion}"/>
<ant:attribute name="Specification-Vendor" value="${pom.organization.name}"/>
<ant:attribute name="Specification-Title" value="Commons Collections Test Framework"/>
<ant:attribute name="Implementation-Version" value="${pom.currentVersion}"/>
<ant:attribute name="Implementation-Vendor" value="${pom.organization.name}"/>
<ant:attribute name="Implementation-Vendor-Id" value="${pom.organization.identifier}"/>
</ant:manifest>
<ant:fileset dir="${maven.build.dir}/test-classes">
<ant:include name="**/AbstractTest*.class"/>
<ant:include name="**/BulkTest*.class"/>
</ant:fileset>
</ant:jar>
</postGoal> </postGoal>
<postGoal name="jar:install"> <postGoal name="jar:install">
@ -123,6 +98,10 @@
<!-- Copy Files --> <!-- Copy Files -->
<ant:copy todir="${maven.dist.src.assembly.dir}"> <ant:copy todir="${maven.dist.src.assembly.dir}">
<ant:fileset dir="."> <ant:fileset dir=".">
<ant:include name="build-testframework.xml"/>
<ant:include name="checkstyle.xml"/>
<ant:include name="pom.xml"/>
<ant:include name="NOTICE.txt"/>
<ant:include name="RELEASE-NOTES.html"/> <ant:include name="RELEASE-NOTES.html"/>
<ant:include name="DEVELOPERS-GUIDE.html"/> <ant:include name="DEVELOPERS-GUIDE.html"/>
<ant:include name="PROPOSAL.html"/> <ant:include name="PROPOSAL.html"/>

438
pom.xml Normal file
View File

@ -0,0 +1,438 @@
<?xml version="1.0"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific collectionsuage governing permissions and
limitations under the License.
-->
<project
xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-parent</artifactId>
<version>9</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<groupId>commons-collections</groupId>
<artifactId>commons-collections</artifactId>
<version>3.2.1</version>
<name>Commons Collections</name>
<inceptionYear>2001</inceptionYear>
<description>Types that extend and augment the Java Collections Framework.</description>
<url>http://commons.apache.org/collections/</url>
<issueManagement>
<system>jira</system>
<url>http://issues.apache.org/jira/browse/COLLECTIONS</url>
</issueManagement>
<scm>
<connection>scm:svn:http://svn.apache.org/repos/asf/commons/proper/collections/trunk</connection>
<developerConnection>scm:svn:https://svn.apache.org/repos/asf/commons/proper/collections/trunk</developerConnection>
<url>http://svn.apache.org/viewvc/commons/proper/collections/trunk</url>
</scm>
<developers>
<developer>
<name>Stephen Colebourne</name>
<id>scolebourne</id>
<email></email>
<organization></organization>
</developer>
<developer>
<name>Morgan Delagrange</name>
<id>morgand</id>
<email></email>
<organization></organization>
</developer>
<developer>
<name>Matthew Hawthorne</name>
<id>matth</id>
<email></email>
<organization></organization>
</developer>
<developer>
<name>Geir Magnusson</name>
<id>geirm</id>
<email></email>
<organization></organization>
</developer>
<developer>
<name>Craig McClanahan</name>
<id>craigmcc</id>
<email></email>
<organization></organization>
</developer>
<developer>
<name>Phil Steitz</name>
<id>psteitz</id>
<email></email>
<organization></organization>
</developer>
<developer>
<name>Arun M. Thomas</name>
<id>amamment</id>
<email></email>
<organization></organization>
</developer>
<developer>
<name>Rodney Waldhoff</name>
<id>rwaldhoff</id>
<email></email>
<organization></organization>
</developer>
<developer>
<name>Henri Yandell</name>
<id>bayard</id>
<email></email>
<organization></organization>
</developer>
<developer>
<name>James Carman</name>
<id>jcarman</id>
<email></email>
<organization></organization>
</developer>
<developer>
<name>Robert Burrell Donkin</name>
<id>rdonkin</id>
</developer>
</developers>
<contributors>
<contributor>
<name>Rafael U. C. Afonso</name>
</contributor>
<contributor>
<name>Max Rydahl Andersen</name>
</contributor>
<contributor>
<name>Federico Barbieri</name>
</contributor>
<contributor>
<name>Arron Bates</name>
</contributor>
<contributor>
<name>Nicola Ken Barozzi</name>
</contributor>
<contributor>
<name>Sebastian Bazley</name>
</contributor>
<contributor>
<name>Matt Benson</name>
</contributor>
<contributor>
<name>Ola Berg</name>
</contributor>
<contributor>
<name>Christopher Berry</name>
</contributor>
<contributor>
<name>Nathan Beyer</name>
</contributor>
<contributor>
<name>Janek Bogucki</name>
</contributor>
<contributor>
<name>Chuck Burdick</name>
</contributor>
<contributor>
<name>Dave Bryson</name>
</contributor>
<contributor>
<name>Julien Buret</name>
</contributor>
<contributor>
<name>Jonathan Carlson</name>
</contributor>
<contributor>
<name>Ram Chidambaram</name>
</contributor>
<contributor>
<name>Steve Clark</name>
</contributor>
<contributor>
<name>Eric Crampton</name>
</contributor>
<contributor>
<name>Dimiter Dimitrov</name>
</contributor>
<contributor>
<name>Peter Donald</name>
</contributor>
<contributor>
<name>Steve Downey</name>
</contributor>
<contributor>
<name>Rich Dougherty</name>
</contributor>
<contributor>
<name>Tom Dunham</name>
</contributor>
<contributor>
<name>Stefano Fornari</name>
</contributor>
<contributor>
<name>Andrew Freeman</name>
</contributor>
<contributor>
<name>Gerhard Froehlich</name>
</contributor>
<contributor>
<name>Paul Jack</name>
</contributor>
<contributor>
<name>Eric Johnson</name>
</contributor>
<contributor>
<name>Kent Johnson</name>
</contributor>
<contributor>
<name>Marc Johnson</name>
</contributor>
<contributor>
<name>Nissim Karpenstein</name>
</contributor>
<contributor>
<name>Shinobu Kawai</name>
</contributor>
<contributor>
<name>Mohan Kishore</name>
</contributor>
<contributor>
<name>Simon Kitching</name>
</contributor>
<contributor>
<name>Thomas Knych</name>
</contributor>
<contributor>
<name>Serge Knystautas</name>
</contributor>
<contributor>
<name>Peter KoBek</name>
</contributor>
<contributor>
<name>Jordan Krey</name>
</contributor>
<contributor>
<name>Olaf Krische</name>
</contributor>
<contributor>
<name>Guilhem Lavaux</name>
</contributor>
<contributor>
<name>Paul Legato</name>
</contributor>
<contributor>
<name>David Leppik</name>
</contributor>
<contributor>
<name>Berin Loritsch</name>
</contributor>
<contributor>
<name>Hendrik Maryns</name>
</contributor>
<contributor>
<name>Stefano Mazzocchi</name>
</contributor>
<contributor>
<name>Brian McCallister</name>
</contributor>
<contributor>
<name>Steven Melzer</name>
</contributor>
<contributor>
<name>Leon Messerschmidt</name>
</contributor>
<contributor>
<name>Mauricio S. Moura</name>
</contributor>
<contributor>
<name>Kasper Nielsen</name>
</contributor>
<contributor>
<name>Stanislaw Osinski</name>
</contributor>
<contributor>
<name>Alban Peignier</name>
</contributor>
<contributor>
<name>Mike Pettypiece</name>
</contributor>
<contributor>
<name>Steve Phelps</name>
</contributor>
<contributor>
<name>Ilkka Priha</name>
</contributor>
<contributor>
<name>Jonas Van Poucke</name>
</contributor>
<contributor>
<name>Will Pugh</name>
</contributor>
<contributor>
<name>Herve Quiroz</name>
</contributor>
<contributor>
<name>Daniel Rall</name>
</contributor>
<contributor>
<name>Robert Ribnitz</name>
</contributor>
<contributor>
<name>Huw Roberts</name>
</contributor>
<contributor>
<name>Henning P. Schmiedehausen</name>
</contributor>
<contributor>
<name>Howard Lewis Ship</name>
</contributor>
<contributor>
<name>Joe Raysa</name>
</contributor>
<contributor>
<name>Thomas Schapitz</name>
</contributor>
<contributor>
<name>Jon Schewe</name>
</contributor>
<contributor>
<name>Andreas Schlosser</name>
</contributor>
<contributor>
<name>Christian Siefkes</name>
</contributor>
<contributor>
<name>Michael Smith</name>
</contributor>
<contributor>
<name>Stephen Smith</name>
</contributor>
<contributor>
<name>Jan Sorensen</name>
</contributor>
<contributor>
<name>Jon S. Stevens </name>
</contributor>
<contributor>
<name>James Strachan</name>
</contributor>
<contributor>
<name>Leo Sutic</name>
</contributor>
<contributor>
<name>Chris Tilden</name>
</contributor>
<contributor>
<name>Neil O'Toole</name>
</contributor>
<contributor>
<name>Jeff Turner</name>
</contributor>
<contributor>
<name>Kazuya Ujihara</name>
</contributor>
<contributor>
<name>Jeff Varszegi</name>
</contributor>
<contributor>
<name>Ralph Wagner</name>
</contributor>
<contributor>
<name>David Weinrich</name>
</contributor>
<contributor>
<name>Dieter Wimberger</name>
</contributor>
<contributor>
<name>Serhiy Yevtushenko</name>
</contributor>
<contributor>
<name>Jason van Zyl</name>
</contributor>
</contributors>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
<properties>
<maven.compile.source>1.2</maven.compile.source>
<maven.compile.target>1.2</maven.compile.target>
<commons.componentid>collections</commons.componentid>
<commons.release.version>3.2.1</commons.release.version>
<commons.binary.suffix>-bin</commons.binary.suffix>
<commons.jira.id>COLLECTIONS</commons.jira.id>
<commons.jira.pid>12310465</commons.jira.pid>
</properties>
<build>
<sourceDirectory>src/java</sourceDirectory>
<testSourceDirectory>src/test</testSourceDirectory>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<includes>
<include>org/apache/commons/collections/TestAllPackages.java</include>
</includes>
</configuration>
</plugin>
<plugin>
<artifactId>maven-antrun-plugin</artifactId>
<executions>
<execution>
<phase>package</phase>
<configuration>
<tasks>
<ant antfile="build-testframework.xml" target="jar">
<property name="component.version" value="${project.version}"/>
<property name="test.classes" value="${project.build.directory}/test-classes"/>
<property name="dist.home" value="${project.build.directory}"/>
<property name="maven.compile.source" value="${maven.compile.source}"/>
<property name="maven.compile.target" value="${maven.compile.target}"/>
</ant>
</tasks>
</configuration>
<goals>
<goal>run</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<descriptors>
<descriptor>src/assembly/bin.xml</descriptor>
<descriptor>src/assembly/src.xml</descriptor>
</descriptors>
<tarLongFileMode>gnu</tarLongFileMode>
</configuration>
</plugin>
</plugins>
</build>
</project>

30
project.properties
View File

@ -1,22 +1,25 @@
# Copyright 2003-2005 The Apache Software Foundation # Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at
# #
# Licensed under the Apache License, Version 2.0 (the "License"); # http://www.apache.org/licenses/LICENSE-2.0
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
# #
# http://www.apache.org/licenses/LICENSE-2.0 # Unless required by applicable law or agreed to in writing, software
# # distributed under the License is distributed on an "AS IS" BASIS,
# Unless required by applicable law or agreed to in writing, software # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# distributed under the License is distributed on an "AS IS" BASIS, # See the License for the specific language governing permissions and
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # limitations under the License.
# See the License for the specific language governing permissions and
# limitations under the License. maven.repo.remote=http://repo1.maven.org/maven
maven.changelog.factory=org.apache.maven.svnlib.SvnChangeLogFactory maven.changelog.factory=org.apache.maven.svnlib.SvnChangeLogFactory
maven.xdoc.date=left maven.xdoc.date=left
maven.xdoc.version=${pom.currentVersion} maven.xdoc.version=${pom.currentVersion}
maven.xdoc.developmentProcessUrl=http://jakarta.apache.org/commons/charter.html maven.xdoc.developmentProcessUrl=http://commons.apache.org/charter.html
maven.xdoc.poweredby.image=maven-feather.png maven.xdoc.poweredby.image=maven-feather.png
maven.xdoc.copy.excludes=images/file.gif,images/folder-closed.gif,images/folder-open.gif,images/icon_alert.gif,images/icon_alertsml.gif,images/icon_arrowfolder1_sml.gif,images/icon_arrowfolder2_sml.gif,images/icon_arrowmembers1_sml.gif,images/icon_arrowmembers2_sml.gif,images/icon_arrowusergroups1_sml.gif,images/icon_arrowusergroups2_sml.gif,images/icon_confirmsml.gif,images/icon_help_lrg.gif,images/icon_infosml.gif,images/icon_members_sml.gif,images/icon_sortleft.gif,images/icon_sortright.gif,images/icon_usergroups_sml.gif,images/icon_waste_lrg.gif,images/icon_waste_sml.gif,images/none.png,images/nw_maj.gif,images/nw_maj_hi.gif,images/nw_med.gif,images/nw_med_hi.gif,images/nw_med_rond.gif,images/nw_min.gif,images/nw_min_036.gif,images/nw_min_hi.gif,images/poweredby_036.gif,images/product_logo.gif,images/se_maj_rond.gif,images/sw_min.gif,images/logos/** maven.xdoc.copy.excludes=images/file.gif,images/folder-closed.gif,images/folder-open.gif,images/icon_alert.gif,images/icon_alertsml.gif,images/icon_arrowfolder1_sml.gif,images/icon_arrowfolder2_sml.gif,images/icon_arrowmembers1_sml.gif,images/icon_arrowmembers2_sml.gif,images/icon_arrowusergroups1_sml.gif,images/icon_arrowusergroups2_sml.gif,images/icon_confirmsml.gif,images/icon_help_lrg.gif,images/icon_infosml.gif,images/icon_members_sml.gif,images/icon_sortleft.gif,images/icon_sortright.gif,images/icon_usergroups_sml.gif,images/icon_waste_lrg.gif,images/icon_waste_sml.gif,images/none.png,images/nw_maj.gif,images/nw_maj_hi.gif,images/nw_med.gif,images/nw_med_hi.gif,images/nw_med_rond.gif,images/nw_min.gif,images/nw_min_036.gif,images/nw_min_hi.gif,images/poweredby_036.gif,images/product_logo.gif,images/se_maj_rond.gif,images/sw_min.gif,images/logos/**
maven.xdoc.copy.excludes.classic=images/external-classic.png,images/help_logo.gif,images/icon_arrowfolderclosed1_sml.gif,images/icon_arrowwaste1_sml.gif,images/icon_arrowwaste2_sml.gif,images/icon_doc_lrg.gif,images/icon_doc_sml.gif,images/icon_error_lrg.gif,images/icon_folder_lrg.gif,images/icon_folder_sml.gif,images/icon_help_sml.gif,images/icon_info_lrg.gif,images/icon_members_lrg.gif,images/icon_sortdown.gif,images/icon_sortup.gif,images/icon_success_lrg.gif,images/icon_usergroups_lrg.gif,images/icon_arrowfolderopen2_sml.gif,images/icon_warning_lrg.gif,images/newwindow-classic.png,images/nw_maj_rond.gif,images/strich.gif,images/sw_maj_rond.gif,images/sw_med_rond.gif maven.xdoc.copy.excludes.classic=images/external-classic.png,images/help_logo.gif,images/icon_arrowfolderclosed1_sml.gif,images/icon_arrowwaste1_sml.gif,images/icon_arrowwaste2_sml.gif,images/icon_doc_lrg.gif,images/icon_doc_sml.gif,images/icon_error_lrg.gif,images/icon_folder_lrg.gif,images/icon_folder_sml.gif,images/icon_help_sml.gif,images/icon_info_lrg.gif,images/icon_members_lrg.gif,images/icon_sortdown.gif,images/icon_sortup.gif,images/icon_success_lrg.gif,images/icon_usergroups_lrg.gif,images/icon_arrowfolderopen2_sml.gif,images/icon_warning_lrg.gif,images/newwindow-classic.png,images/nw_maj_rond.gif,images/strich.gif,images/sw_maj_rond.gif,images/sw_med_rond.gif
@ -51,7 +54,8 @@ maven.compile.target = 1.1
# Specifies the source version for the Java compiler. # Specifies the source version for the Java compiler.
# Corresponds to the source attribute for the ant javac task. # Corresponds to the source attribute for the ant javac task.
# Valid values are 1.3, 1.4, 1.5. # Valid values are 1.3, 1.4, 1.5.
maven.compile.source = 1.3 maven.compile.source = 1.2
maven.compile.target = 1.2
maven.compile.debug=on maven.compile.debug=on
maven.compile.deprecation=off maven.compile.deprecation=off

60
project.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright 2002-2006 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -18,20 +19,20 @@
<pomVersion>3</pomVersion> <pomVersion>3</pomVersion>
<groupId>commons-collections</groupId> <groupId>commons-collections</groupId>
<artifactId>commons-collections</artifactId> <artifactId>commons-collections</artifactId>
<currentVersion>3.2</currentVersion> <currentVersion>3.2.1</currentVersion>
<inceptionYear>2001</inceptionYear> <inceptionYear>2001</inceptionYear>
<name>Collections</name> <name>Collections</name>
<shortDescription>Commons Collections</shortDescription> <shortDescription>Commons Collections</shortDescription>
<description>Types that extend and augment the Java Collections Framework.</description> <description>Types that extend and augment the Java Collections Framework.</description>
<logo>/images/logo.png</logo> <logo>/images/logo.png</logo>
<url>http://jakarta.apache.org/commons/collections/</url> <url>http://commons.apache.org/collections/</url>
<package>org.apache.commons.collections</package> <package>org.apache.commons.collections</package>
<organization> <organization>
<name>The Apache Software Foundation</name> <name>The Apache Software Foundation</name>
<url>http://jakarta.apache.org</url> <url>http://commons.apache.org/</url>
<logo>http://jakarta.apache.org/images/original-jakarta-logo.gif</logo> <logo>http://commons.apache.org/images/logo.png</logo>
</organization> </organization>
<licenses> <licenses>
@ -42,29 +43,29 @@
</license> </license>
</licenses> </licenses>
<gumpRepositoryId>jakarta</gumpRepositoryId> <gumpRepositoryId>commons</gumpRepositoryId>
<issueTrackingUrl>http://issues.apache.org/bugzilla/</issueTrackingUrl> <issueTrackingUrl>http://issues.apache.org/jira/</issueTrackingUrl>
<siteAddress>people.apache.org</siteAddress> <siteAddress>people.apache.org</siteAddress>
<siteDirectory>/www/jakarta.apache.org/commons/collections/</siteDirectory> <siteDirectory>/www/commons.apache.org/collections/</siteDirectory>
<distributionDirectory>/www/jakarta.apache.org/builds/jakarta-commons/collections/</distributionDirectory> <distributionDirectory>/www/people.apache.org/builds/commons/collections/</distributionDirectory>
<repository> <repository>
<connection>scm:svn:http://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk</connection> <connection>scm:svn:http://svn.apache.org/repos/asf/commons/proper/collections/trunk</connection>
<url>http://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk</url> <url>http://svn.apache.org/repos/asf/commons/proper/collections/trunk</url>
</repository> </repository>
<mailingLists> <mailingLists>
<mailingList> <mailingList>
<name>Commons Dev List</name> <name>Commons Dev List</name>
<subscribe>commons-dev-subscribe@jakarta.apache.org</subscribe> <subscribe>dev-subscribe@commons.apache.org</subscribe>
<unsubscribe>commons-dev-unsubscribe@jakarta.apache.org</unsubscribe> <unsubscribe>dev-unsubscribe@commons.apache.org</unsubscribe>
<archive>http://mail-archives.apache.org/eyebrowse/SummarizeList?listName=commons-dev@jakarta.apache.org</archive> <archive>http://mail-archives.apache.org/mod_mbox/commons-dev/</archive>
</mailingList> </mailingList>
<mailingList> <mailingList>
<name>Commons User List</name> <name>Commons User List</name>
<subscribe>commons-user-subscribe@jakarta.apache.org</subscribe> <subscribe>user-subscribe@commons.apache.org</subscribe>
<unsubscribe>commons-user-unsubscribe@jakarta.apache.org</unsubscribe> <unsubscribe>user-unsubscribe@commons.apache.org</unsubscribe>
<archive>http://mail-archives.apache.org/eyebrowse/SummarizeList?listName=commons-user@jakarta.apache.org</archive> <archive>http://mail-archives.apache.org/mod_mbox/commons-user/</archive>
</mailingList> </mailingList>
</mailingLists> </mailingLists>
@ -298,6 +299,9 @@
<contributor> <contributor>
<name>Berin Loritsch</name> <name>Berin Loritsch</name>
</contributor> </contributor>
<contributor>
<name>Hendrik Maryns</name>
</contributor>
<contributor> <contributor>
<name>Stefano Mazzocchi</name> <name>Stefano Mazzocchi</name>
</contributor> </contributor>
@ -448,7 +452,7 @@
</dependencies> </dependencies>
<build> <build>
<nagEmailAddress>commons-dev@jakarta.apache.org</nagEmailAddress> <nagEmailAddress>dev@commons.apache.org</nagEmailAddress>
<sourceDirectory>src/java</sourceDirectory> <sourceDirectory>src/java</sourceDirectory>
<unitTestSourceDirectory>src/test</unitTestSourceDirectory> <unitTestSourceDirectory>src/test</unitTestSourceDirectory>
<integrationUnitTestSourceDirectory/> <integrationUnitTestSourceDirectory/>
@ -470,18 +474,16 @@
</build> </build>
<reports> <reports>
<!--report>maven-changelog-plugin</report--> <!--report>maven-changes-plugin</report--> <!-- commented out until changes.xml exists -->
<!--report>maven-changes-plugin</report--> <report>maven-checkstyle-plugin</report>
<!--report>maven-developer-activity-plugin</report--> <report>maven-pmd-plugin</report>
<!--report>maven-file-activity-plugin</report--> <!--report>maven-findbugs-plugin</report--> <!-- commented out due to license -->
<!--report>maven-checkstyle-plugin</report-->
<report>maven-javadoc-plugin</report> <report>maven-javadoc-plugin</report>
<report>maven-jdepend-plugin</report> <report>maven-jdepend-plugin</report>
<report>maven-junit-report-plugin</report> <report>maven-junit-report-plugin</report>
<report>maven-jxr-plugin</report> <report>maven-jxr-plugin</report>
<report>maven-license-plugin</report> <report>maven-license-plugin</report>
<!--report>maven-cobertura-plugin</report> <!--report>maven-cobertura-plugin</report--> <!-- commented out due to license -->
<report>maven-jdiff-plugin</report-->
</reports> </reports>
</project> </project>

45
src/assembly/bin.xml Normal file
View File

@ -0,0 +1,45 @@
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<assembly>
<id>bin</id>
<formats>
<format>tar.gz</format>
<format>zip</format>
</formats>
<includeSiteDirectory>false</includeSiteDirectory>
<fileSets>
<fileSet>
<includes>
<include>LICENSE.txt</include>
<include>NOTICE.txt</include>
<include>README.txt</include>
<include>RELEASE-NOTES.html</include>
</includes>
</fileSet>
<fileSet>
<directory>target</directory>
<outputDirectory></outputDirectory>
<includes>
<include>*.jar</include>
</includes>
</fileSet>
<fileSet>
<directory>target/site/apidocs</directory>
<outputDirectory>apidocs</outputDirectory>
</fileSet>
</fileSets>
</assembly>

52
src/assembly/src.xml Normal file
View File

@ -0,0 +1,52 @@
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<assembly>
<id>src</id>
<formats>
<format>tar.gz</format>
<format>zip</format>
</formats>
<baseDirectory>${project.artifactId}-${project.version}-src</baseDirectory>
<fileSets>
<fileSet>
<includes>
<include>build.xml</include>
<include>build-testframework.xml</include>
<include>checkstyle.xml</include>
<include>DEVELOPERS-GUIDE.html</include>
<include>LICENSE.txt</include>
<include>maven.xml</include>
<include>NOTICE.txt</include>
<include>pom.xml</include>
<include>project.properties</include>
<include>project.xml</include>
<include>PROPOSAL.html</include>
<include>README.txt</include>
<include>RELEASE-NOTES.html</include>
</includes>
</fileSet>
<fileSet>
<directory>data</directory>
</fileSet>
<fileSet>
<directory>src</directory>
</fileSet>
<fileSet>
<directory>xdocs</directory>
</fileSet>
</fileSets>
</assembly>

BIN
src/site/resources/images/logo.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 14 KiB

46
src/site/site.xml Normal file
View File

@ -0,0 +1,46 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<project name="Collections">
<bannerRight>
<name>Commons Collections</name>
<src>/images/logo.png</src>
<href>/index.html</href>
</bannerRight>
<body>
<menu name="Collections">
<item name="Overview" href="/index.html"/>
<item name="Download" href="http://commons.apache.org/downloads/download_collections.cgi"/>
<item name="Users guide" href="/userguide.html"/>
<item name="History" href="/history.html"/>
<item name="Javadoc (3.2 release)" href="api-release/index.html"/>
</menu>
<menu name="Development">
<item name="Building" href="/building.html"/>
<item name="Mailing Lists" href="/mail-lists.html"/>
<item name="Issue Tracking" href="/issue-tracking.html"/>
<item name="Tasks" href="/tasks.html"/>
<item name="Proposal" href="/proposal.html"/>
<item name="Source Repository" href="/source-repository.html"/>
<item name="Javadoc (SVN latest)" href="apidocs/index.html"/>
</menu>
</body>
</project>

54
xdocs/building.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0"?> <?xml version="1.0"?>
<!-- <!--
Copyright 2005-2006 The Apache Software Foundation. Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -17,7 +18,7 @@ limitations under the License.
<document> <document>
<properties> <properties>
<title>Building</title> <title>Building</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author> <author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties> </properties>
<body> <body>
<!-- ================================================== --> <!-- ================================================== -->
@ -28,7 +29,7 @@ limitations under the License.
is used for site generation. is used for site generation.
</p> </p>
<p> <p>
You may also be interested in the <a href="release_3_2.html">v3.2 release notes</a>. You may also be interested in the <a href="release_3_2_1.html">v3.2.1 release notes</a>.
</p> </p>
</section> </section>
<!-- ================================================== --> <!-- ================================================== -->
@ -47,15 +48,44 @@ limitations under the License.
</p> </p>
</section> </section>
<!-- ================================================== --> <!-- ================================================== -->
<section name="Maven Goals"> <section name="Maven 2 Goals">
<p> <p>
To build the Javadocs, change into Collection's root directory and run "maven javadoc". The following <strong><i>Maven 2</i></strong> commands can be used to build collections:
The result will be in "target/docs/apidocs".
</p> </p>
<ul>
<li><code>mvn clean</code> - clean up</li>
<li><code>mvn test</code> - compile and run the unit tests</li>
<li><code>mvn site</code> - create io documentation</li>
<li><code>mvn package</code> - build the jar</li>
<li><code>mvn install</code> - build the jar and install in local maven repository</li>
<li><code>mvn site assembly:assembly</code> - Create the source and binary distributions</li>
</ul>
</section>
<!-- ================================================== -->
<section name="Maven 1 Goals">
<p> <p>
To build the full website, run "maven site". The following <strong><i>Maven 1</i></strong> commands can be used to build collections:
The result will be in "target/docs".
</p> </p>
<ul>
<li><code>maven clean</code> - clean up</li>
<li><code>maven test</code> - compile and run the unit tests</li>
<li><code>maven site</code> - create io documentation</li>
<li><code>maven jar</code> - build the jar</li>
<li><code>maven dist</code> - Create the source and binary distributions</li>
</ul>
</section>
<!-- ================================================== -->
<section name="Ant Goals">
<p>
The following <strong><i>Ant</i></strong> commands can be used to build collections:
</p>
<ul>
<li><code>ant clean</code> - clean up</li>
<li><code>ant test</code> - compile and run the unit tests</li>
<li><code>ant javadoc</code> - create javadocs</li>
<li><code>ant jar</code> - build the jar</li>
<li><code>ant dist</code> - Create the source and binary distributions</li>
</ul>
</section> </section>
<!-- ================================================== --> <!-- ================================================== -->
</body> </body>

13
xdocs/compatibility.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!-- <!--
Copyright 2004 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -19,7 +20,7 @@
<properties> <properties>
<title>Compatibility</title> <title>Compatibility</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author> <author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties> </properties>
<body> <body>

21
xdocs/cvs-usage.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0"?> <?xml version="1.0"?>
<!-- <!--
Copyright 2005 The Apache Software Foundation. Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -17,26 +18,26 @@ limitations under the License.
<document> <document>
<properties> <properties>
<title>Source repository</title> <title>Source repository</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author> <author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties> </properties>
<body> <body>
<!-- ================================================== --> <!-- ================================================== -->
<section name="Source repository"> <section name="Source repository">
<p> <p>
Jakarta Commons Collections is hosted on the Apache Apache Commons Collections is hosted on the Apache
<a href="http://subversion.tigris.org/">subversion</a> repository. <a href="http://subversion.tigris.org/">subversion</a> repository.
</p> </p>
<p> <p>
The project URL is:<br /> The project URL is:<br />
<code>http://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk</code> <code>http://svn.apache.org/repos/asf/commons/proper/collections/trunk</code>
</p> </p>
<p> <p>
The best way to view the repository is via the The best way to view the repository is via the
<a href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/collections/trunk/">subversion viewer</a>. <a href="http://svn.apache.org/viewvc/commons/proper/collections/trunk/">subversion viewer</a>.
</p> </p>
<p> <p>
The alternative is to use the The alternative is to use the
<a href="http://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk/">native subversion</a> display. <a href="http://svn.apache.org/repos/asf/commons/proper/collections/trunk/">native subversion</a> display.
</p> </p>
</section> </section>
<!-- ================================================== --> <!-- ================================================== -->

145
xdocs/download_collections.xml Normal file
View File

@ -0,0 +1,145 @@
<?xml version="1.0"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<!--
+======================================================================+
|**** ****|
|**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
|**** DO NOT EDIT DIRECTLY ****|
|**** ****|
+======================================================================+
| TEMPLATE FILE: download-page-template.xml |
| commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+======================================================================+
| |
| 1) Re-generate using: mvn commons:download-page |
| |
| 2) Set the following properties in the component's pom: |
| - commons.componentid (required, alphabetic, lower case) |
| - commons.release.version (required) |
| - commons.binary.suffix (optional) |
| (defaults to "-bin", set to "" for pre-maven2 releases) |
| |
| 3) Example Properties |
| |
| <properties> |
| <commons.componentid>math</commons.componentid> |
| <commons.release.version>1.2</commons.release.version> |
| </properties> |
| |
+======================================================================+
-->
<document>
<properties>
<title>Download Commons Collections</title>
<author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties>
<body>
<section name="Download Commons Collections">
<p>
We recommend you use a mirror to download our release
builds, but you <strong>must</strong> verify the integrity of
the downloaded files using signatures downloaded from our main
distribution directories. Recent releases (48 hours) may not yet
be available from the mirrors.
</p>
<p>
You are currently using <b>[preferred]</b>. If you
encounter a problem with this mirror, please select another
mirror. If all mirrors are failing, there are <i>backup</i>
mirrors (at the end of the mirrors list) that should be
available.
<br></br>
[if-any logo]<a href="[link]"><img align="right" src="[logo]" border="0"></img></a>[end]
</p>
<form action="[location]" method="get" id="SelectMirror">
<p>
Other mirrors:
<select name="Preferred">
[if-any http]
[for http]<option value="[http]">[http]</option>[end]
[end]
[if-any ftp]
[for ftp]<option value="[ftp]">[ftp]</option>[end]
[end]
[if-any backup]
[for backup]<option value="[backup]">[backup] (backup)</option>[end]
[end]
</select>
<input type="submit" value="Change"></input>
</p>
</form>
<p>
The <code>KEYS</code> link links to the code signing keys used to sign the product.
The <code>PGP</code> link downloads the OpenPGP compatible signature from our main site.
The <code>MD5</code> link downloads the checksum from the main site.
</p>
<p>
For more information concerning Commons Collections, see the
<a href="index.html" class="name">Commons Collections</a> web site.
</p>
<p>
<div class="links"><span class="link"><a href="http://www.apache.org/dist/commons/KEYS">KEYS</a></span></div>
<ul class="downloads">
<li class="group"><div class="links"><span class="label">Binary</span></div>
<ul>
<li class="download"><a href="[preferred]/commons/collections/binaries/commons-collections-3.2.1-bin.tar.gz">3.2.1.tar.gz</a>
<ul class="attributes">
<li><span class="md5">[<a href="http://www.apache.org/dist/commons/collections/binaries/commons-collections-3.2.1-bin.tar.gz.md5">md5</a>]</span>
<span class="pgp">[<a href="http://www.apache.org/dist/commons/collections/binaries/commons-collections-3.2.1-bin.tar.gz.asc">pgp</a>]</span>
</li>
</ul>
</li>
<li class="download"><a href="[preferred]/commons/collections/binaries/commons-collections-3.2.1-bin.zip">3.2.1.zip</a>
<ul class="attributes">
<li><span class="md5">[<a href="http://www.apache.org/dist/commons/collections/binaries/commons-collections-3.2.1-bin.zip.md5">md5</a>]</span>
<span class="pgp">[<a href="http://www.apache.org/dist/commons/collections/binaries/commons-collections-3.2.1-bin.zip.asc">pgp</a>]</span>
</li>
</ul>
</li>
</ul>
</li>
<li class="group"><div class="links"><span class="label">Source</span></div>
<ul>
<li class="download"><a href="[preferred]/commons/collections/source/commons-collections-3.2.1-src.tar.gz">3.2.1.tar.gz</a>
<ul class="attributes">
<li><span class="md5">[<a href="http://www.apache.org/dist/commons/collections/source/commons-collections-3.2.1-src.tar.gz.md5">md5</a>]</span>
<span class="pgp">[<a href="http://www.apache.org/dist/commons/collections/source/commons-collections-3.2.1-src.tar.gz.asc">pgp</a>]</span>
</li>
</ul>
</li>
<li class="download"><a href="[preferred]/commons/collections/source/commons-collections-3.2.1-src.zip">3.2.1.zip</a>
<ul class="attributes">
<li><span class="md5">[<a href="http://www.apache.org/dist/commons/collections/source/commons-collections-3.2.1-src.zip.md5">md5</a>]</span>
<span class="pgp">[<a href="http://www.apache.org/dist/commons/collections/source/commons-collections-3.2.1-src.zip.asc">pgp</a>]</span>
</li>
</ul>
</li>
</ul>
</li>
<li class="download"><a href="[preferred]/commons/collections/">browse download area</a></li>
<li><a href="http://archive.apache.org/dist/commons/collections/">archives...</a></li>
</ul>
</p>
</section>
</body>
</document>

17
xdocs/history.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!-- <!--
Copyright 2004-2006 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -19,7 +20,7 @@
<properties> <properties>
<title>History</title> <title>History</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author> <author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties> </properties>
<body> <body>
@ -99,6 +100,10 @@ Other changes included more classes implementing Serializable and a ReferenceIde
Notably MultiValueMap is a new more flexible implementation of MultiHashMap. Notably MultiValueMap is a new more flexible implementation of MultiHashMap.
</p> </p>
<p>
<b>Collections 3.2.1</b> Re-packaged release of v3.2 which is OSGi enabled.
</p>
</section> </section>
</body> </body>

30
xdocs/index.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0"?> <?xml version="1.0"?>
<!-- <!--
Copyright 2002-2006 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -17,7 +18,7 @@
<document> <document>
<properties> <properties>
<title>Home</title> <title>Home</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author> <author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties> </properties>
<body> <body>
<!-- ================================================== --> <!-- ================================================== -->
@ -59,24 +60,24 @@ as are various <a href="maven-reports.html">project reports</a>.
The JavaDoc API documents are available online: The JavaDoc API documents are available online:
</p> </p>
<ul> <ul>
<li>The <a href="api-release/index.html">current release 3.2</a></li> <li>The <a href="api-release/index.html">current release 3.2.1</a></li>
<li>The latest 2.x release - <a href="api-2.1.1/index.html">version 2.1.1</a></li> <li>The latest 2.x release - <a href="api-2.1.1/index.html">version 2.1.1</a></li>
<li>The <a href="apidocs/index.html">latest SVN</a></li> <li>The <a href="apidocs/index.html">latest SVN</a></li>
</ul> </ul>
<p> <p>
The <a href="cvs-usage.html">subversion repository</a> can be The <a href="cvs-usage.html">subversion repository</a> can be
<a href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/collections/trunk/">browsed</a>. <a href="http://svn.apache.org/viewvc/commons/proper/collections/trunk/">browsed</a>.
</p> </p>
</section> </section>
<!-- ================================================== --> <!-- ================================================== -->
<section name="Releases"> <section name="Releases">
<p> <p>
The latest version is v3.2. - The latest version is v3.2.1 -
<a href="http://jakarta.apache.org/site/downloads/downloads_commons-collections.cgi">Download now!</a><br /> <a href="http://commons.apache.org/downloads/download_collections.cgi">Download now!</a><br />
The <a href="release_3_2.html">release notes</a> are also available. The <a href="release_3_2_1.html">release notes</a> are also available.
</p> </p>
<p> <p>
For previous releases, see the <a href="http://archive.apache.org/dist/jakarta/commons/collections/">Apache Archive</a> For previous releases, see the <a href="http://archive.apache.org/dist/commons/collections/">Apache Archive</a>
</p> </p>
</section> </section>
<!-- ================================================== --> <!-- ================================================== -->
@ -89,9 +90,8 @@ Please remember that the lists are shared between all commons components,
so prefix your email by [collections]. so prefix your email by [collections].
</p> </p>
<p> <p>
Issues may be reported via <a href="issue-tracking.html">ASF Bugzilla</a>. Issues may be reported via <a href="issue-tracking.html">ASF JIRA</a>.
Please remember that Bugzilla is shared between all commons components, Please read the instructions carefully to submit a useful bug report or enhancement request.
so prefix your issue by [collections].
</p> </p>
</section> </section>
<!-- ================================================== --> <!-- ================================================== -->

139
xdocs/issue-tracking.xml
View File

@ -1,61 +1,102 @@
<?xml version="1.0"?> <?xml version="1.0"?>
<!-- <!--
Copyright 2005-2006 The Apache Software Foundation. Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific iouage governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.
--> -->
<!--
+======================================================================+
|**** ****|
|**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
|**** DO NOT EDIT DIRECTLY ****|
|**** ****|
+======================================================================+
| TEMPLATE FILE: issue-tracking-template.xml |
| commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+======================================================================+
| |
| 1) Re-generate using: mvn commons:jira-page |
| |
| 2) Set the following properties in the component's pom: |
| - commons.jira.id (required, alphabetic, upper case) |
| - commons.jira.pid (required, numeric) |
| |
| 3) Example Properties |
| |
| <properties> |
| <commons.jira.id>MATH</commons.jira.id> |
| <commons.jira.pid>12310485</commons.jira.pid> |
| </properties> |
| |
+======================================================================+
-->
<document> <document>
<properties> <properties>
<title>Issue tracking</title> <title>Commons Collections Issue tracking</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author> <author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties> </properties>
<body> <body>
<!-- ================================================== -->
<section name="Issue tracking"> <section name="Commons Collections Issue tracking">
<p> <p>
Commons Collections uses <a href="http://issues.apache.org/bugzilla/">ASF Bugzilla</a> for tracking issues. Commons Collections uses <a href="http://issues.apache.org/jira/">ASF JIRA</a> for tracking issues.
To use Bugzilla you may need to <a href="http://issues.apache.org/bugzilla/createaccount.cgi">create an account</a>. See the <a href="http://issues.apache.org/jira/browse/COLLECTIONS">Commons Collections JIRA project page</a>.
</p> </p>
<p>
If you would like to report a bug, or raise an enhancement request with <p>
Commons Collections please do the following: To use JIRA you may need to <a href="http://issues.apache.org/jira/secure/Signup!default.jspa">create an account</a>
<ol> (if you have previously created/updated Commons issues using Bugzilla an account will have been automatically
<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;product=Commons&amp;component=Collections">Search existing open bugs</a>. created and you can use the <a href="http://issues.apache.org/jira/secure/ForgotPassword!default.jspa">Forgot Password</a>
If you find your issue listed then please add a comment with your details.</li> page to get a new password).
<li><a href="http://mail-archives.apache.org/mod_mbox/jakarta-commons-dev/">Search the mailing list archive</a>. </p>
You may find your issue or idea has already been discussed.</li>
<li><a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Commons&amp;component=Collections&amp;version=3.2&amp;short_desc=%5Bcollections%5D%20%22Your%20subject%20heading%20here%22&amp;comment=Please%20provide%20details%20here.%20Its%20best%20to%20submit%20patches%20that%20alter%0D%0Aexisting%20file%20content%20in%20%22unified%20diff%22%20format.%20%0D%0A%0D%0ASubmissions%20that%20provide%20new%20files%20can%20be%20supplied%20as%20direct%20file%0D%0Aattachments%20or%20archives%20in%20zip%20or%20tar.gz%20format.%20please%20be%20kind%20%0D%0Aenough%20to%20identify%20the%20format%20of%20the%20attached%20archive%20as%20bugzilla%0D%0Atends%20to%20strip%20these%20characterstics%20by%20removing%20the%20files%20extension.">Submit a bug report or enhancement request</a>. <p>
Please prefix all new issues with [collections] in the summary line. If you would like to report a bug, or raise an enhancement request with
</li> Commons Collections please do the following:
</ol> <ol>
</p> <li><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310465&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">Search existing open bugs</a>.
<p> If you find your issue listed then please add a comment with your details.</li>
Please also remember these points: <li><a href="mail-lists.html">Search the mailing list archive(s)</a>.
<ul> You may find your issue or idea has already been discussed.</li>
<li>the more information you provide, the better we can help you</li> <li>Decide if your issue is a bug or an enhancement.</li>
<li>test cases are vital, particularly for any proposed enhancements</li> <li>Submit either a <a href="http://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310465&amp;issuetype=1&amp;priority=4&amp;assignee=-1">bug report</a>
<li>the developers of Commons Collections are all unpaid volunteers</li> or <a href="http://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310465&amp;issuetype=4&amp;priority=4&amp;assignee=-1">enhancement request</a>.</li>
</ul> </ol>
</p> </p>
<p>
You may also find these links useful: <p>
<ul> Please also remember these points:
<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;product=Commons&amp;component=Collections">All Open Collections bugs</a></li> <ul>
<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=RESOLVED&amp;bug_status=VERIFIED&amp;bug_status=CLOSED&amp;product=Commons&amp;component=Collections">All Closed Collections bugs</a></li> <li>the more information you provide, the better we can help you</li>
<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;bug_status=RESOLVED&amp;bug_status=VERIFIED&amp;bug_status=CLOSED&amp;product=Commons&amp;component=Collections">All Collections bugs</a></li> <li>test cases are vital, particularly for any proposed enhancements</li>
</ul> <li>the developers of Commons Collections are all unpaid volunteers</li>
</p> </ul>
</section> </p>
<!-- ================================================== -->
</body> <p>
For more information on subversion and creating patches see the
<a href="http://www.apache.org/dev/contributors.html">Apache Contributors Guide</a>.
</p>
<p>
You may also find these links useful:
<ul>
<li><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310465&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">All Open Commons Collections bugs</a></li>
<li><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310465&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=5&amp;status=6">All Resolved Commons Collections bugs</a></li>
<li><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310465&amp;sorter/field=issuekey&amp;sorter/order=DESC">All Commons Collections bugs</a></li>
</ul>
</p>
</section>
</body>
</document> </document>

21
xdocs/navigation.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!-- <!--
Copyright 2002-2006 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -14,22 +15,22 @@
See the License for the specific language governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.
--> -->
<!DOCTYPE org.apache.commons.menus SYSTEM 'http://jakarta.apache.org/commons/build/maven-build.dtd'> <!DOCTYPE org.apache.commons.menus SYSTEM 'http://commons.apache.org/build/maven-build.dtd'>
<project name="Commons Collections"> <project name="Commons Collections">
<title>Commons Collections</title> <title>Commons Collections</title>
<body> <body>
<links> <links>
<item name="Jakarta Commons" href="http://jakarta.apache.org/commons/"/> <item name="Apache Commons" href="http://commons.apache.org/"/>
</links> </links>
<menu name="Commons Collections"> <menu name="Commons Collections">
<item name="Overview" href="/index.html"/> <item name="Overview" href="/index.html"/>
<item name="Download" href="http://jakarta.apache.org/site/downloads/downloads_commons-collections.cgi"/> <item name="Download" href="http://commons.apache.org/downloads/download_collections.cgi"/>
<item name="User guide" href="/userguide.html"/> <item name="User guide" href="/userguide.html"/>
<item name="History" href="/history.html"/> <item name="History" href="/history.html"/>
<item name="Javadoc (3.2 release)" href="api-release/index.html"/> <item name="Javadoc (3.2.1 release)" href="api-release/index.html"/>
</menu> </menu>
<menu name="Development"> <menu name="Development">
@ -38,7 +39,7 @@
<item name="Team" href="/team-list.html"/> <item name="Team" href="/team-list.html"/>
<item name="Tasks" href="/tasks.html"/> <item name="Tasks" href="/tasks.html"/>
<item name="Proposal" href="/proposal.html"/> <item name="Proposal" href="/proposal.html"/>
<item name="SVN repository" href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/collections/trunk/"/> <item name="SVN repository" href="http://svn.apache.org/viewvc/commons/proper/collections/trunk/"/>
<item name="Javadoc (SVN latest)" href="apidocs/index.html"/> <item name="Javadoc (SVN latest)" href="apidocs/index.html"/>
</menu> </menu>

47
xdocs/pick.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!-- <!--
Copyright 2003-2004 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -19,7 +20,7 @@
<properties> <properties>
<title>Choosing a collection</title> <title>Choosing a collection</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author> <author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties> </properties>
<body> <body>
@ -89,19 +90,19 @@ For example you could convert a country code to text <i>but not</i> text to coun
<h3>BidiMap interface</h3> <h3>BidiMap interface</h3>
<p> <p>
The <a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/BidiMap.html">BidiMap</a> interface and implementations in Commons Collections allow you to lookup data in both directions. There are three implementations: The <a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/BidiMap.html">BidiMap</a> interface and implementations in Commons Collections allow you to lookup data in both directions. There are three implementations:
<table> <table>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/DualHashBidiMap.html">DualHashBidiMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/DualHashBidiMap.html">DualHashBidiMap</a></td>
<td>Uses two <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/HashMap.html">HashMap</a> objects internally. This implementation is a useful general purpose BidiMap that can store any object. The objects are stored in any order, and the order may change over time.</td> <td>Uses two <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/HashMap.html">HashMap</a> objects internally. This implementation is a useful general purpose BidiMap that can store any object. The objects are stored in any order, and the order may change over time.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/DualTreeBidiMap.html">DualTreeBidiMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/DualTreeBidiMap.html">DualTreeBidiMap</a></td>
<td>Uses two <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/TreeMap.html">TreeMap</a> objects internally which means that keys and values must implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. If considering this class, the TreeBidiMap is usually a better choice. However, this is the only implementation of the <a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/SortedBidiMap.html">SortedBidiMap</a> interface.</td> <td>Uses two <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/TreeMap.html">TreeMap</a> objects internally which means that keys and values must implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. If considering this class, the TreeBidiMap is usually a better choice. However, this is the only implementation of the <a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/SortedBidiMap.html">SortedBidiMap</a> interface.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/TreeBidiMap.html">TreeBidiMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/TreeBidiMap.html">TreeBidiMap</a></td>
<td>Dedicated implementation that requires keys and values to implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. This is an efficient implementation using a data structure that avoids duplicating data. The keys and values are held and viewed in sorted order, and the class implements the <a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/OrderedBidiMap.html">OrderedBidiMap</a> interface.</td> <td>Dedicated implementation that requires keys and values to implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. This is an efficient implementation using a data structure that avoids duplicating data. The keys and values are held and viewed in sorted order, and the class implements the <a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/OrderedBidiMap.html">OrderedBidiMap</a> interface.</td>
</tr> </tr>
</table> </table>
</p> </p>
@ -119,11 +120,11 @@ The <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/Map.html">Map</a> i
<td>This map is the most commonly used and fastest implementation. It is suitable for most situations and can store any object. Objects are stored in any order, and the order may change over time.</td> <td>This map is the most commonly used and fastest implementation. It is suitable for most situations and can store any object. Objects are stored in any order, and the order may change over time.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/HashedMap.html">HashedMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/HashedMap.html">HashedMap</a></td>
<td>The Commons Collections hash map implementation which is very similar in design to HashMap, but also supports easy iteration via a <a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/MapIterator.html">MapIterator</a>. This implementation is also designed to be subclassed. Use this map if you want to use the extra iterator, or to subclass. Otherwise, there is no advantage (or disadvantage) compared to the JDK HashMap.</td> <td>The Commons Collections hash map implementation which is very similar in design to HashMap, but also supports easy iteration via a <a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/MapIterator.html">MapIterator</a>. This implementation is also designed to be subclassed. Use this map if you want to use the extra iterator, or to subclass. Otherwise, there is no advantage (or disadvantage) compared to the JDK HashMap.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/IdentityMap.html">IdentityMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/IdentityMap.html">IdentityMap</a></td>
<td>This map operates exactly as per HashedMap but compares keys and values using == not .equals().</td> <td>This map operates exactly as per HashedMap but compares keys and values using == not .equals().</td>
</tr> </tr>
<tr> <tr>
@ -135,7 +136,7 @@ The <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/Map.html">Map</a> i
<td>This map ensures that the keys are always sorted, and iteration order is consistent. All keys must implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. This map should be used if you need the map to be sorted.</td> <td>This map ensures that the keys are always sorted, and iteration order is consistent. All keys must implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. This map should be used if you need the map to be sorted.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/LinkedMap.html">LinkedMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/LinkedMap.html">LinkedMap</a></td>
<td>This map maintains the order that each object is added to the map. When the map is viewed via an iterator, the insertion order will be seen. This map should be used if you need to retain the insertion order.</td> <td>This map maintains the order that each object is added to the map. When the map is viewed via an iterator, the insertion order will be seen. This map should be used if you need to retain the insertion order.</td>
</tr> </tr>
<tr> <tr>
@ -143,15 +144,15 @@ The <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/Map.html">Map</a> i
<td>This map, available from JDK 1.4, maintains the order that each object is added to the map. When the map is viewed via an iterator, the insertion order will be seen. Commons collections' LinkedMap provides the same functionality for JDK1.2 onwards and provides a MapIterator.</td> <td>This map, available from JDK 1.4, maintains the order that each object is added to the map. When the map is viewed via an iterator, the insertion order will be seen. Commons collections' LinkedMap provides the same functionality for JDK1.2 onwards and provides a MapIterator.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ListOrderedMap.html">ListOrderedMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ListOrderedMap.html">ListOrderedMap</a></td>
<td>This map decorates another map to maintains the order that each object is added to the map. The order is maintained using a list. This map should be used if you need to retain the insertion order but you also need the special features of another map.</td> <td>This map decorates another map to maintains the order that each object is added to the map. The order is maintained using a list. This map should be used if you need to retain the insertion order but you also need the special features of another map.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/LRUMap.html">LRUMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/LRUMap.html">LRUMap</a></td>
<td>This map places a maximum size limit on the map and removes the least recently used (LRU) key-value when it is full. This map should be used for caches where you want to limit the maximum memory size used, and are happy with the least recently used algorithm for removals.</td> <td>This map places a maximum size limit on the map and removes the least recently used (LRU) key-value when it is full. This map should be used for caches where you want to limit the maximum memory size used, and are happy with the least recently used algorithm for removals.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ReferenceMap.html">ReferenceMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ReferenceMap.html">ReferenceMap</a></td>
<td>This map enables keys and values to be garbage collected whilst still held in the map. This can be useful for building memory sensitive caches. This map should be used for caches where you want to allow garbage collection from the map.</td> <td>This map enables keys and values to be garbage collected whilst still held in the map. This can be useful for building memory sensitive caches. This map should be used for caches where you want to allow garbage collection from the map.</td>
</tr> </tr>
<tr> <tr>
@ -159,19 +160,19 @@ The <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/Map.html">Map</a> i
<td>This map stores each key-value pair with a key that can be garbage collected. This can be useful for building memory sensitive caches. ReferenceMap provides the same functionality but with much more flexibility.</td> <td>This map stores each key-value pair with a key that can be garbage collected. This can be useful for building memory sensitive caches. ReferenceMap provides the same functionality but with much more flexibility.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ReferenceIdentityMap.html">ReferenceIdentityMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ReferenceIdentityMap.html">ReferenceIdentityMap</a></td>
<td>This map operates exactly as per ReferenceMap but compares keys and values using == not .equals().</td> <td>This map operates exactly as per ReferenceMap but compares keys and values using == not .equals().</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/SingletonMap.html">SingletonMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/SingletonMap.html">SingletonMap</a></td>
<td>This map is restricted to storing one key-value pair. It may contain no more than and no less than one pair. It provides a MapIterator. This map should be used if you want to return one key-value pair and must use the Map interface.</td> <td>This map is restricted to storing one key-value pair. It may contain no more than and no less than one pair. It provides a MapIterator. This map should be used if you want to return one key-value pair and must use the Map interface.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/Flat3Map.html">Flat3Map</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/Flat3Map.html">Flat3Map</a></td>
<td>This map is optimised to store one, two or three key-value pairs and outperforms HashMap at these sizes. For size four and above performance is about 5% slower than HashMap. This map also has good garbage collection characteristics when below size four. It provides a MapIterator. This map should be used if are 99% sure that the map will be size three or less.</td> <td>This map is optimised to store one, two or three key-value pairs and outperforms HashMap at these sizes. For size four and above performance is about 5% slower than HashMap. This map also has good garbage collection characteristics when below size four. It provides a MapIterator. This map should be used if are 99% sure that the map will be size three or less.</td>
</tr> </tr>
<tr> <tr>
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/StaticBucketMap.html">StaticBucketMap</a></td> <td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/StaticBucketMap.html">StaticBucketMap</a></td>
<td>This map is optimised to work well in a heavily loaded multi-threaded environment. It provides synchronization internally, locking on a per 'bucket' basis, where the buckets are fixed at construction time. You should use this class if you can predict the size of the map and you are working in a very intensive multi-threaded environment.</td> <td>This map is optimised to work well in a heavily loaded multi-threaded environment. It provides synchronization internally, locking on a per 'bucket' basis, where the buckets are fixed at construction time. You should use this class if you can predict the size of the map and you are working in a very intensive multi-threaded environment.</td>
</tr> </tr>
</table> </table>

19
xdocs/proposal.xml
View File

@ -1,3 +1,20 @@
<?xml version="1.0"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document> <document>
<properties> <properties>
<title>Proposal</title> <title>Proposal</title>
@ -45,7 +62,7 @@
production deployment. It utilizes the JUnit unit testing framework for production deployment. It utilizes the JUnit unit testing framework for
developing and executing unit tests, but this is of interest only to developing and executing unit tests, but this is of interest only to
developers of the component. Collections will also be a dependency for developers of the component. Collections will also be a dependency for
several future proposed components for the Jakarta Commons subproject. </p> several future proposed components for the Apache Commons subproject. </p>
<p>No external configuration files are utilized.</p> <p>No external configuration files are utilized.</p>

13
xdocs/release_3_2.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0"?> <?xml version="1.0"?>
<!-- <!--
Copyright 2006 The Apache Software Foundation. Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -17,7 +18,7 @@ limitations under the License.
<document> <document>
<properties> <properties>
<title>Release notes for v3.2</title> <title>Release notes for v3.2</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author> <author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties> </properties>
<body> <body>

49
xdocs/release_3_2_1.xml Normal file
View File

@ -0,0 +1,49 @@
<?xml version="1.0"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<title>Release notes for v3.2.1</title>
<author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties>
<body>
<section name="Release notes for v3.2.1">
<p>
These are the release notes for Commons Collections v3.2.1:
</p>
<hr />
<p>
Commons collections is a project to develop and maintain collection classes
based on and inspired by the JDK collection framework.
This project is JDK1.2 compatible, and does not use JDK1.5 generics.
</p>
<p>
This v3.2.1 release is simply a re-packaging of the v3.2 release, with appropriate
OSGi meta data added to the jar's manifest file.
</p>
<hr />
<center><h3>COMPATIBILITY</h3></center>
<p>
This release is fully source and binary compatible with v3.2. For changes since the
v3.1 see the <a href="release_3_2.html">v3.2 Release Notes</a>.
</p>
</section>
</body>
</document>

2
xdocs/style/project.css
View File

@ -1 +1 @@
@import url("http://jakarta.apache.org/style/jakarta-maven.css"); @import url("http://commons.apache.org/style/commons-maven.css");

13
xdocs/tasks.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0"?> <?xml version="1.0"?>
<!-- <!--
Copyright 2003-2006 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -19,7 +20,7 @@
<properties> <properties>
<title>Tasks outstanding</title> <title>Tasks outstanding</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author> <author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties> </properties>
<body> <body>

13
xdocs/userguide.xml
View File

@ -1,10 +1,11 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!-- <!--
Copyright 2003-2005 The Apache Software Foundation Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
Licensed under the Apache License, Version 2.0 (the "License"); this work for additional information regarding copyright ownership.
you may not use this file except in compliance with the License. The ASF licenses this file to You under the Apache License, Version 2.0
You may obtain a copy of the License at (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
@ -19,7 +20,7 @@
<properties> <properties>
<title>User guide</title> <title>User guide</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author> <author email="dev@commons.apache.org">Commons Documentation Team</author>
</properties> </properties>
<body> <body>