Author: joehni
Date: Sun Mar 28 17:04:59 2010
New Revision: 928453
URL: http://svn.apache.org/viewvc?rev=928453&view=rev
Log:
Improve javadoc
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java?rev=928453&r1=928452&r2=928453&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
Sun Mar 28 17:04:59 2010
@@ -344,7 +344,13 @@ public class ObjectUtils {
}
/**
- * Clone an object if possible.
+ * Clone an object if possible. This method is similar to {...@link
#clone(Object)}, but will
+ * return the provided instance as return value instead of
<code>null</code> if the instance
+ * is not cloneable. This is convenient in case the caller will use
different
+ * implementations (e.g. of a service) and some of the instances do not
allow concurrent
+ * processing or have state. In such a case the implementation can simply
provide a proper
+ * clone implementation and the caller has not to take care, it will
simply call this method
+ * here.
*
* @param <T> the type of the object
* @param o the object to clone
