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><configuration> + + <appender name="DB" class="ch.qos.logback.access.db.DBAppender"> + <connectionSource class="ch.qos.logback.core.db.DriverManagerConnectionSource"> + <driverClass>com.mysql.jdbc.Driver</driverClass> + <url>jdbc:mysql://localhost:3306/logbackdb</url> + <user>logback</user> + <password>logback</password> + </connectionSource> + <insertHeaders>true</insertHeaders> + </appender> + + <appender-ref ref="DB" /> +</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>