Author: bayard
Date: Mon Mar 17 23:11:16 2008
New Revision: 638227
URL: http://svn.apache.org/viewvc?rev=638227&view=rev
Log:
Stressing that existing objects are not transformed as per Paul's request in
COLLECTIONS-288
Modified:
commons/proper/collections/trunk/src/java/org/apache/commons/collections/ListUtils.java
Modified:
commons/proper/collections/trunk/src/java/org/apache/commons/collections/ListUtils.java
URL:
http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/java/org/apache/commons/collections/ListUtils.java?rev=638227&r1=638226&r2=638227&view=diff
==============================================================================
---
commons/proper/collections/trunk/src/java/org/apache/commons/collections/ListUtils.java
(original)
+++
commons/proper/collections/trunk/src/java/org/apache/commons/collections/ListUtils.java
Mon Mar 17 23:11:16 2008
@@ -348,6 +348,10 @@
/**
* Returns a transformed list backed by the given list.
* <p>
+ * This method returns a new list (decorating the specified list) that
+ * will transform any new entries added to it.
+ * Existing entries in the specified list will not be transformed.
+ * <p>
* Each object is passed through the transformer as it is added to the
* List. It is important not to use the original list after invoking this
* method, as it is a backdoor for adding untransformed objects.
