Author: seb
Date: Thu Nov 30 16:57:30 2006
New Revision: 1043

Modified:
   logback/trunk/logback-site/src/site/fml/faq.fml
   logback/trunk/logback-site/src/site/xdocTemplates/manual/appenders.xml
   logback/trunk/logback-site/src/site/xdocTemplates/news.xml

Log:
Added a first draft of "what's new".
Added an entry in the faq about automatic configuration
Improved documentation

Modified: logback/trunk/logback-site/src/site/fml/faq.fml
==============================================================================
--- logback/trunk/logback-site/src/site/fml/faq.fml     (original)
+++ logback/trunk/logback-site/src/site/fml/faq.fml     Thu Nov 30 16:57:30 2006
@@ -46,6 +46,30 @@
                                                </p>
                                        </answer>
                                </faq>
+                               
+                               <faq id="auto_config">
+          
+          <question>
+                                               How does the automatic 
configuration work?
+                                       </question>
+
+                                       <answer>
+                                               <p>
+                                                       If a file called 
<em>logback.xml</em> is found in the
+                                                       classpath, then it is 
used.
+                                               </p>
+                                               <p>In case it is not found, a 
<em>logback-test.xml</em> file 
+                                               is searched, and used if 
available.
+                                               </p>
+                                               <p>
+                                                       If none of these files 
are available, logback uses its 
+                                                       
<code>BasicConfiguratory</code> class to create a simple default 
+                                                       configuration that will 
only log to the console.
+                                               </p>
+                                       </answer>
+                               </faq>
+                               
+                               
                        </part>
                </faqs>
        </body>

Modified: logback/trunk/logback-site/src/site/xdocTemplates/manual/appenders.xml
==============================================================================
--- logback/trunk/logback-site/src/site/xdocTemplates/manual/appenders.xml      
(original)
+++ logback/trunk/logback-site/src/site/xdocTemplates/manual/appenders.xml      
Thu Nov 30 16:57:30 2006
@@ -2320,7 +2320,7 @@
                                        <code>String</code>
                                </td>
                                <td>
-                                       The port number on the syslog server to 
connect to. Nornally, one would not want 
+                                       The port number on the syslog server to 
connect to. Normally, one would not want 
                                        to change the default value, that is 
<em>514</em>.
                                </td>
                        </tr>
@@ -2430,7 +2430,7 @@
                </p>
                <p>
                        The options of access' <code>SocketAppender</code> are 
the same as those available
-                       for classc's <code>SocketAppender</code>.
+                       for classic's <code>SocketAppender</code>.
                </p>
 
                <a name="AccessSMTPAppender"/>  
@@ -2587,9 +2587,51 @@
                        </table>
 
                <p>
-                       The options of access' <code>DBAppender</code> are the 
same as those available
-                       for classc's <code>DBAppender</code>.
+                       All options of classic's <code>DBAppender</code> are 
available
+                       in access' <code>DBAppender</code>. The latter offers 
one more option,
+                       described below.
                </p>
+               
+               <table>
+                       <tr>
+                               <th>Option Name</th>
+                               <th>Type</th>
+                               <th>Description</th>
+                       </tr>
+                       <tr>
+                               <td>
+                                       <b>
+                                               <span 
class="option">insertHeaders</span>
+                                       </b>
+                               </td>
+                               <td>
+                                       <code>boolean</code>
+                               </td>
+                               <td>
+                                       Tells the <code>DBAppender</code> to 
populate the database with the header
+                                       information of all incoming requests.
+                               </td>
+                       </tr>
+               </table>
+               
+               <p>
+                       Here is a sample configuration that uses 
<code>DBAppender</code>.
+               </p>
+               
+<div class="source"><pre>&lt;configuration>
+
+  &lt;appender name="DB" class="ch.qos.logback.access.db.DBAppender">
+    &lt;connectionSource 
class="ch.qos.logback.core.db.DriverManagerConnectionSource">
+      &lt;driverClass>com.mysql.jdbc.Driver&lt;/driverClass>
+      &lt;url>jdbc:mysql://localhost:3306/logbackdb&lt;/url>
+      &lt;user>logback&lt;/user>
+      &lt;password>logback&lt;/password>
+    &lt;/connectionSource>
+    &lt;insertHeaders>true&lt;/insertHeaders>
+  &lt;/appender>
+
+  &lt;appender-ref ref="DB" />
+&lt;/configuration></pre></div>
 
        </body>
 </document>
\ No newline at end of file

Modified: logback/trunk/logback-site/src/site/xdocTemplates/news.xml
==============================================================================
--- logback/trunk/logback-site/src/site/xdocTemplates/news.xml  (original)
+++ logback/trunk/logback-site/src/site/xdocTemplates/news.xml  Thu Nov 30 
16:57:30 2006
@@ -3,6 +3,7 @@
 
        <properties>
                <author email="ceki at qos ddoott ch ">Ceki Gulcu</author>
+               <author email="sebastien at qos ddoott ch ">Sebastien 
Pennec</author>
                <title>${pom.name} download</title>
        </properties>
 
@@ -11,6 +12,47 @@
 
                <p>Here are the lastest news about logback.</p>
 
+               <h3>November 30th, 2006 - Release of version 0.6</h3>
+
+    <p>
+      Version 0.6 of logback has been released.
+               </p>
+
+               <p>
+                       Logback classic now supports automatic configuration, 
allowing test and production
+                       environment configuration. <code>TurboFilters</code> 
make their first appearance
+                       in a logback release. They provide ultra-fast filtering 
possibilities.
+                       The logging context now supports listeners which will 
be contacted each
+                       time the context is reset or started. 
<code>SMTPAppender</code> 
+                       allows for much more flexible configuration than before.
+               </p>
+               
+               <p>
+                       In logback access, new Appenders are available, namely 
<code>SocketAppender</code> 
+                       and <code>DBAppender</code>. 
+                       Logback access now supports filtering and event 
evaluations. A <code>CountingFilter</code>
+                       has been added. It provides statistical views of server 
access, reachable
+                       via JMX.
+               </p>
+               
+               <p>
+                       The documentation has also been improved. A complete 
new chapter
+                       has been added about Appenders, the short introduction 
to logback
+                       classic has been updated and a new module, containing 
many configuration
+                       examples has been added.
+               </p>
+               
+               <p>
+                       Logback now uses continous integration in its 
development.
+               </p>
+               
+               <p>
+                       Tests have been improved, many new have been added. 
+                       This release also provides some bug fixes.
+               </p>
+
+               <hr width="80%" align="center" />
+               
                <h3>October 26th, 2006 - Release of version 0.5</h3>
 
     <p>
_______________________________________________
logback-dev mailing list
[email protected]
http://qos.ch/mailman/listinfo/logback-dev

Reply via email to