scolebourne 2004/05/03 08:12:20
Modified: collections/src/java/org/apache/commons/collections Bag.java
Log:
Update Bag interface method text to indicate that we won't break compatability
Revision Changes Path
1.18 +6 -12
jakarta-commons/collections/src/java/org/apache/commons/collections/Bag.java
Index: Bag.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/Bag.java,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- Bag.java 27 Apr 2004 20:43:05 -0000 1.17
+++ Bag.java 3 May 2004 15:12:20 -0000 1.18
@@ -66,8 +66,7 @@
* Since this method always increases the size of the bag,
* according to the [EMAIL PROTECTED] Collection#add(Object)} contract, it
* should always return <code>true</code>. Since it sometimes returns
- * <code>false</code>, this method violates the contract. A future
- * version of this method will comply by always returning <code>true</code>.
+ * <code>false</code>, this method violates the contract.
*
* @param object the object to add
* @return <code>true</code> if the object was not already in the
<code>uniqueSet</code>
@@ -95,9 +94,7 @@
* <p>
* According to the [EMAIL PROTECTED] Collection#remove(Object)} method,
* this method should only remove the <i>first</i> occurrence of the
- * given object, not <i>all</i> occurrences. A future version of this
- * method will comply with the contract by only removing one occurrence
- * of the given object.
+ * given object, not <i>all</i> occurrences.
*
* @return <code>true</code> if this call changed the collection
*/
@@ -142,8 +139,7 @@
* The [EMAIL PROTECTED] Collection#containsAll(Collection)} method specifies
* that cardinality should <i>not</i> be respected; this method should
* return true if the bag contains at least one of every object contained
- * in the given collection. A future version of this method will comply
- * with that contract.
+ * in the given collection.
*
* @param coll the collection to check against
* @return <code>true</code> if the Bag contains all the collection
@@ -161,8 +157,7 @@
* <P>The [EMAIL PROTECTED] Collection#removeAll(Collection)} method specifies
* that cardinality should <i>not</i> be respected; this method should
* remove <i>all</i> occurrences of every object contained in the
- * given collection. A future version of this method will comply
- * with that contract.
+ * given collection.
*
* @param coll the collection to remove
* @return <code>true</code> if this call changed the collection
@@ -183,8 +178,7 @@
* <P>The [EMAIL PROTECTED] Collection#retainAll(Collection)} method specifies
* that cardinality should <i>not</i> be respected; this method should
* keep <i>all</i> occurrences of every object contained in the
- * given collection. A future version of this method will comply
- * with that contract.
+ * given collection.
*
* @param coll the collection to retain
* @return <code>true</code> if this call changed the collection
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
