Author: sebb
Date: Thu Mar 8 18:50:52 2012
New Revision: 1298506
URL: http://svn.apache.org/viewvc?rev=1298506&view=rev
Log:
Documentation
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java?rev=1298506&r1=1298505&r2=1298506&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java
Thu Mar 8 18:50:52 2012
@@ -135,6 +135,15 @@ public abstract class ToStringStyle impl
*/
private static final ThreadLocal<WeakHashMap<Object, Object>> REGISTRY =
new ThreadLocal<WeakHashMap<Object,Object>>();
+ /*
+ * Note that objects of this class are generally shared between threads, so
+ * an instance variable would not be suitable here.
+ *
+ * In normal use the registry should always be left empty, because the
caller
+ * should call toString() which will clean up.
+ *
+ * See LANG-792
+ */
/**
* <p>
