Return-Path:
Delivered-To: apmail-commons-commits-archive@minotaur.apache.org
Received: (qmail 38056 invoked from network); 1 Nov 2009 15:25:35 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3)
by minotaur.apache.org with SMTP; 1 Nov 2009 15:25:35 -0000
Received: (qmail 82065 invoked by uid 500); 1 Nov 2009 15:25:35 -0000
Delivered-To: apmail-commons-commits-archive@commons.apache.org
Received: (qmail 81973 invoked by uid 500); 1 Nov 2009 15:25:34 -0000
Mailing-List: contact commits-help@commons.apache.org; run by ezmlm
Precedence: bulk
List-Help:
List-Unsubscribe:
List-Post:
List-Id:
Reply-To: dev@commons.apache.org
Delivered-To: mailing list commits@commons.apache.org
Received: (qmail 81964 invoked by uid 99); 1 Nov 2009 15:25:34 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 01 Nov 2009 15:25:34 +0000
X-ASF-Spam-Status: No, hits=-2.6 required=5.0
tests=AWL,BAYES_00
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 01 Nov 2009 15:25:32 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
id CB010238890E; Sun, 1 Nov 2009 15:25:11 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r831686 -
/commons/proper/lang/trunk/src/java/org/apache/commons/lang/builder/ToStringBuilder.java
Date: Sun, 01 Nov 2009 15:25:11 -0000
To: commits@commons.apache.org
From: scolebourne@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20091101152511.CB010238890E@eris.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 ToStringStyle
to the constructor instead
* of using this global default.
*
- * This method is not intended for use from multiple threads.
+ *
This method can be used from multiple threads.
* Internally, a volatile
variable is used to provide the guarantee
- * that the latest value set using {@link #setDefaultStyle} is the value returned.
+ * 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.
*
* One reason for changing the default could be to have a verbose style during
* development and a compact style in production.