[slf4j-dev] svn commit: r809 - in slf4j/trunk: slf4j-archetype/src/main/resources/META-INF/maven slf4j-archetype/src/main/resources/archetype-resources/src/main/java slf4j-site/src/site/pages slf4j-site/src/site/pages/templates

ceki at slf4j.org ceki at slf4j.org
Wed May 16 23:38:00 CEST 2007


Author: ceki
Date: Wed May 16 23:38:00 2007
New Revision: 809

Removed:
   slf4j/trunk/slf4j-archetype/src/main/resources/archetype-resources/src/main/java/LoggerFactory.java
   slf4j/trunk/slf4j-archetype/src/main/resources/archetype-resources/src/main/java/MarkerFactory.java
Modified:
   slf4j/trunk/slf4j-archetype/src/main/resources/META-INF/maven/archetype.xml
   slf4j/trunk/slf4j-site/src/site/pages/codes.html
   slf4j/trunk/slf4j-site/src/site/pages/faq.html
   slf4j/trunk/slf4j-site/src/site/pages/index.html
   slf4j/trunk/slf4j-site/src/site/pages/news.html
   slf4j/trunk/slf4j-site/src/site/pages/templates/right.js

Log:
- updating slf4j-archetype/pom.xml to match latest changes
- doc enhancements

Modified: slf4j/trunk/slf4j-archetype/src/main/resources/META-INF/maven/archetype.xml
==============================================================================
--- slf4j/trunk/slf4j-archetype/src/main/resources/META-INF/maven/archetype.xml	(original)
+++ slf4j/trunk/slf4j-archetype/src/main/resources/META-INF/maven/archetype.xml	Wed May 16 23:38:00 2007
@@ -2,10 +2,9 @@
 <archetype>
   <id>slf4j-archetype</id>
   <sources>
-    <source>src/main/java/LoggerFactory.java</source>
-    <source>src/main/java/MarkerFactory.java</source>
     <source>src/main/java/impl/StaticLoggerBinder.java</source>
     <source>src/main/java/impl/StaticMarkerBinder.java</source>
+    <source>src/main/java/impl/*.java</source>
   </sources>
   <testSources>
     <source>src/test/java/InvocationTest.java</source>

Modified: slf4j/trunk/slf4j-site/src/site/pages/codes.html
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/codes.html	(original)
+++ slf4j/trunk/slf4j-site/src/site/pages/codes.html	Wed May 16 23:38:00 2007
@@ -69,10 +69,26 @@
     appropriate SLF4J binding could be found. Placing one of
     <em>slf4j-nop.jar</em>, <em>slf4j-simple.jar</em>,
     <em>slf4j-log4j12.jar</em>, <em>slf4j-jdk14.jar</em> or
-    <em>logback-classic.jar</em> should prove to be an effective
-    remedy.
+    <em>logback-classic.jar</em> on the class path should prove to be
+    an effective remedy.
     </p>
 
+     <a name="StaticLoggerBinder">
+    </a>
+    
+    <h3>Failed to load class
+    <code>org.slf4j.impl.StaticLoggerBinder</code></h3>
+    
+    <p>This error is reported when the
+    <code>org.slf4j.impl.StaticLoggerBinder</code> class could not be
+    loaded into memory.  This happens when no appropriate SLF4J
+    binding could be found on the class path. Placing one of
+    <em>slf4j-nop.jar</em>, <em>slf4j-simple.jar</em>,
+    <em>slf4j-log4j12.jar</em>, <em>slf4j-jdk14.jar</em> or
+    <em>logback-classic.jar</em> on the class path should solve the
+    problem.
+    </p>
+    
 
 </div>
 </body>

Modified: slf4j/trunk/slf4j-site/src/site/pages/faq.html
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/faq.html	(original)
+++ slf4j/trunk/slf4j-site/src/site/pages/faq.html	Wed May 16 23:38:00 2007
@@ -25,67 +25,90 @@
 
     <ol type="1">
       <li><a href="#what_is">What is SLF4J?</a></li>
-
+      
       <li><a href="#when">When should SLF4J be used?</a></li>
       
       <li><a href="#yet_another_facade"> Is SLF4J yet another loggingfacade?</a></li>
+      
+      <li>
+        <a href="#why_new_project"> If SLF4J fixes JCL, then why
+        wasn't the fix made in JCL instead of creating a new project?
+        </a>
+      </li>
 
-      <li><a href="#why_new_project"> If SLF4J fixes JCL, then why
-      wasn't the fix made in JCL instead of creating a new project?
-      </a></li>
-
-      <li><a href="#need_to_recompile"> When using SLF4J, do I have to
-      recompile my application to switch to a different logging
-      system?  </a></li>
+      <li>
+        <a href="#need_to_recompile"> When using SLF4J, do I have to
+        recompile my application to switch to a different logging
+        system?  
+        </a>
+      </li>
 
       <li><a href="#requirements">What are SLF4J's requirements?</a></li>
 
 
-      <li><a href="#license">Why is SLF4J licensed under X11 type
-      license instead of the Apache Software License?  </a></li>
+      <li>
+        <a href="#license">Why is SLF4J licensed under X11 type
+      license instead of the Apache Software License?  
+        </a>
+      </li>
 
-      <li><a href="#where_is_binding">Where can I get a particular
-      SLF4J binding?  </a></li>
+      <li>
+        <a href="#where_is_binding">Where can I get a particular
+        SLF4J binding?
+        </a>
+      </li>
 
-      <li><a href="#configure_logging">Should my library attempt to
-      configure logging?
-      </a>
+      <li>
+        <a href="#configure_logging">Should my library attempt to
+        configure logging?
+        </a>
       </li>
 
-      <li><a href="#maven2">What about Maven 2 transitive
-      dependencies?
-      </a>
+      <li>
+        <a href="#maven2">What about Maven 2 transitive
+        dependencies?
+        </a>
       </li>
     </ol>
 
 
-      <b>About the SLF4J API</b>
-
-      <ol type="1">
-
-      <li><a href="#string_or_object"> Why don't the printing methods
-      in the Logger interface accept message of type Object, but only
-      messages of type String?  </a></li>
+    <b>About the SLF4J API</b>
+    
+    <ol type="1">
+      
+      <li>
+        <a href="#string_or_object"> Why don't the printing methods
+        in the Logger interface accept message of type Object, but only
+        messages of type String?  
+        </a>
+      </li>
 
-      <li><a href="#exception_message">
-      Can I log an exception without an accompanying message?
-      </a></li>
+      <li>
+        <a href="#exception_message">
+          Can I log an exception without an accompanying message?
+        </a>
+      </li>
 
 
-      <li><a href="#logging_performance"> What is the fastest way of
-      (not) logging?  </a></li>
+      <li>
+        <a href="#logging_performance"> What is the fastest way of
+        (not) logging?
+        </a>
+      </li>
 
-      <li><a href="#string_contents"> How can I log the string
-      contents of a single (possibly complex) object?  </a></li>
+      <li>
+        <a href="#string_contents"> How can I log the string contents
+        of a single (possibly complex) object?
+        </a>
+      </li>
 
 
       <li><a href="#fatal"> Why doesn't the
       <code>org.slf4j.Logger</code> interface have methods for the
       FATAL level?  </a></li>
 
-      <li><a href="#trace"> Why doesn't the
-      <code>org.slf4j.Logger</code> interface have methods for the
-      TRACE level?  </a></li></ol>
+      <li><a href="#trace">Why was the TRACE level introduced only in
+        SLF4J version 1.4.0?  </a></li></ol>
 
 
       <b>Implementing the SLF4J API</b>
@@ -385,7 +408,7 @@
        <p class="source">&lt;dependency&gt;
   &lt;groupId&gt;org.slf4j&lt;/groupId&gt;
   &lt;artifactId&gt;slf4j-api&lt;/artifactId&gt;
-  &lt;version&gt;1.3.0&lt;/version&gt;
+  &lt;version&gt;${project.version}&lt;/version&gt;
 &lt;/dependency&gt;</p>
 
        <p>&nbsp;</p>         
@@ -399,7 +422,7 @@
        <p class="source">&lt;dependency&gt;
   &lt;groupId&gt;org.slf4j&lt;/groupId&gt;
   &lt;artifactId&gt;slf4j-log4j12&lt;/artifactId&gt;
-  &lt;version&gt;1.3.0&lt;/version&gt;
+  &lt;version&gt;${project.version}&lt;/version&gt;
   <b>&lt;scope&gt;test&lt;/scope&gt;</b>
 &lt;/dependency&gt;</p>
 
@@ -663,39 +686,78 @@
         meriting close attention, we are inclined to believe that the
         FATAL level is superfluous.
        </p>
-      <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /></dd><dt><a name="trace">
-      Why doesn't the <code>org.slf4j.Logger</code> interface
-      have methods for the TRACE level?
-      </a></dt><dd>
+
+       <table border="0">
+         <tr>
+           <td align="right">
+             <a href="#top">[top]</a>
+           </td>
+         </tr>
+       </table>
+
+       <hr />
+      </dd>
+
+      <dt>
+        <a name="trace">Why was the TRACE level introduced only in
+        SLF4J version 1.4.0?
+        </a>
+      </dt>
+        
+      <dd>
 
         <p>The addition of the TRACE level has been frequently and
-        hotly debated request. By studying various projects, it looks
-        like the TRACE level is mostly used to disable logging output
-        from certain classes without needing to configure logging for
-        those classes. Indeed, the TRACE level is by default disabled
-        in log4j and other logging systems. We believe that the same
-        result could be achieved by adding the appropriate directives
-        in configuration files.
-       </p>
+        hotly debated request. By studying various projects, we
+        observed that the TRACE level was used to disable logging
+        output from certain classes <em>without</em> needing to
+        configure logging for those classes. Indeed, the TRACE level
+        is by default disabled in log4j and logback as well most other
+        logging systems. The same result can be achieved by adding the
+        appropriate directives in configuration files.
+        </p>
 
-        <p>Thus, in the majority of cases the TRACE level has the same
-        semantic meaning as DEBUG. In such case, the TRACE level
-        merely saves a few configuration directives. In the rare but
-        interesting cases where TRACE has a different meaning than
-        DEBUG, <a href="api/org/slf4j/Marker.html">Marker</a> objects
-        can be put to use to convey the desired new meaning. 
-       </p>
+        <p>Thus, in many of cases the TRACE level carried the same
+        semantic meaning as DEBUG. In such cases, the TRACE level
+        merely saves a few configuration directives. In other, more
+        interesting occasions, where TRACE carries a different meaning
+        than DEBUG, <a href="api/org/slf4j/Marker.html">Marker</a>
+        objects can be put to use to convey the desired
+        meaning. However, if you can't be bothered with markers and
+        wish to use a logging level lower than DEBUG, the TRACE level
+        can get the job done.
+        </p>
+
+        <p>Note that while the cost of evaluating a disabled log
+        request is in the order of a few <code>nanoseconds</code>, the
+        use of the TRACE level (or any other level for that matter) is
+        discouraged in tight loops where the log request might be
+        evaluated millions of times. If the log request is enabled,
+        then it will overwhelm the target destination with massive
+        output. If the request is disabled, it will waste resources.
+        </p>
       
-       <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table>
+        <p>In short, although we still discourage the use of the TRACE
+        level because alternatives exist or because in many cases log
+        requests of level TRACE are wasteful, given that people kept
+        asking for it, we decided to bow to popular demand.
+        </p>
 
-       </dd>
-       </dl>
-     </div>
+        <table border="0">
+          <tr>
+            <td align="right">
+              <a href="#top">[top]</a>
+            </td>
+          </tr>
+        </table>
+
+      </dd>
+    </dl>
+  </div>
 
 
-      <div class="section">
+  <div class="section">
 
-        <h2>Implementing the SLF4J API</h2><dl><dt><a name="slf4j_compatible">
+    <h2>Implementing the SLF4J API</h2><dl><dt><a name="slf4j_compatible">
         How do I make my logging framework SLF4J
         compatible?
         </a>

Modified: slf4j/trunk/slf4j-site/src/site/pages/index.html
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/index.html	(original)
+++ slf4j/trunk/slf4j-site/src/site/pages/index.html	Wed May 16 23:38:00 2007
@@ -31,11 +31,11 @@
   </p>
 
   <p>Logging API implementations can either choose to implement the
-  the SLF4J interfaces directly, e.g. <a
+  the SLF4J interfaces directly, &agrave; la <a
   href="http://logback.qos.ch">logback</a> or <a
   href="api/org/slf4j/impl/SimpleLogger.html">SimpleLogger</a>. Alternatively,
-  it is possible (and rather easy) to write SLF4J adapters for the
-  given API implementation, e.g. <a
+  it is possible (and rather easy) to write SLF4J adapters for a given
+  API implementation, e.g. <a
   href="api/org/slf4j/impl/Log4jLoggerAdapter.html">Log4jLoggerAdapter</a>
   or <a
   href="api/org/slf4j/impl/JDK14LoggerAdapter.html">JDK14LoggerAdapter</a>..
@@ -74,27 +74,38 @@
 
   <table border="0">
     <tr>
-      <td>
+      <td  valign="top">
         <ul>
           <li><a href="http://directory.apache.org/">Apache Directory</a></li>
+          <li><a href="http://incubator.apache.org/ftpserver/">Apache FTPServer</a></li>
           <li><a href="http://incubator.apache.org/graffito/">Apache Graffito</a></li>
           <li><a href=" http://jackrabbit.apache.org/">Apache Jackrabbit</a></li>
           <li><a href="http://mina.apache.org/">Apache Mina</a></li>
-          <li><a href="http://incubator.apache.org/wicket/">Apache Wicket 2.0</a></li>
+          <li><a href="http://incubator.apache.org/wicket/">Apache Wicket</a></li>
           <li><a href="http://apogee.nuxeo.org/">Apogee</a></li>
           <li><a href="http://www.bitronix.be/">Bitronix</a></li>
-          <li><a href="http://ha-jdbc.sourceforge.net/">HA-JDBC: High-Availability JDBC</a></li> 
-          <li><a href="http://jetty.mortbay.org/">Jetty v6</a></li>
-          <li><a href="http://www.topmind.biz/html/index.php">jLynx</a></li>
+          <li><a href="http://ha-jdbc.sourceforge.net/">HA-JDBC: High-Availability JDBC</a></li>         
         </ul>
       </td>
-      <td>
+
+      <td  valign="top">
         <ul>
+          <li><a href="http://jetty.mortbay.org/">Jetty v6</a></li>
+          <li><a href="http://www.topmind.biz/html/index.php">jLynx</a></li>
+          <li><a href="http://code.google.com/p/jmesa/">JMesa</a></li>
           <li><a href="http://jwebunit.sourceforge.net/2.x/">JWebUnit 2.x</a></li>
           <li><a href="http://www.liferay.com/web/guest/home">LIFERAY</a></li>                    
-          <li><a href="http://mule.codehaus.org/display/MULE/Home">Mule</a></li>
+          <li><a href="http://mule.codehaus.org/display/MULE/Home">Mule</a></li>   
           <li><a href="http://www.unidata.ucar.edu/software/netcdf-java/">NetCDF</a></li>
           <li><a href="http://proximity.abstracthorizon.org/index.html">Proximity</a></li>
+          <li><a href="http://pzfilereader.sourceforge.net/">PZFileReader</a></li>
+
+        </ul>
+
+      </td>
+
+      <td valign="top">
+        <ul>
           <li><a href="http://www.quickfixj.org/">QuickFIX/J</a></li>
           <li><a href="http://www.restlet.org/about/">Restlet</a></li>
           <li><a href="http://smsj.sourceforge.net/dependencies.html">SMSJ</a></li>
@@ -102,6 +113,7 @@
           <li><a href="http://yaslibrary.sourceforge.net/index.shtml">YASL</a></li>
         </ul>
       </td>
+
     </tr>
   </table>
 </div>

Modified: slf4j/trunk/slf4j-site/src/site/pages/news.html
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/news.html	(original)
+++ slf4j/trunk/slf4j-site/src/site/pages/news.html	Wed May 16 23:38:00 2007
@@ -28,6 +28,16 @@
   announce</a> mailing list.
   </p>
 
+  <hr noshade="noshade" size="1"/>
+
+  <h3>May 16th, 2007 - Release of SLF4J 1.4.0</h3>
+
+
+  <p>In response to many user requests over time, the TRACE level has
+  been added to <a href="">org.slf4j.Logger</a> interface. Please also
+  see the <a href="">FAQ entry discussing</a> the TRACE level.
+  </p>
+
 
   <hr noshade="noshade" size="1"/>
 

Modified: slf4j/trunk/slf4j-site/src/site/pages/templates/right.js
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/templates/right.js	(original)
+++ slf4j/trunk/slf4j-site/src/site/pages/templates/right.js	Wed May 16 23:38:00 2007
@@ -1,6 +1,11 @@
 
 document.write('<p class="menu_header">SLF4J-related buzz</p>');
 
+http://blog.lukas-vlcek.com/2007/05/jakarta-commons-logging-and-slf4j.html
+
+document.write('<p class="rm small"><a href="http://blog.lukas-vlcek.com/2007/05/jakarta-commons-logging-and-slf4j.html">JCL and SLF4J</a>');
+document.write('</p>');
+
 
 document.write('<p class="rm small"><a href="http://hohonuuli.blogspot.com/2007/04/sl4j-code-template-for-netbeans-i-use.html">Code Template for Netbeans</a>');
 document.write('</p>');



More information about the slf4j-dev mailing list