[logback-dev] svn commit: r1043 - in logback/trunk/logback-site/src/site: fml xdocTemplates xdocTemplates/manual

noreply.seb at qos.ch noreply.seb at qos.ch
Thu Nov 30 16:57:30 CET 2006


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>



More information about the logback-dev mailing list