svn commit: r831686 - /commons/proper/lang/trunk/src/java/org/apache/commons/lang/builder/ToStringBuilder.java

[sc...@apache.org]

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>