[slf4j-dev] svn commit: r1265 - slf4j/trunk/slf4j-site/src/site/pages

[ravn at slf4j.org]

Author: ravn
Date: Sun Jan 11 14:11:48 2009
New Revision: 1265

Modified:
   slf4j/trunk/slf4j-site/src/site/pages/extensions.html

Log:
Added note on disabling troublesome classes in the log backend
configuration file as it has turned out to be very hard (for me) to
handle recursive toString() calls programatically.



Modified: slf4j/trunk/slf4j-site/src/site/pages/extensions.html
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/extensions.html	(original)
+++ slf4j/trunk/slf4j-site/src/site/pages/extensions.html	Sun Jan 11 14:11:48 2009
@@ -680,6 +680,15 @@
     slf4j-api classes in order to do logging, so if these classes are  not visible to a given class it is not instrumented. 
     </dd>
   </dl>
+
+
+    <p>Some classes may misbehave when being rendered with "object.toString()" so they may be explicitly disabled 
+    in the logback configuration file permanently.  For instance the ToStringBuilder in the Apache Jakarta commons lang 
+    package is a prime candidate for this.  For logback add this snippet to logback.xml:
+    <pre>&lt;logger name="org.apache.commons.lang.builder" level="OFF" /&gt;</pre>
+    </p>
+    
+
   
   <p>Note: These are not finalized yet, and may change.</p>