+
+ Reverted performance improvement for "ListOrderedSet#retainAll(Collection)"
+ introduced in 4.0. Added clarifying javadoc wrt runtime complexity instead.
+
Added a Builder for "PredicatedCollection". Elements added to the builder
that fail the predicate will not throw an IllegalArgumentException. The builder
diff --git a/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java b/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java
index 48356fc7e..b4a476ced 100644
--- a/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java
+++ b/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java
@@ -225,27 +225,31 @@ public class ListOrderedSet
return result;
}
+ /**
+ * {@inheritDoc}
+ *
+ * This implementation iterates over the elements of this set, checking
+ * each element in turn to see if it's contained in coll.
+ * If it's not contained, it's removed from this set. As a consequence,
+ * it is advised to use a collection type for coll that provides
+ * a fast (e.g. O(1)) implementation of {@link Collection#contains(Object)}.
+ */
@Override
public boolean retainAll(final Collection> coll) {
- final Set