svn commit: r958753 - /qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml

[jo...@apache.org]

Author: jonathan
Date: Mon Jun 28 21:48:43 2010
New Revision: 958753

URL: http://svn.apache.org/viewvc?rev=958753&view=rev
Log:
Modified the wording for the log4j section.

Modified:
    qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml

Modified: qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml?rev=958753&r1=958752&r2=958753&view=diff
==============================================================================
--- qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml (original)
+++ qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml Mon Jun 28 21:48:43 2010
@@ -3045,17 +3045,15 @@ producer.send(m);
     
     <section id="section-JMS-Logging">
       <title>JMS Client Logging</title>
-      <para>The JMS Client logging is handled using <ulink url="http://www.slf4j.org/">SLF4J</ulink>. A user can place a slf4j binding of their choice in the classpath and configure the respective logging mechanism to suit their needs. Ex bindings include log4j, jdk1.4 logging ..etc</para>
+      <para>The JMS Client logging is handled using the Simple Logging Facade for Java (<ulink url="http://www.slf4j.org/">SLF4J</ulink>). As the name implies, slf4j is a facade that delegates to other logging systems like log4j or JDK 1.4 logging. For more information on how to configure log4j for specific logging systems, please consult the log4j documentation.</para>
 
-      <para>Following is an example on how to configure the client logging with the log4j binding.</para>
+      <para>When using the log4j binding, please set the log level for org.apache.qpid explicitly. Otherwise log4j will default to DEBUG which will degrade performance considerably due to excessive logging. The recommended logging level for production is <literal>WARN</literal>.</para>
 
-      <para>For more information on how to configure log4j, please consult the log4j documentation.</para>
-
-      <para>If using the log4j binding please ensure to set the log level for org.apache.qpid explicitly. Otherwise log4j will default to DEBUG which will degrade performance considerably due to excessive logging. Recommended logging level for production is WARN.</para>
+      <para>The following example shows the logging properties used to configure client logging for slf4j using the log4j binding. These properties can be placed in a log4j.properties file and placed in the <varname>CLASSPATH</varname>, or they can be set explicitly using the -Dlog4j.configuration property.</para>
 
       <example>
 	<title>log4j Logging Properties</title>
-	<para>You could place the snippet below in a log4j.properties file and place it in the classpath or explicitly specify it using the -Dlog4j.configuration property. The following configures the qpid client to log at the WARN level</para>
+
 	<programlisting><![CDATA[
 log4j.logger.org.apache.qpid=WARN, console
 log4j.additivity.org.apache.qpid=false
@@ -3066,7 +3064,9 @@ log4j.appender.console.layout=org.apache
 log4j.appender.console.layout.ConversionPattern=%t %d %p [%c{4}] %m%n
 ]]></programlisting>
       </example> 
+
     </section>
+
   </chapter>
 
   <chapter id="QpidWCF">



---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:commits-subscribe@qpid.apache.org