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.