[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 © 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><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><Ref id="requestLog">
<Set name="requestLog">
@@ -152,25 +118,27 @@
</New>
</Set>
</Ref></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><Ref id="requestLog">
+
+ <div class="source"><pre><Ref id="requestLog">
<Set name="requestLog">
<New id="requestLogImpl"
class="ch.qos.logback.access.jetty.RequestLogImpl">
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ülcü, Sébastien Pennec');
+document.write(' <br/>');
+document.write(' Copyright © 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