[logback-dev] svn commit: r1468 - in logback/trunk/logback-site/src/site/pages: . images manual templates

noreply.ceki at qos.ch noreply.ceki at qos.ch
Tue Mar 27 20:41:04 CEST 2007


Author: ceki
Date: Tue Mar 27 20:41:04 2007
New Revision: 1468

Added:
   logback/trunk/logback-site/src/site/pages/images/
   logback/trunk/logback-site/src/site/pages/images/qoslogo.gif   (contents, props changed)
   logback/trunk/logback-site/src/site/pages/templates/creative.js
Modified:
   logback/trunk/logback-site/src/site/pages/access.html
   logback/trunk/logback-site/src/site/pages/manual/layouts.html
   logback/trunk/logback-site/src/site/pages/news.html

Log:
doc updates

Modified: logback/trunk/logback-site/src/site/pages/access.html
==============================================================================
--- logback/trunk/logback-site/src/site/pages/access.html	(original)
+++ logback/trunk/logback-site/src/site/pages/access.html	Tue Mar 27 20:41:04 2007
@@ -25,50 +25,19 @@
 		</div>
 
 
-		<table>
-			<tr>
-				<td valign="top" align="top">
-						<a rel="license"
-							href="http://creativecommons.org/licenses/by-nc-sa/2.5/">
-							<img alt="Creative Commons License"
-								style="border-width: 0"
-								src="http://creativecommons.org/images/public/somerights20.png" />
-						</a>
-				</td>
-				<td>
-					<p>Copyright &#169; 2000-2006, QOS.ch</p>
-
-					<p>
-						<!--Creative Commons License-->
-						This work is licensed under a
-						<a rel="license"
-							href="http://creativecommons.org/licenses/by-nc-sa/2.5/">
-							Creative Commons
-							Attribution-NonCommercial-ShareAlike 2.5
-							License
-						</a>
-						.
-						<!--/Creative Commons License-->
-					</p>
-				</td>
-			</tr>
-		</table>
-
-
-		<h2>Introduction</h2>
-
-		<p>
-			Logback was designed as a modular framework from the start. Being
-			able to use logback's internal core in many situations, without
-			heavy coding or complex specific configuration was one of our
-			goals.
-		</p>
+   <script src="../templates/creative.js"></script>
 
-		<p>
-			Lobgack access integrates with Servlet containers such as Jetty
-			and Tomcat to provide HTTP-access log functionality.
+		<h1>Introduction</h1>
+
+		<p>Logback was designed as a modular framework from the
+			start. Making logback-core reusable under different
+			circumstances, without too much coding was one of our main
+			goals. As such, logback-access builds on top of logback-core. It
+			fully integrates with Servlet containers such as Jetty or Tomcat
+			to provide HTTP-access log functionality.
 		</p>
 
+    <a name="tomcat"></a>
 		<h2>Logback Access and Tomcat</h2>
 		
 		<p>
@@ -82,40 +51,38 @@
 		
 		<h3>LogbackValve</h3>
 
-		<p>
-			The <a href="xref/ch/qos/logback/access/tomcat/LogbackValve.html">
-			<code>ch.qos.logback.access.tomcat.LogbackValve</code></a>
-			class extends Tomcat's <code><a
+		<p>The <a
+			href="xref/ch/qos/logback/access/tomcat/LogbackValve.html">
+			<code>ch.qos.logback.access.tomcat.LogbackValve</code></a> class
+			extends Tomcat's <code><a
 			href="http://tomcat.apache.org/tomcat-5.5-doc/catalina/docs/api/org/apache/catalina/valves/ValveBase.html">
-			ValveBase</a></code>
-			class. This class is used to allow external
+			ValveBase</a></code> class. This class is used to allow external
 			components to be integrated into Tomcat.
 		</p>
 	
-		<p>
-			To configure Tomcat in order to use
-			<code>LogbackValve</code>,  add the following lines
-			to the tomcat server configuration file, namely <em>$TOMCAT_HOME/conf/server.xml</em>:
+		<p>To configure Tomcat in order to use <code>LogbackValve</code>,
+			add the following lines to the tomcat server configuration file,
+			namely <em>$TOMCAT_HOME/conf/server.xml</em>:
 		</p>
 		<div class="source"><pre>&lt;Valve className="ch.qos.logback.access.tomcat.LogbackValve"/></pre></div>
-		<p>
-			This line need to be nested in an <em>Engine</em> element.
+
+		<p>This line need to be nested in an <em>Engine</em> element.
 		</p>
-		<p>
-			By default, <code>LogbackValve</code> looks for a logback
+
+		<p>By default, <code>LogbackValve</code> looks for a logback
 			configuration file called <em>logback-access.xml</em>, in the
-			same folder where <em>server.xml</em> is located, that is
-			in <em>$TOMCAT_HOME/conf/</em>. This
-			configuration file contains directives for configuring logback
-			components. Among others, you can specify the appenders where
-			the logging requests will be sent, and their format. Please refer
-			to the description below about logback access configuration for examples.
+			same folder where <em>server.xml</em> is located, that is in
+			<em>$TOMCAT_HOME/conf/</em>. This configuration file contains
+			directives for configuring logback components. Among others, you
+			can specify the appenders where the logging requests will be
+			sent, and their format. Please refer to the description below
+			about logback access configuration for examples.
 	</p>
 		
+    <a name="jetty"></a>
 		<h2>Logback Access and Jetty</h2>
 
-		<p>
-			To use logback-access with Jetty, after downlading the logback
+		<p>To use logback-access with Jetty, after downlading the logback
 			distribution, place the files <em>logback-core-VERSION.jar</em>
 			and <em>logback-access-VERSION.jar</em> under $JETTY_HOME/lib
 			directory, where $JETTY_HOME is the folder where you have
@@ -125,8 +92,8 @@
 
 		<h3>Logback's RequestLog implementation</h3>
 
-		<p>
-			The <a href="xref/ch/qos/logback/access/jetty/RequestLogImpl.html">
+		<p>The <a
+			href="xref/ch/qos/logback/access/jetty/RequestLogImpl.html">
 			<code>ch.qos.logback.access.jetty.RequestLogImpl</code></a>
 			class implements jetty's <code><a
 			href="http://jetty.mortbay.org/apidocs/org/mortbay/jetty/RequestLog.html">RequestLog</a></code>
@@ -134,16 +101,15 @@
 			components to manage request logging.
 		</p>
 
-		<p>
-			In logback, logging destinations are called Appenders. These classes
-			can be attached directly to <code>RequestLogImpl</code>.
+		<p>In logback, logging destinations are called Appenders. These
+			classes can be attached directly to <code>RequestLogImpl</code>.
 		</p>
 
 	
-		<p>
-			To configure jetty in order to use logback's
-			<code>RequestLogImpl</code>,  add the following lines
-			to the jetty configuration file, namely <em>$JETTY_HOME/etc/jetty.xml</em>:
+		<p>To configure jetty in order to use logback's
+			<code>RequestLogImpl</code>, add the following lines to the
+			jetty configuration file, namely
+			<em>$JETTY_HOME/etc/jetty.xml</em>:
 		</p>
 		<div class="source"><pre>&lt;Ref id="requestLog"&gt;
   &lt;Set name="requestLog"&gt;
@@ -152,25 +118,27 @@
     &lt;/New&gt;
   &lt;/Set&gt;
 &lt;/Ref&gt;</pre></div>
-		<p>
-			These lines reference the requestLog functionnality of Jetty, setting
-			the actual class that will be called at each logging request.
+
+		<p>These lines reference the requestLog functionnality of Jetty,
+		setting the actual class that will be called at each logging
+		request.
 		</p>
-		<p>
-			By default, <code>RequestLogImpl</code> looks for a logback
-			configuration file called <em>logback-access.xml</em>, in the
-			same folder where <em>jetty.xml</em> is located. This
-			configuration file contains directives for configuring logback
-			components. Among others, you can specify the appenders where
-			the logging requests will be sent, and their format.
-	</p>
+
+		<p>By default, <code>RequestLogImpl</code> looks for a logback
+		configuration file called <em>logback-access.xml</em>, in the same
+		folder where <em>jetty.xml</em> is located. This configuration
+		file contains directives for configuring logback components. Among
+		others, you can specify the appenders where the logging requests
+		will be sent, and their format.
+    </p>
 	
 		<p>As long the path is specified, you can place the logback
-	configuration file in any location. Here is another example of
-	jetty configuration file, with a path to the logback access
-	configuration file.
+		configuration file in any location. Here is another example of
+		jetty configuration file, with a path to the logback access
+		configuration file.
 		</p>
-		<div class="source"><pre>&lt;Ref id="requestLog"&gt;
+		
+    <div class="source"><pre>&lt;Ref id="requestLog"&gt;
   &lt;Set name="requestLog"&gt;
     &lt;New id="requestLogImpl"
       class="ch.qos.logback.access.jetty.RequestLogImpl"&gt;

Added: logback/trunk/logback-site/src/site/pages/images/qoslogo.gif
==============================================================================
Binary file. No diff available.

Modified: logback/trunk/logback-site/src/site/pages/manual/layouts.html
==============================================================================
--- logback/trunk/logback-site/src/site/pages/manual/layouts.html	(original)
+++ logback/trunk/logback-site/src/site/pages/manual/layouts.html	Tue Mar 27 20:41:04 2007
@@ -1707,9 +1707,8 @@
     <tr class="a">
       <td align="center"><b>fullRequest</b></td>
       <td>
-        <p>
-          This conversion word takes all the available headers of the
-          request and displays their values.
+        <p>This converter outputs the data associated with the
+          request, including all headers and request contents.
         </p>
       </td>
     </tr>
@@ -1733,8 +1732,9 @@
       <td align="center"><b>fullResponse</b></td>
       <td>
         <p>
-          This conversion word takes all the available headers of the
-          response and displays their values.
+          This conversion word takes all the available data
+          associatede with the response, inclusing all headers of the
+          response and response contents.
         </p>
       </td>
     </tr>

Modified: logback/trunk/logback-site/src/site/pages/news.html
==============================================================================
--- logback/trunk/logback-site/src/site/pages/news.html	(original)
+++ logback/trunk/logback-site/src/site/pages/news.html	Tue Mar 27 20:41:04 2007
@@ -28,10 +28,14 @@
 
   <hr width="80%" align="center" />
   
-    <h3>MMMMM DDth, 2007 - Release of version 0.9.X</h3>
+    <h3>xxxx , 2007 - Release of version 0.9.4</h3>
     
-    <p>
-     what's new...
+    <p>Significant bug fixes made to <code>TeeFilter</code> and
+    Co. located in the logback-access module. Images and other binary
+    files are now intercepted and replayed correctly. As for
+    "x-www-form-urlencoded" post requests, their input buffer is left
+    untouched. In a best-effort attempt, the input buffer is later
+    reconstructed. However, it may differ from the original.
     </p>
 
     <h3>March 20th, 2007 - Release of version 0.9.3</h3>

Added: logback/trunk/logback-site/src/site/pages/templates/creative.js
==============================================================================
--- (empty file)
+++ logback/trunk/logback-site/src/site/pages/templates/creative.js	Tue Mar 27 20:41:04 2007
@@ -0,0 +1,33 @@
+document.write('		<table style="margin-left: 0em; padding-top=0ex" cellpadding="0" ');
+document.write('           cellspacing="0" width="70%">');
+document.write('      <tr>');
+document.write('        <td>        ');
+document.write('          <p class="author">');
+document.write('            Authors: Ceki G&#252;lc&#252;, S&#233;bastien Pennec');
+document.write('          <br/>');
+document.write('          Copyright &#169; 2000-2006, QOS.ch</p>');
+document.write('        </td>');
+document.write('        <td>');
+document.write('            <a rel="license"');
+document.write('               href="http://creativecommons.org/licenses/by-nc-sa/2.5/">');
+document.write('        <img alt="Creative Commons License"');
+document.write('             style="border-width: 0; margin-left: 1em"');
+document.write('             src="http://creativecommons.org/images/public/somerights20.png" />');
+document.write('          </a>');
+document.write('        </td>');
+document.write('      </tr>');
+document.write('      <tr>');
+document.write('        <td>');
+document.write('          <p>');
+document.write('            This document is licensed under a');
+document.write('            <a rel="license"');
+document.write('               href="http://creativecommons.org/licenses/by-nc-sa/2.5/">');
+document.write('              Creative Commons');
+document.write('              Attribution-NonCommercial-ShareAlike 2.5');
+document.write('              License');
+document.write('            </a>');
+document.write('          </p>');
+document.write('        </td>');
+document.write('        <td></td>');
+document.write('			</tr>');
+document.write('		</table>');



More information about the logback-dev mailing list