From 404ad88cdc2e837b357fee85702c020403af375c Mon Sep 17 00:00:00 2001
From: Michael Smith <mas@apache.org>
Date: Wed, 12 Jun 2002 03:59:17 +0000
Subject: [PATCH] Added @since tags for classes introduced in the 1.0 and 2.0
 collection releases.  I did not add @since tags to classes added since the
 2.0 release, because I'm not certain whether the next release will be 2.1 or
 3.0 or whatever.

git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk@130715 13f79535-47bb-0310-9956-ffa450edef68
---
 .../org/apache/commons/collections/ArrayEnumeration.java | 7 ++++---
 .../org/apache/commons/collections/ArrayIterator.java    | 9 +++++----
 src/java/org/apache/commons/collections/ArrayStack.java  | 9 +++++----
 src/java/org/apache/commons/collections/Bag.java         | 7 ++++---
 src/java/org/apache/commons/collections/BeanMap.java     | 7 ++++---
 src/java/org/apache/commons/collections/BinaryHeap.java  | 7 ++++---
 src/java/org/apache/commons/collections/Closure.java     | 7 ++++---
 .../org/apache/commons/collections/CollectionUtils.java  | 9 +++++----
 .../apache/commons/collections/CursorableLinkedList.java | 9 +++++----
 .../org/apache/commons/collections/DefaultMapBag.java    | 7 ++++---
 .../org/apache/commons/collections/DefaultMapEntry.java  | 7 ++++---
 .../org/apache/commons/collections/DoubleOrderedMap.java | 7 ++++---
 .../apache/commons/collections/EnumerationIterator.java  | 7 ++++---
 .../apache/commons/collections/ExtendedProperties.java   | 9 +++++----
 .../org/apache/commons/collections/FastArrayList.java    | 9 +++++----
 src/java/org/apache/commons/collections/FastHashMap.java | 9 +++++----
 src/java/org/apache/commons/collections/FastTreeMap.java | 9 +++++----
 .../org/apache/commons/collections/FilterIterator.java   | 7 ++++---
 .../apache/commons/collections/FilterListIterator.java   | 9 +++++----
 src/java/org/apache/commons/collections/HashBag.java     | 7 ++++---
 .../apache/commons/collections/IteratorEnumeration.java  | 7 ++++---
 src/java/org/apache/commons/collections/LRUMap.java      | 7 ++++---
 src/java/org/apache/commons/collections/ListUtils.java   | 7 ++++---
 src/java/org/apache/commons/collections/MapUtils.java    | 8 ++++----
 .../org/apache/commons/collections/MultiHashMap.java     | 7 ++++---
 src/java/org/apache/commons/collections/MultiMap.java    | 7 ++++---
 src/java/org/apache/commons/collections/Predicate.java   | 7 ++++---
 .../org/apache/commons/collections/PriorityQueue.java    | 7 ++++---
 .../org/apache/commons/collections/ProxyIterator.java    | 9 +++++----
 .../apache/commons/collections/ProxyListIterator.java    | 9 +++++----
 src/java/org/apache/commons/collections/ProxyMap.java    | 8 ++++----
 .../org/apache/commons/collections/SequencedHashMap.java | 7 ++++---
 .../apache/commons/collections/SingletonIterator.java    | 9 +++++----
 .../org/apache/commons/collections/SoftRefHashMap.java   | 7 ++++---
 src/java/org/apache/commons/collections/SortedBag.java   | 8 +++++---
 src/java/org/apache/commons/collections/StringStack.java | 3 ++-
 .../commons/collections/SynchronizedPriorityQueue.java   | 7 ++++---
 .../apache/commons/collections/TransformIterator.java    | 7 ++++---
 src/java/org/apache/commons/collections/Transformer.java | 7 ++++---
 src/java/org/apache/commons/collections/TreeBag.java     | 7 ++++---
 .../collections/comparators/ComparableComparator.java    | 3 ++-
 .../commons/collections/comparators/ComparatorChain.java | 7 ++++---
 .../collections/comparators/ReverseComparator.java       | 3 ++-
 43 files changed, 179 insertions(+), 137 deletions(-)

diff --git a/src/java/org/apache/commons/collections/ArrayEnumeration.java b/src/java/org/apache/commons/collections/ArrayEnumeration.java
index efeb019ba..1a648f289 100644
--- a/src/java/org/apache/commons/collections/ArrayEnumeration.java
+++ b/src/java/org/apache/commons/collections/ArrayEnumeration.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/ArrayEnumeration.java,v 1.4 2002/03/24 21:50:24 mas Exp $
- * $Revision: 1.4 $
- * $Date: 2002/03/24 21:50:24 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/ArrayEnumeration.java,v 1.5 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.5 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -67,6 +67,7 @@ import java.util.NoSuchElementException;
 /**
  * Enumeration wrapper for array.
  * 
+ * @since 1.0
  * @author <a href="mailto:donaldp@apache.org">Peter Donald</a>
  * @deprecated This class has significant overlap with ArrayIterator,
  *             and Collections focuses mainly on Java2-style
diff --git a/src/java/org/apache/commons/collections/ArrayIterator.java b/src/java/org/apache/commons/collections/ArrayIterator.java
index 3ce933fa2..ef14ccaa1 100644
--- a/src/java/org/apache/commons/collections/ArrayIterator.java
+++ b/src/java/org/apache/commons/collections/ArrayIterator.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/ArrayIterator.java,v 1.12 2002/03/19 01:33:12 mas Exp $
- * $Revision: 1.12 $
- * $Date: 2002/03/19 01:33:12 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/ArrayIterator.java,v 1.13 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.13 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -66,10 +66,11 @@ import java.util.NoSuchElementException;
 
 /** Implements an {@link Iterator} over an array of objects.
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   * @author Mauricio S. Moura
   * @author <a href="mailto:mas@apache.org">Michael A. Smith</a>
-  * @version $Revision: 1.12 $
+  * @version $Revision: 1.13 $
   */
 public class ArrayIterator implements Iterator {
     
diff --git a/src/java/org/apache/commons/collections/ArrayStack.java b/src/java/org/apache/commons/collections/ArrayStack.java
index 7df05c53f..a7335ea88 100644
--- a/src/java/org/apache/commons/collections/ArrayStack.java
+++ b/src/java/org/apache/commons/collections/ArrayStack.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/ArrayStack.java,v 1.4 2002/02/10 08:07:42 jstrachan Exp $
- * $Revision: 1.4 $
- * $Date: 2002/02/10 08:07:42 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/ArrayStack.java,v 1.5 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.5 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -74,8 +74,9 @@ import java.util.Stack; // only used in javadoc comments, javadoc won't find it
  * is therefore operates faster in environments where you do not need to
  * worry about multiple thread contention.
  *
+ * @since 1.0
  * @author Craig R. McClanahan
- * @version $Revision: 1.4 $ $Date: 2002/02/10 08:07:42 $
+ * @version $Revision: 1.5 $ $Date: 2002/06/12 03:59:15 $
  * @see java.util.Stack
  */
 
diff --git a/src/java/org/apache/commons/collections/Bag.java b/src/java/org/apache/commons/collections/Bag.java
index 2f3fc7706..4f15c50c4 100644
--- a/src/java/org/apache/commons/collections/Bag.java
+++ b/src/java/org/apache/commons/collections/Bag.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Bag.java,v 1.5 2002/03/13 06:00:20 mas Exp $
- * $Revision: 1.5 $
- * $Date: 2002/03/13 06:00:20 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Bag.java,v 1.6 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.6 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -71,6 +71,7 @@ import java.util.Set;
  * c}</code>.  Calling {@link #getCount(Object)} on <code>a</code> would return
  * 2, while calling {@link #uniqueSet()} would return <code>{a, b, c}</code>.
  *
+ * @since 2.0
  * @author Chuck Burdick
  **/
 public interface Bag extends Collection {
diff --git a/src/java/org/apache/commons/collections/BeanMap.java b/src/java/org/apache/commons/collections/BeanMap.java
index 759f3755b..7e31a961d 100644
--- a/src/java/org/apache/commons/collections/BeanMap.java
+++ b/src/java/org/apache/commons/collections/BeanMap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/BeanMap.java,v 1.10 2002/03/24 22:00:55 mas Exp $
- * $Revision: 1.10 $
- * $Date: 2002/03/24 22:00:55 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/BeanMap.java,v 1.11 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.11 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -84,6 +84,7 @@ import java.util.Set;
   * If an exception occurs during attempts to get or set a property then the
   * property is considered non existent in the Map
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   */
 
diff --git a/src/java/org/apache/commons/collections/BinaryHeap.java b/src/java/org/apache/commons/collections/BinaryHeap.java
index d69f2a1c8..d19ba4e2b 100644
--- a/src/java/org/apache/commons/collections/BinaryHeap.java
+++ b/src/java/org/apache/commons/collections/BinaryHeap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/BinaryHeap.java,v 1.6 2002/03/19 04:49:00 mas Exp $
- * $Revision: 1.6 $
- * $Date: 2002/03/19 04:49:00 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/BinaryHeap.java,v 1.7 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.7 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -66,6 +66,7 @@ import java.util.Comparator;
 /**
  * Binary heap implementation of {@link PriorityQueue}.
  *
+ * @since 1.0
  * @author  <a href="mailto:donaldp@apache.org">Peter Donald</a>
  * @author  <a href="mailto:ram.chidambaram@telus.com">Ram Chidambaram</a>
  * @author  <a href="mailto:mas@apache.org">Michael A. Smith</a>
diff --git a/src/java/org/apache/commons/collections/Closure.java b/src/java/org/apache/commons/collections/Closure.java
index 76709cc42..ab16038a8 100644
--- a/src/java/org/apache/commons/collections/Closure.java
+++ b/src/java/org/apache/commons/collections/Closure.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Closure.java,v 1.3 2002/03/13 05:40:30 mas Exp $
- * $Revision: 1.3 $
- * $Date: 2002/03/13 05:40:30 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Closure.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -64,6 +64,7 @@ package org.apache.commons.collections;
   * from inside some block, function or iteration which operates on an input 
   * object.
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   */
 public interface Closure {
diff --git a/src/java/org/apache/commons/collections/CollectionUtils.java b/src/java/org/apache/commons/collections/CollectionUtils.java
index d69d0cbe9..260b87bae 100644
--- a/src/java/org/apache/commons/collections/CollectionUtils.java
+++ b/src/java/org/apache/commons/collections/CollectionUtils.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/CollectionUtils.java,v 1.7 2002/02/10 08:07:42 jstrachan Exp $
- * $Revision: 1.7 $
- * $Date: 2002/02/10 08:07:42 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/CollectionUtils.java,v 1.8 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.8 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -77,7 +77,8 @@ import java.util.Set;
  *
  * @author Rodney Waldhoff
  *
- * @version $Id: CollectionUtils.java,v 1.7 2002/02/10 08:07:42 jstrachan Exp $
+ * @since 1.0
+ * @version $Id: CollectionUtils.java,v 1.8 2002/06/12 03:59:15 mas Exp $
  */
 public class CollectionUtils {
 
diff --git a/src/java/org/apache/commons/collections/CursorableLinkedList.java b/src/java/org/apache/commons/collections/CursorableLinkedList.java
index 0489ece90..7c04cdb8a 100644
--- a/src/java/org/apache/commons/collections/CursorableLinkedList.java
+++ b/src/java/org/apache/commons/collections/CursorableLinkedList.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/CursorableLinkedList.java,v 1.5 2002/03/20 05:16:24 mas Exp $
- * $Revision: 1.5 $
- * $Date: 2002/03/20 05:16:24 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/CursorableLinkedList.java,v 1.6 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.6 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -90,8 +90,9 @@ import java.lang.UnsupportedOperationException; // stops a javadoc warning
  * <p>
  * <b>Note that this implementation is not synchronized.</b>
  *
+ * @since 1.0
  * @author Rodney Waldhoff
- * @version $Id: CursorableLinkedList.java,v 1.5 2002/03/20 05:16:24 mas Exp $
+ * @version $Id: CursorableLinkedList.java,v 1.6 2002/06/12 03:59:15 mas Exp $
  * @see java.util.LinkedList
  */
 public class CursorableLinkedList implements List, Serializable {
diff --git a/src/java/org/apache/commons/collections/DefaultMapBag.java b/src/java/org/apache/commons/collections/DefaultMapBag.java
index babc2bc09..697d1213c 100644
--- a/src/java/org/apache/commons/collections/DefaultMapBag.java
+++ b/src/java/org/apache/commons/collections/DefaultMapBag.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/DefaultMapBag.java,v 1.2 2002/06/11 02:41:47 mas Exp $
- * $Revision: 1.2 $
- * $Date: 2002/06/11 02:41:47 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/DefaultMapBag.java,v 1.3 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.3 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -78,6 +78,7 @@ import java.util.Set;
  * specifying a map instance that will be used to store the contents of 
  * the bag. 
  *
+ * @since 2.0
  * @author Chuck Burdick
  * @author <a href="mailto:mas@apache.org">Michael A. Smith</a>
  **/
diff --git a/src/java/org/apache/commons/collections/DefaultMapEntry.java b/src/java/org/apache/commons/collections/DefaultMapEntry.java
index 774788c62..c79cf274e 100644
--- a/src/java/org/apache/commons/collections/DefaultMapEntry.java
+++ b/src/java/org/apache/commons/collections/DefaultMapEntry.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/DefaultMapEntry.java,v 1.5 2002/03/20 05:16:24 mas Exp $
- * $Revision: 1.5 $
- * $Date: 2002/03/20 05:16:24 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/DefaultMapEntry.java,v 1.6 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.6 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -65,6 +65,7 @@ import java.util.Map.Entry; // to keep javadoc from spewing warnings
 
 /** A default implementation of {@link Map.Entry}
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   * @author <a href="mailto:mas@apache.org">Michael A. Smith</a>
   */
diff --git a/src/java/org/apache/commons/collections/DoubleOrderedMap.java b/src/java/org/apache/commons/collections/DoubleOrderedMap.java
index 94009a4bb..1580dedb5 100644
--- a/src/java/org/apache/commons/collections/DoubleOrderedMap.java
+++ b/src/java/org/apache/commons/collections/DoubleOrderedMap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/DoubleOrderedMap.java,v 1.1 2002/01/20 04:36:08 craigmcc Exp $
- * $Revision: 1.1 $
- * $Date: 2002/01/20 04:36:08 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/DoubleOrderedMap.java,v 1.2 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.2 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -134,6 +134,7 @@ import java.util.*;
 * Collection valuesByValue() returns the values in a Collection whose
 * iterator will iterate over the values in ascending order.<p>
 *
+* @since 2.0
 * @author Marc Johnson (marcj at users dot sourceforge dot net)
 */
 
diff --git a/src/java/org/apache/commons/collections/EnumerationIterator.java b/src/java/org/apache/commons/collections/EnumerationIterator.java
index b7bf5db53..c60fa2104 100644
--- a/src/java/org/apache/commons/collections/EnumerationIterator.java
+++ b/src/java/org/apache/commons/collections/EnumerationIterator.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/EnumerationIterator.java,v 1.3 2002/02/10 08:07:42 jstrachan Exp $
- * $Revision: 1.3 $
- * $Date: 2002/02/10 08:07:42 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/EnumerationIterator.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -67,6 +67,7 @@ import java.util.Iterator;
 /** Adapter to make {@link Enumeration Enumeration} instances appear
   * to be {@link Iterator Iterator} instances.
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   * @author <a href="mailto:dlr@finemaltcoding.com">Daniel Rall</a>
   */
diff --git a/src/java/org/apache/commons/collections/ExtendedProperties.java b/src/java/org/apache/commons/collections/ExtendedProperties.java
index 4c519023d..7f4729e96 100644
--- a/src/java/org/apache/commons/collections/ExtendedProperties.java
+++ b/src/java/org/apache/commons/collections/ExtendedProperties.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/ExtendedProperties.java,v 1.6 2002/02/10 08:07:42 jstrachan Exp $
- * $Revision: 1.6 $
- * $Date: 2002/02/10 08:07:42 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/ExtendedProperties.java,v 1.7 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.7 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -163,6 +163,7 @@ import java.util.Vector;
  * it, go ahead and tune it up!
  *
  *
+ * @since 1.0
  * @author <a href="mailto:stefano@apache.org">Stefano Mazzocchi</a>
  * @author <a href="mailto:jon@latchkey.com">Jon S. Stevens</a>
  * @author <a href="mailto:daveb@miceda-data">Dave Bryson</a>
@@ -172,7 +173,7 @@ import java.util.Vector;
  * @author <a href="mailto:kjohnson@transparent.com">Kent Johnson</a>
  * @author <a href="mailto:dlr@finemaltcoding.com">Daniel Rall</a>
  * @author <a href="mailto:ipriha@surfeu.fi">Ilkka Priha</a>
- * @version $Id: ExtendedProperties.java,v 1.6 2002/02/10 08:07:42 jstrachan Exp $
+ * @version $Id: ExtendedProperties.java,v 1.7 2002/06/12 03:59:15 mas Exp $
  */
 public class ExtendedProperties extends Hashtable
 {
diff --git a/src/java/org/apache/commons/collections/FastArrayList.java b/src/java/org/apache/commons/collections/FastArrayList.java
index e4389613e..35efb7cdc 100644
--- a/src/java/org/apache/commons/collections/FastArrayList.java
+++ b/src/java/org/apache/commons/collections/FastArrayList.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/FastArrayList.java,v 1.4 2002/02/10 08:07:42 jstrachan Exp $
- * $Revision: 1.4 $
- * $Date: 2002/02/10 08:07:42 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/FastArrayList.java,v 1.5 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.5 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -93,8 +93,9 @@ import java.util.ListIterator;
  * <code>java.util.ArrayList</code> directly (with no synchronization), for
  * maximum performance.</p>
  *
+ * @since 1.0
  * @author Craig R. McClanahan
- * @version $Revision: 1.4 $ $Date: 2002/02/10 08:07:42 $
+ * @version $Revision: 1.5 $ $Date: 2002/06/12 03:59:15 $
  */
 
 public class FastArrayList extends ArrayList {
diff --git a/src/java/org/apache/commons/collections/FastHashMap.java b/src/java/org/apache/commons/collections/FastHashMap.java
index 6789c45d6..7e30b16d1 100644
--- a/src/java/org/apache/commons/collections/FastHashMap.java
+++ b/src/java/org/apache/commons/collections/FastHashMap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/FastHashMap.java,v 1.5 2002/02/10 08:07:42 jstrachan Exp $
- * $Revision: 1.5 $
- * $Date: 2002/02/10 08:07:42 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/FastHashMap.java,v 1.6 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.6 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -94,8 +94,9 @@ import java.util.Set;
  * <code>java.util.HashMap</code> directly (with no synchronization), for
  * maximum performance.</p>
  *
+ * @since 1.0
  * @author Craig R. McClanahan
- * @version $Revision: 1.5 $ $Date: 2002/02/10 08:07:42 $
+ * @version $Revision: 1.6 $ $Date: 2002/06/12 03:59:15 $
  */
 
 public class FastHashMap extends HashMap {
diff --git a/src/java/org/apache/commons/collections/FastTreeMap.java b/src/java/org/apache/commons/collections/FastTreeMap.java
index da49dde32..f052bb68f 100644
--- a/src/java/org/apache/commons/collections/FastTreeMap.java
+++ b/src/java/org/apache/commons/collections/FastTreeMap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/FastTreeMap.java,v 1.5 2002/02/10 08:07:42 jstrachan Exp $
- * $Revision: 1.5 $
- * $Date: 2002/02/10 08:07:42 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/FastTreeMap.java,v 1.6 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.6 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -96,8 +96,9 @@ import java.util.TreeMap;
  * <code>java.util.TreeMap</code> directly (with no synchronization), for
  * maximum performance.</p>
  *
+ * @since 1.0
  * @author Craig R. McClanahan
- * @version $Revision: 1.5 $ $Date: 2002/02/10 08:07:42 $
+ * @version $Revision: 1.6 $ $Date: 2002/06/12 03:59:15 $
  */
 
 public class FastTreeMap extends TreeMap {
diff --git a/src/java/org/apache/commons/collections/FilterIterator.java b/src/java/org/apache/commons/collections/FilterIterator.java
index 42030d993..8717db082 100644
--- a/src/java/org/apache/commons/collections/FilterIterator.java
+++ b/src/java/org/apache/commons/collections/FilterIterator.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/FilterIterator.java,v 1.4 2002/02/10 08:07:42 jstrachan Exp $
- * $Revision: 1.4 $
- * $Date: 2002/02/10 08:07:42 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/FilterIterator.java,v 1.5 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.5 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -69,6 +69,7 @@ import java.util.NoSuchElementException;
   * specified <code>Predicate</code> evaluates to <code>true</code> are
   * returned.
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   * @author Jan Sorensen
   */
diff --git a/src/java/org/apache/commons/collections/FilterListIterator.java b/src/java/org/apache/commons/collections/FilterListIterator.java
index 6f883e11d..4c0f1a0f2 100644
--- a/src/java/org/apache/commons/collections/FilterListIterator.java
+++ b/src/java/org/apache/commons/collections/FilterListIterator.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/FilterListIterator.java,v 1.3 2002/05/13 16:10:37 rwaldhoff Exp $
- * $Revision: 1.3 $
- * $Date: 2002/05/13 16:10:37 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/FilterListIterator.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -71,7 +71,8 @@ import java.util.NoSuchElementException;
   * <code>Predicate</code> evaluates to <code>true</code> are
   * returned by the iterator.
   * 
-  * @version $Revision: 1.3 $ $Date: 2002/05/13 16:10:37 $
+  * @since 2.0
+  * @version $Revision: 1.4 $ $Date: 2002/06/12 03:59:15 $
   * @author Rodney Waldhoff
   */
 public class FilterListIterator extends ProxyListIterator {
diff --git a/src/java/org/apache/commons/collections/HashBag.java b/src/java/org/apache/commons/collections/HashBag.java
index 48134c907..cf7988787 100644
--- a/src/java/org/apache/commons/collections/HashBag.java
+++ b/src/java/org/apache/commons/collections/HashBag.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/HashBag.java,v 1.4 2002/03/25 05:50:57 mas Exp $
- * $Revision: 1.4 $
- * $Date: 2002/03/25 05:50:57 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/HashBag.java,v 1.5 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.5 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -68,6 +68,7 @@ import java.util.HashMap;
  * An implementation of {@link Bag} that is backed by a {@link
  * HashMap}.
  *
+ * @since 2.0
  * @author Chuck Burdick
  **/
 public class HashBag extends DefaultMapBag implements Bag {
diff --git a/src/java/org/apache/commons/collections/IteratorEnumeration.java b/src/java/org/apache/commons/collections/IteratorEnumeration.java
index 4f934cbb7..e1a3ab59c 100644
--- a/src/java/org/apache/commons/collections/IteratorEnumeration.java
+++ b/src/java/org/apache/commons/collections/IteratorEnumeration.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/IteratorEnumeration.java,v 1.3 2002/03/13 05:40:31 mas Exp $
- * $Revision: 1.3 $
- * $Date: 2002/03/13 05:40:31 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/IteratorEnumeration.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -65,6 +65,7 @@ import java.util.Iterator;
 
 /** Adapter to make an {@link Iterator Iterator} instance appear to be an {@link Enumeration Enumeration} instances
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   */
 
diff --git a/src/java/org/apache/commons/collections/LRUMap.java b/src/java/org/apache/commons/collections/LRUMap.java
index d584c9a2d..e15464853 100644
--- a/src/java/org/apache/commons/collections/LRUMap.java
+++ b/src/java/org/apache/commons/collections/LRUMap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/LRUMap.java,v 1.15 2002/05/09 03:10:46 mas Exp $
- * $Revision: 1.15 $
- * $Date: 2002/05/09 03:10:46 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/LRUMap.java,v 1.16 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.16 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -89,6 +89,7 @@ import java.util.Iterator;
  * key is now equivalent to LRUMap.getFirst().
  * </p>
  * 
+ * @since 1.0
  * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
  * @author <a href="mailto:morgand@apache.org">Morgan Delagrange</a>
  */
diff --git a/src/java/org/apache/commons/collections/ListUtils.java b/src/java/org/apache/commons/collections/ListUtils.java
index 55f5ad364..da1e7d353 100644
--- a/src/java/org/apache/commons/collections/ListUtils.java
+++ b/src/java/org/apache/commons/collections/ListUtils.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/ListUtils.java,v 1.3 2002/02/10 08:07:42 jstrachan Exp $
- * $Revision: 1.3 $
- * $Date: 2002/02/10 08:07:42 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/ListUtils.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -67,6 +67,7 @@ import java.util.List;
 /**
  * Miscelaneous utilities to manipulate Lists.
  *
+ * @since 1.0
  * @author  <a href="mailto:fede@apache.org">Federico Barbieri</a>
  * @author  <a href="mailto:donaldp@apache.org">Peter Donald</a>
  * @deprecated See {@link org.apache.commons.collections.CollectionUtils}.
diff --git a/src/java/org/apache/commons/collections/MapUtils.java b/src/java/org/apache/commons/collections/MapUtils.java
index b2cee61c3..63d1dbdb2 100644
--- a/src/java/org/apache/commons/collections/MapUtils.java
+++ b/src/java/org/apache/commons/collections/MapUtils.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/MapUtils.java,v 1.4 2002/03/13 05:40:31 mas Exp $
- * $Revision: 1.4 $
- * $Date: 2002/03/13 05:40:31 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/MapUtils.java,v 1.5 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.5 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -69,8 +69,8 @@ import java.util.*;
   * It contains various typesafe methods
   * as well as other useful features like deep copying
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
-  *
   * @author <a href="mailto:nissim@nksystems.com">Nissim Karpenstein</a>
   * @author <a href="mailto:knielsen@apache.org">Kasper Nielsen</a>
   */
diff --git a/src/java/org/apache/commons/collections/MultiHashMap.java b/src/java/org/apache/commons/collections/MultiHashMap.java
index 4a9bf155c..3ae65a896 100644
--- a/src/java/org/apache/commons/collections/MultiHashMap.java
+++ b/src/java/org/apache/commons/collections/MultiHashMap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/MultiHashMap.java,v 1.3 2002/03/13 05:40:31 mas Exp $
- * $Revision: 1.3 $
- * $Date: 2002/03/13 05:40:31 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/MultiHashMap.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -66,6 +66,7 @@ import java.io.*;
 /** see MultiMap for details of an important semantic difference
  * between this and a typical HashMap
  *
+ * @since 2.0
  * @author Christopher Berry
  * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
  */
diff --git a/src/java/org/apache/commons/collections/MultiMap.java b/src/java/org/apache/commons/collections/MultiMap.java
index f2891fc70..12a8bc89f 100644
--- a/src/java/org/apache/commons/collections/MultiMap.java
+++ b/src/java/org/apache/commons/collections/MultiMap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/MultiMap.java,v 1.3 2002/03/13 05:40:31 mas Exp $
- * $Revision: 1.3 $
- * $Date: 2002/03/13 05:40:31 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/MultiMap.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -70,6 +70,7 @@ import java.util.Map;
  * instead of an Integer.
  * Thus, this is simply a tag interface.
  *
+ * @since 2.0
  * @author Christopher Berry
  * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
  */
diff --git a/src/java/org/apache/commons/collections/Predicate.java b/src/java/org/apache/commons/collections/Predicate.java
index 8c7bb3169..136f2c529 100644
--- a/src/java/org/apache/commons/collections/Predicate.java
+++ b/src/java/org/apache/commons/collections/Predicate.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Predicate.java,v 1.3 2002/03/13 05:40:31 mas Exp $
- * $Revision: 1.3 $
- * $Date: 2002/03/13 05:40:31 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Predicate.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -63,6 +63,7 @@ package org.apache.commons.collections;
 /** Performs some predicate which returns true or false based on the input object.
   * Predicate instances can be used to implement queries or to do filtering.
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   */
 public interface Predicate {
diff --git a/src/java/org/apache/commons/collections/PriorityQueue.java b/src/java/org/apache/commons/collections/PriorityQueue.java
index 70a4d2fa8..60c30b283 100644
--- a/src/java/org/apache/commons/collections/PriorityQueue.java
+++ b/src/java/org/apache/commons/collections/PriorityQueue.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/PriorityQueue.java,v 1.4 2002/03/19 04:34:18 mas Exp $
- * $Revision: 1.4 $
- * $Date: 2002/03/19 04:34:18 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/PriorityQueue.java,v 1.5 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.5 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -66,6 +66,7 @@ import java.util.NoSuchElementException;
  * Interface for priority queues.
  * This interface does not dictate whether it is min or max heap.
  *
+ * @since 1.0
  * @author  <a href="mailto:donaldp@apache.org">Peter Donald</a>
  */
 public interface PriorityQueue
diff --git a/src/java/org/apache/commons/collections/ProxyIterator.java b/src/java/org/apache/commons/collections/ProxyIterator.java
index dee3ce493..dbac9fd78 100644
--- a/src/java/org/apache/commons/collections/ProxyIterator.java
+++ b/src/java/org/apache/commons/collections/ProxyIterator.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/ProxyIterator.java,v 1.3 2002/02/25 23:53:20 rwaldhoff Exp $
- * $Revision: 1.3 $
- * $Date: 2002/02/25 23:53:20 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/ProxyIterator.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -64,8 +64,9 @@ import java.util.Iterator;
 
 /** A Proxy {@link Iterator Iterator} which delegates its methods to a proxy instance.
   *
+  * @since 1.0
   * @see ProxyListIterator
-  * @version $Revision: 1.3 $ $Date: 2002/02/25 23:53:20 $
+  * @version $Revision: 1.4 $ $Date: 2002/06/12 03:59:15 $
   *
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   */
diff --git a/src/java/org/apache/commons/collections/ProxyListIterator.java b/src/java/org/apache/commons/collections/ProxyListIterator.java
index f92af899c..b0c2d76fc 100644
--- a/src/java/org/apache/commons/collections/ProxyListIterator.java
+++ b/src/java/org/apache/commons/collections/ProxyListIterator.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/ProxyListIterator.java,v 1.1 2002/02/25 23:53:20 rwaldhoff Exp $
- * $Revision: 1.1 $
- * $Date: 2002/02/25 23:53:20 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/ProxyListIterator.java,v 1.2 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.2 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -66,8 +66,9 @@ import java.util.ListIterator;
  * A proxy {@link ListIterator ListIterator} which delegates its
  * methods to a proxy instance.
  *
+ * @since 2.0
  * @see ProxyIterator
- * @version $Revision: 1.1 $ $Date: 2002/02/25 23:53:20 $
+ * @version $Revision: 1.2 $ $Date: 2002/06/12 03:59:15 $
  * @author Rodney Waldhoff
  */
 public class ProxyListIterator implements ListIterator {
diff --git a/src/java/org/apache/commons/collections/ProxyMap.java b/src/java/org/apache/commons/collections/ProxyMap.java
index 37ba89723..19c6e7ab3 100644
--- a/src/java/org/apache/commons/collections/ProxyMap.java
+++ b/src/java/org/apache/commons/collections/ProxyMap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/ProxyMap.java,v 1.2 2002/03/21 03:31:09 mas Exp $
- * $Revision: 1.2 $
- * $Date: 2002/03/21 03:31:09 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/ProxyMap.java,v 1.3 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.3 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -77,8 +77,8 @@ import java.util.Set;
  * returned by <code>Collections.synchronizedMap(map)</code>
  * hides part of <code>map</code>'s public interface.</p>
  *
- * @author <a href="mailto:dlr@collab.net">Daniel Rall</a>
  * @since 2.0
+ * @author <a href="mailto:dlr@collab.net">Daniel Rall</a>
  */
 public abstract class ProxyMap implements Map {
     
diff --git a/src/java/org/apache/commons/collections/SequencedHashMap.java b/src/java/org/apache/commons/collections/SequencedHashMap.java
index 02c850bc0..faae1018f 100644
--- a/src/java/org/apache/commons/collections/SequencedHashMap.java
+++ b/src/java/org/apache/commons/collections/SequencedHashMap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/SequencedHashMap.java,v 1.11 2002/06/09 07:14:14 mas Exp $
- * $Revision: 1.11 $
- * $Date: 2002/06/09 07:14:14 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/SequencedHashMap.java,v 1.12 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.12 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -93,6 +93,7 @@ import java.util.ConcurrentModificationException;
  *  required, use {@link Collections#synchronizedMap(Map)} as it is documented,
  *  or use explicit synchronization controls.
  *
+ *  @since 2.0
  *  @author <a href="mailto:mas@apache.org">Michael A. Smith</A>
  * @author <a href="mailto:dlr@collab.net">Daniel Rall</a>
  * @author <a href="mailto:hps@intermeta.de">Henning P. Schmiedehausen</a>
diff --git a/src/java/org/apache/commons/collections/SingletonIterator.java b/src/java/org/apache/commons/collections/SingletonIterator.java
index 27fd9e6a8..3429c6271 100644
--- a/src/java/org/apache/commons/collections/SingletonIterator.java
+++ b/src/java/org/apache/commons/collections/SingletonIterator.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/SingletonIterator.java,v 1.4 2002/03/13 05:40:31 mas Exp $
- * $Revision: 1.4 $
- * $Date: 2002/03/13 05:40:31 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/SingletonIterator.java,v 1.5 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.5 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -66,8 +66,9 @@ import java.util.NoSuchElementException;
 /** <p><code>SingletonIterator</code> is an {@link Iterator} over a single 
   * object instance.</p>
   *
+  * @since 2.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
-  * @version $Revision: 1.4 $
+  * @version $Revision: 1.5 $
   */
 public class SingletonIterator implements Iterator {
 
diff --git a/src/java/org/apache/commons/collections/SoftRefHashMap.java b/src/java/org/apache/commons/collections/SoftRefHashMap.java
index 0c72c101e..e16b56ed8 100644
--- a/src/java/org/apache/commons/collections/SoftRefHashMap.java
+++ b/src/java/org/apache/commons/collections/SoftRefHashMap.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/SoftRefHashMap.java,v 1.3 2002/03/13 05:40:31 mas Exp $
- * $Revision: 1.3 $
- * $Date: 2002/03/13 05:40:31 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/SoftRefHashMap.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -83,6 +83,7 @@ import java.util.*;
   * over this Map is efficient.
   * </p>
   * 
+  * @since 1.0
   * @author  James.Dodd
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   */
diff --git a/src/java/org/apache/commons/collections/SortedBag.java b/src/java/org/apache/commons/collections/SortedBag.java
index a5ad4cb8b..699570193 100644
--- a/src/java/org/apache/commons/collections/SortedBag.java
+++ b/src/java/org/apache/commons/collections/SortedBag.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/SortedBag.java,v 1.3 2002/03/13 05:40:31 mas Exp $
- * $Revision: 1.3 $
- * $Date: 2002/03/13 05:40:31 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/SortedBag.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -66,6 +66,8 @@ import java.util.Comparator;
 /**
  * A type of {@link Bag} that maintains order among its unique
  * representative members.
+ *
+ * @since 2.0
  * @author Chuck Burdick
  **/
 public interface SortedBag extends Bag {
diff --git a/src/java/org/apache/commons/collections/StringStack.java b/src/java/org/apache/commons/collections/StringStack.java
index dd6d252f5..89cef1119 100644
--- a/src/java/org/apache/commons/collections/StringStack.java
+++ b/src/java/org/apache/commons/collections/StringStack.java
@@ -61,9 +61,10 @@ import java.util.Stack;
 /**
  * This class implements a stack for String objects.
  *
+ * @since 2.0
  * @author <a href="mailto:jmcnally@collab.net">John D. McNally</a>
  * @author <a href="mailto:dlr@finemaltcoding.com">Daniel Rall</a>
- * @version $Id: StringStack.java,v 1.1 2002/02/23 03:52:02 bayard Exp $
+ * @version $Id: StringStack.java,v 1.2 2002/06/12 03:59:15 mas Exp $
  */
 public class StringStack implements Serializable
 {
diff --git a/src/java/org/apache/commons/collections/SynchronizedPriorityQueue.java b/src/java/org/apache/commons/collections/SynchronizedPriorityQueue.java
index eaadcaeb2..4fdab6f1b 100644
--- a/src/java/org/apache/commons/collections/SynchronizedPriorityQueue.java
+++ b/src/java/org/apache/commons/collections/SynchronizedPriorityQueue.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/SynchronizedPriorityQueue.java,v 1.3 2002/03/19 13:19:13 mas Exp $
- * $Revision: 1.3 $
- * $Date: 2002/03/19 13:19:13 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/SynchronizedPriorityQueue.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -67,6 +67,7 @@ import java.util.NoSuchElementException;
  * Provides synchronized wrapper methods for all the methods 
  * defined in the PriorityQueue interface.
  *
+ * @since 1.0
  * @author  <a href="mailto:ram.chidambaram@telus.com">Ram Chidambaram</a> 
  */
 public final class SynchronizedPriorityQueue 
diff --git a/src/java/org/apache/commons/collections/TransformIterator.java b/src/java/org/apache/commons/collections/TransformIterator.java
index b2c8b6906..61d1c69c5 100644
--- a/src/java/org/apache/commons/collections/TransformIterator.java
+++ b/src/java/org/apache/commons/collections/TransformIterator.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/TransformIterator.java,v 1.3 2002/03/13 05:40:31 mas Exp $
- * $Revision: 1.3 $
- * $Date: 2002/03/13 05:40:31 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Attic/TransformIterator.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -66,6 +66,7 @@ import java.util.Iterator;
 /** A Proxy {@link Iterator Iterator} which uses a {@link Transformer Transformer} instance to 
   * transform the contents of the {@link Iterator Iterator} into some other form
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   */
 
diff --git a/src/java/org/apache/commons/collections/Transformer.java b/src/java/org/apache/commons/collections/Transformer.java
index 503869b02..dfc672a73 100644
--- a/src/java/org/apache/commons/collections/Transformer.java
+++ b/src/java/org/apache/commons/collections/Transformer.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Transformer.java,v 1.3 2002/03/13 05:40:31 mas Exp $
- * $Revision: 1.3 $
- * $Date: 2002/03/13 05:40:31 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/Transformer.java,v 1.4 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.4 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -62,6 +62,7 @@ package org.apache.commons.collections;
 
 /** An object capable of transforming an input object into some output object.
   *
+  * @since 1.0
   * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
   */
 public interface Transformer {
diff --git a/src/java/org/apache/commons/collections/TreeBag.java b/src/java/org/apache/commons/collections/TreeBag.java
index a314a095f..bc1d9342a 100644
--- a/src/java/org/apache/commons/collections/TreeBag.java
+++ b/src/java/org/apache/commons/collections/TreeBag.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/TreeBag.java,v 1.4 2002/03/25 05:50:57 mas Exp $
- * $Revision: 1.4 $
- * $Date: 2002/03/25 05:50:57 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/TreeBag.java,v 1.5 2002/06/12 03:59:15 mas Exp $
+ * $Revision: 1.5 $
+ * $Date: 2002/06/12 03:59:15 $
  *
  * ====================================================================
  *
@@ -71,6 +71,7 @@ import java.util.TreeMap;
  * TreeMap}. Order will be maintained among the unique representative
  * members.
  *
+ * @since 2.0
  * @author Chuck Burdick
  **/
 public class TreeBag extends DefaultMapBag implements SortedBag, Bag {
diff --git a/src/java/org/apache/commons/collections/comparators/ComparableComparator.java b/src/java/org/apache/commons/collections/comparators/ComparableComparator.java
index 3958b33b8..2fe575e25 100644
--- a/src/java/org/apache/commons/collections/comparators/ComparableComparator.java
+++ b/src/java/org/apache/commons/collections/comparators/ComparableComparator.java
@@ -68,8 +68,9 @@ import java.util.Comparator;
  * for enforcing the natural order in custom implementations
  * of SortedSet and SortedMap.
  *
+ * @since 2.0
  * @author bayard@generationjava.com
- * @version $Id: ComparableComparator.java,v 1.4 2002/03/19 05:09:05 mas Exp $
+ * @version $Id: ComparableComparator.java,v 1.5 2002/06/12 03:59:17 mas Exp $
  */
 public class ComparableComparator implements Comparator,Serializable {
 
diff --git a/src/java/org/apache/commons/collections/comparators/ComparatorChain.java b/src/java/org/apache/commons/collections/comparators/ComparatorChain.java
index b01b96c62..2ad29e7c0 100644
--- a/src/java/org/apache/commons/collections/comparators/ComparatorChain.java
+++ b/src/java/org/apache/commons/collections/comparators/ComparatorChain.java
@@ -1,7 +1,7 @@
 /*
- * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/comparators/ComparatorChain.java,v 1.6 2002/03/25 21:20:53 morgand Exp $
- * $Revision: 1.6 $
- * $Date: 2002/03/25 21:20:53 $
+ * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/src/java/org/apache/commons/collections/comparators/ComparatorChain.java,v 1.7 2002/06/12 03:59:17 mas Exp $
+ * $Revision: 1.7 $
+ * $Date: 2002/06/12 03:59:17 $
  *
  * ====================================================================
  *
@@ -94,6 +94,7 @@ import java.util.List;
  * it <i>is</i> thread-safe to perform multiple comparisons
  * after all the setup operations are complete.</p>
  * 
+ * @since 2.0
  * @author Morgan Delagrange
  */
 public class ComparatorChain implements Comparator,Serializable {
diff --git a/src/java/org/apache/commons/collections/comparators/ReverseComparator.java b/src/java/org/apache/commons/collections/comparators/ReverseComparator.java
index a02a106ba..a6c834fa2 100644
--- a/src/java/org/apache/commons/collections/comparators/ReverseComparator.java
+++ b/src/java/org/apache/commons/collections/comparators/ReverseComparator.java
@@ -60,9 +60,10 @@ import java.util.Comparator;
 /**
  * Reverses the order of another comparator.
  * 
+ * @since 2.0
  * @author bayard@generationjava.com
  * @author <a href="mailto:mas@apache.org">Michael A. Smith</a>
- * @version $Id: ReverseComparator.java,v 1.7 2002/03/20 17:09:16 morgand Exp $
+ * @version $Id: ReverseComparator.java,v 1.8 2002/06/12 03:59:17 mas Exp $
  */
 public class ReverseComparator implements Comparator,Serializable {