Author: scolebourne
Date: Sun Nov 1 15:25:10 2009
New Revision: 831686
URL: http://svn.apache.org/viewvc?rev=831686&view=rev
Log:
LANG-487 - Make default style thread-safe (better Javadoc)
Modified:
commons/proper/lang/trunk/src/java/org/apache/commons/lang/builder/ToStringBuilder.java
Modified:
commons/proper/lang/trunk/src/java/org/apache/commons/lang/builder/ToStringBuilder.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/java/org/apache/commons/lang/builder/ToStringBuilder.java?rev=831686&r1=831685&r2=831686&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/java/org/apache/commons/lang/builder/ToStringBuilder.java
(original)
+++
commons/proper/lang/trunk/src/java/org/apache/commons/lang/builder/ToStringBuilder.java
Sun Nov 1 15:25:10 2009
@@ -106,9 +106,10 @@
* It is recommended to pass a <code>ToStringStyle</code> to the
constructor instead
* of using this global default.</p>
*
- * <p>This method is not intended for use from multiple threads.
+ * <p>This method can be used from multiple threads.
* Internally, a <code>volatile</code> variable is used to provide the
guarantee
- * that the latest value set using {...@link #setDefaultStyle} is the
value returned.</p>
+ * that the latest value set using {...@link #setDefaultStyle} is the
value returned.
+ * It is strongly recommended that the default style is only changed
during application startup.</p>
*
* <p>One reason for changing the default could be to have a verbose style
during
* development and a compact style in production.</p>
