svn commit: r638227 - /commons/proper/collections/trunk/src/java/org/apache/commons/collections/ListUtils.java

[ba...@apache.org]

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.