March 2007 - logback-dev - mailman3.qos.ch

svn commit: r1448 - logback/trunk/logback-site/src/site/pages
by noreply.seb＠qos.ch 20 Mar '07

20 Mar '07

Author: seb Date: Tue Mar 20 15:03:22 2007 New Revision: 1448 Modified: logback/trunk/logback-site/src/site/pages/news.html Log: updated news page for next version 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 20 15:03:22 2007 @@ -27,6 +27,12 @@ announce</a> mailing list.</p> <hr width="80%" align="center" /> + + <h3>MMMMM DDth, 2007 - Release of version 0.9.X</h3> + + <p> + what's new... + </p> <h3>March 20th, 2007 - Release of version 0.9.3</h3>

1 0

svn commit: r1447 - in logback/trunk: . log4j-bridge logback-access logback-classic logback-core logback-examples logback-site
by noreply.seb＠qos.ch 20 Mar '07

20 Mar '07

Author: seb Date: Tue Mar 20 15:03:09 2007 New Revision: 1447 Modified: logback/trunk/log4j-bridge/pom.xml logback/trunk/logback-access/pom.xml logback/trunk/logback-classic/pom.xml logback/trunk/logback-core/pom.xml logback/trunk/logback-examples/pom.xml logback/trunk/logback-site/pom.xml logback/trunk/pom.xml Log: New version 0.9.4-SNAPSHOT Modified: logback/trunk/log4j-bridge/pom.xml ============================================================================== --- logback/trunk/log4j-bridge/pom.xml (original) +++ logback/trunk/log4j-bridge/pom.xml Tue Mar 20 15:03:09 2007 @@ -5,14 +5,14 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>ch.qos.logback</groupId> <artifactId>log4j-bridge</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> <packaging>jar</packaging> <name>Log4j Bridge Module</name> Modified: logback/trunk/logback-access/pom.xml ============================================================================== --- logback/trunk/logback-access/pom.xml (original) +++ logback/trunk/logback-access/pom.xml Tue Mar 20 15:03:09 2007 @@ -3,14 +3,14 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>ch.qos.logback</groupId> <artifactId>logback-access</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> <packaging>jar</packaging> <name>Logback Access Module</name> Modified: logback/trunk/logback-classic/pom.xml ============================================================================== --- logback/trunk/logback-classic/pom.xml (original) +++ logback/trunk/logback-classic/pom.xml Tue Mar 20 15:03:09 2007 @@ -5,14 +5,14 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> <packaging>jar</packaging> <name>Logback Classic Module</name> Modified: logback/trunk/logback-core/pom.xml ============================================================================== --- logback/trunk/logback-core/pom.xml (original) +++ logback/trunk/logback-core/pom.xml Tue Mar 20 15:03:09 2007 @@ -5,14 +5,14 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>ch.qos.logback</groupId> <artifactId>logback-core</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> <packaging>jar</packaging> <name>Logback Core Module</name> Modified: logback/trunk/logback-examples/pom.xml ============================================================================== --- logback/trunk/logback-examples/pom.xml (original) +++ logback/trunk/logback-examples/pom.xml Tue Mar 20 15:03:09 2007 @@ -3,14 +3,14 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>ch.qos.logback</groupId> <artifactId>logback-examples</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> <packaging>jar</packaging> <name>Logback Examples Module</name> Modified: logback/trunk/logback-site/pom.xml ============================================================================== --- logback/trunk/logback-site/pom.xml (original) +++ logback/trunk/logback-site/pom.xml Tue Mar 20 15:03:09 2007 @@ -3,7 +3,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> @@ -11,7 +11,7 @@ <groupId>ch.qos.logback</groupId> <artifactId>logback-site</artifactId> <packaging>jar</packaging> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> <name>Logback Site</name> <url>http://logback.qos.ch</url> Modified: logback/trunk/pom.xml ============================================================================== --- logback/trunk/pom.xml (original) +++ logback/trunk/pom.xml Tue Mar 20 15:03:09 2007 @@ -5,7 +5,7 @@ <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3</version> + <version>0.9.4-SNAPSHOT</version> <packaging>pom</packaging> <name>Logback-Parent</name>

1 0

[ANN] Release of logback 0.9.3
by Sebastien Pennec 20 Mar '07

20 Mar '07

March 20th, 2007 - Release of version 0.9.3 Includes in configuration files are now supported by Joran, logback's configuration framework. A file can contain an include element that has a file or url attribute pointing to a configuration file. See the chapter about configuration[1] in the logback's online manual for more information. Corrected bug 53 reported by Wilkins Poe. There is now a dependencies page[2] that shows the requirements of each of logback's modules. After a discussion on the SLF4J mailing list[3] started by Franck Routier, a correction has been made when logging using the JCL104-over-slf4j module. Logback now correctly shows the caller location information. As with most of the logback releases, the documentation has been improved in many aspects. [1]http://logback.qos.ch/manual/joran.html#Include [2]http://logback.qos.ch/dependencies.html [3]http://www.slf4j.org/pipermail/user/2007-March/000297.html -- Sébastien Pennec sebastien(a)qos.ch Logback: The reliable, generic, fast and flexible logging framework for Java. http://logback.qos.ch/

1 0

[continuum] BUILD SUCCESSFUL: Logback Examples Module
by John Noreplai 20 Mar '07

20 Mar '07

Online report : http://localhost:8090/continuum/servlet/continuum/target/ProjectBuild.vm/vi… Build statistics: State: Ok Previous State: Failed Started at: Tue, 20 Mar 2007 14:36:55 +0100 Finished at: Tue, 20 Mar 2007 14:37:05 +0100 Total time: 10s Build Trigger: Forced Exit code: 0 Building machine hostname: pixie Operating system : Linux(unknown) Java version : 1.5.0_08(Sun Microsystems Inc.) Changes No files changed **************************************************************************** Output: **************************************************************************** [INFO] Scanning for projects... [INFO] ---------------------------------------------------------------------------- [INFO] Building Logback Examples Module [INFO] task-segment: [clean, install] [INFO] ---------------------------------------------------------------------------- [INFO] [clean:clean] [INFO] Deleting directory /opt/continuum-1.0.3/apps/continuum/working-directory/50/target [INFO] Deleting directory /opt/continuum-1.0.3/apps/continuum/working-directory/50/target/classes [INFO] Deleting directory /opt/continuum-1.0.3/apps/continuum/working-directory/50/target/test-classes [INFO] [resources:resources] [INFO] Using default encoding to copy filtered resources. [INFO] [compiler:compile] Compiling 49 source files to /opt/continuum-1.0.3/apps/continuum/working-directory/50/target/classes [INFO] [resources:testResources] [INFO] Using default encoding to copy filtered resources. [INFO] [compiler:testCompile] [INFO] No sources to compile [INFO] [surefire:test] [INFO] No tests to run. [INFO] [jar:jar] [INFO] Building jar: /opt/continuum-1.0.3/apps/continuum/working-directory/50/target/logback-examples-0.9.3.jar [INFO] Preparing source:jar [WARNING] Removing: jar from forked lifecycle, to prevent recursive invocation. [INFO] No goals needed for project - skipping [INFO] [source:jar {execution: default}] [INFO] Building jar: /opt/continuum-1.0.3/apps/continuum/working-directory/50/target/logback-examples-0.9.3-sources.jar [INFO] [install:install] [INFO] Installing /opt/continuum-1.0.3/apps/continuum/working-directory/50/target/logback-examples-0.9.3.jar to /root/.m2/repository/ch/qos/logback/logback-examples/0.9.3/logback-examples-0.9.3.jar [INFO] Installing /opt/continuum-1.0.3/apps/continuum/working-directory/50/target/logback-examples-0.9.3-sources.jar to /root/.m2/repository/ch/qos/logback/logback-examples/0.9.3/logback-examples-0.9.3-sources.jar [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESSFUL [INFO] ------------------------------------------------------------------------ [INFO] Total time: 8 seconds [INFO] Finished at: Tue Mar 20 14:37:05 CET 2007 [INFO] Final Memory: 15M/118M [INFO] ------------------------------------------------------------------------ ****************************************************************************

1 0

[continuum] BUILD FAILURE: Logback Examples Module
by John Noreplai 20 Mar '07

20 Mar '07

Online report : http://localhost:8090/continuum/servlet/continuum/target/ProjectBuild.vm/vi… Build statistics: State: Failed Previous State: Ok Started at: Tue, 20 Mar 2007 14:35:36 +0100 Finished at: Tue, 20 Mar 2007 14:35:45 +0100 Total time: 8s Build Trigger: Forced Exit code: 1 Building machine hostname: pixie Operating system : Linux(unknown) Java version : 1.5.0_08(Sun Microsystems Inc.) Changes seb Version is now 0.9.3 /logback/trunk/log4j-bridge/pom.xml /logback/trunk/logback-access/pom.xml /logback/trunk/logback-classic/pom.xml /logback/trunk/logback-core/pom.xml /logback/trunk/logback-examples/pom.xml /logback/trunk/logback-site/pom.xml /logback/trunk/pom.xml **************************************************************************** Output: **************************************************************************** [INFO] Scanning for projects... [INFO] ---------------------------------------------------------------------------- [INFO] Building Logback Examples Module [INFO] task-segment: [clean, install] [INFO] ---------------------------------------------------------------------------- [INFO] [clean:clean] [INFO] Deleting directory /opt/continuum-1.0.3/apps/continuum/working-directory/50/target [INFO] Deleting directory /opt/continuum-1.0.3/apps/continuum/working-directory/50/target/classes [INFO] Deleting directory /opt/continuum-1.0.3/apps/continuum/working-directory/50/target/test-classes [INFO] [resources:resources] [INFO] Using default encoding to copy filtered resources. Downloading: http://repo1.maven.org/maven2/ch/qos/logback/logback-core/0.9.3/logback-cor… [WARNING] Unable to get resource from repository central (http://repo1.maven.org/maven2) Downloading: http://repo1.maven.org/maven2/ch/qos/logback/logback-classic/0.9.3/logback-… [WARNING] Unable to get resource from repository central (http://repo1.maven.org/maven2) Downloading: http://repo1.maven.org/maven2/ch/qos/logback/logback-access/0.9.3/logback-a… [WARNING] Unable to get resource from repository central (http://repo1.maven.org/maven2) Downloading: http://repo1.maven.org/maven2/ch/qos/logback/logback-access/0.9.3/logback-a… [WARNING] Unable to get resource from repository central (http://repo1.maven.org/maven2) Downloading: http://repo1.maven.org/maven2/ch/qos/logback/logback-classic/0.9.3/logback-… [WARNING] Unable to get resource from repository central (http://repo1.maven.org/maven2) Downloading: http://repo1.maven.org/maven2/ch/qos/logback/logback-core/0.9.3/logback-cor… [WARNING] Unable to get resource from repository central (http://repo1.maven.org/maven2) [INFO] ------------------------------------------------------------------------ [ERROR] BUILD ERROR [INFO] ------------------------------------------------------------------------ [INFO] Failed to resolve artifact. Missing: ---------- 1) ch.qos.logback:logback-access:jar:0.9.3 Try downloading the file manually from the project website. Then, install it using the command: mvn install:install-file -DgroupId=ch.qos.logback -DartifactId=logback-access \ -Dversion=0.9.3 -Dpackaging=jar -Dfile=/path/to/file Path to dependency: 1) ch.qos.logback:logback-examples:jar:0.9.3 2) ch.qos.logback:logback-access:jar:0.9.3 2) ch.qos.logback:logback-classic:jar:0.9.3 Try downloading the file manually from the project website. Then, install it using the command: mvn install:install-file -DgroupId=ch.qos.logback -DartifactId=logback-classic \ -Dversion=0.9.3 -Dpackaging=jar -Dfile=/path/to/file Path to dependency: 1) ch.qos.logback:logback-examples:jar:0.9.3 2) ch.qos.logback:logback-classic:jar:0.9.3 3) ch.qos.logback:logback-core:jar:0.9.3 Try downloading the file manually from the project website. Then, install it using the command: mvn install:install-file -DgroupId=ch.qos.logback -DartifactId=logback-core \ -Dversion=0.9.3 -Dpackaging=jar -Dfile=/path/to/file Path to dependency: 1) ch.qos.logback:logback-examples:jar:0.9.3 2) ch.qos.logback:logback-core:jar:0.9.3 ---------- 3 required artifacts are missing. for artifact: ch.qos.logback:logback-examples:jar:0.9.3 from the specified remote repositories: central (http://repo1.maven.org/maven2) [INFO] ------------------------------------------------------------------------ [INFO] For more information, run Maven with the -e switch [INFO] ------------------------------------------------------------------------ [INFO] Total time: 6 seconds [INFO] Finished at: Tue Mar 20 14:35:44 CET 2007 [INFO] Final Memory: 10M/82M [INFO] ------------------------------------------------------------------------ ****************************************************************************

1 0

svn commit: r1446 - logback/tags/release-0.9.3
by noreply.seb＠qos.ch 20 Mar '07

20 Mar '07

Author: seb Date: Tue Mar 20 14:34:53 2007 New Revision: 1446 Added: logback/tags/release-0.9.3/ - copied from r1445, /logback/trunk/ Log: Tagging release 0.9.3

1 0

svn commit: r1445 - logback/trunk/logback-site/src/site/pages
by noreply.seb＠qos.ch 20 Mar '07

20 Mar '07

Author: seb Date: Tue Mar 20 14:26:46 2007 New Revision: 1445 Modified: logback/trunk/logback-site/src/site/pages/news.html Log: Updated news page 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 20 14:26:46 2007 @@ -28,7 +28,7 @@ <hr width="80%" align="center" /> - <h3>MMMM Dth, 2007 - Release of version 0.9.Y</h3> + <h3>March 20th, 2007 - Release of version 0.9.3</h3> <p>Includes in configuration files are now supported by Joran, logback's configuration framework. A file can contain an @@ -44,6 +44,18 @@ page</a> that shows the requirements of each of logback's modules. </p> + <p> + After a <a href="http://www.slf4j.org/pipermail/user/2007-March/000297.html"> + discussion on the SLF4J mailing list</a> started by Franck Routier, a correction has been + made when logging using the <em>JCL104-over-slf4j</em> + module. Logback now correctly shows the caller location information. + </p> + + <p> + As with most of the logback releases, the documentation has been improved + in many aspects. + </p> + <h3>March 5th, 2007 - Release of version 0.9.2</h3>

1 0

svn commit: r1444 - in logback/trunk: . log4j-bridge logback-access logback-classic logback-core logback-examples logback-site
by noreply.seb＠qos.ch 20 Mar '07

20 Mar '07

Author: seb Date: Tue Mar 20 14:26:29 2007 New Revision: 1444 Modified: logback/trunk/log4j-bridge/pom.xml logback/trunk/logback-access/pom.xml logback/trunk/logback-classic/pom.xml logback/trunk/logback-core/pom.xml logback/trunk/logback-examples/pom.xml logback/trunk/logback-site/pom.xml logback/trunk/pom.xml Log: Version is now 0.9.3 Modified: logback/trunk/log4j-bridge/pom.xml ============================================================================== --- logback/trunk/log4j-bridge/pom.xml (original) +++ logback/trunk/log4j-bridge/pom.xml Tue Mar 20 14:26:29 2007 @@ -5,14 +5,14 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>ch.qos.logback</groupId> <artifactId>log4j-bridge</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> <packaging>jar</packaging> <name>Log4j Bridge Module</name> Modified: logback/trunk/logback-access/pom.xml ============================================================================== --- logback/trunk/logback-access/pom.xml (original) +++ logback/trunk/logback-access/pom.xml Tue Mar 20 14:26:29 2007 @@ -3,14 +3,14 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>ch.qos.logback</groupId> <artifactId>logback-access</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> <packaging>jar</packaging> <name>Logback Access Module</name> Modified: logback/trunk/logback-classic/pom.xml ============================================================================== --- logback/trunk/logback-classic/pom.xml (original) +++ logback/trunk/logback-classic/pom.xml Tue Mar 20 14:26:29 2007 @@ -5,14 +5,14 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> <packaging>jar</packaging> <name>Logback Classic Module</name> Modified: logback/trunk/logback-core/pom.xml ============================================================================== --- logback/trunk/logback-core/pom.xml (original) +++ logback/trunk/logback-core/pom.xml Tue Mar 20 14:26:29 2007 @@ -5,14 +5,14 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>ch.qos.logback</groupId> <artifactId>logback-core</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> <packaging>jar</packaging> <name>Logback Core Module</name> Modified: logback/trunk/logback-examples/pom.xml ============================================================================== --- logback/trunk/logback-examples/pom.xml (original) +++ logback/trunk/logback-examples/pom.xml Tue Mar 20 14:26:29 2007 @@ -3,14 +3,14 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>ch.qos.logback</groupId> <artifactId>logback-examples</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> <packaging>jar</packaging> <name>Logback Examples Module</name> Modified: logback/trunk/logback-site/pom.xml ============================================================================== --- logback/trunk/logback-site/pom.xml (original) +++ logback/trunk/logback-site/pom.xml Tue Mar 20 14:26:29 2007 @@ -3,7 +3,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> </parent> <modelVersion>4.0.0</modelVersion> @@ -11,7 +11,7 @@ <groupId>ch.qos.logback</groupId> <artifactId>logback-site</artifactId> <packaging>jar</packaging> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> <name>Logback Site</name> <url>http://logback.qos.ch</url> Modified: logback/trunk/pom.xml ============================================================================== --- logback/trunk/pom.xml (original) +++ logback/trunk/pom.xml Tue Mar 20 14:26:29 2007 @@ -5,7 +5,7 @@ <groupId>ch.qos.logback</groupId> <artifactId>logback-parent</artifactId> - <version>0.9.3-SNAPSHOT</version> + <version>0.9.3</version> <packaging>pom</packaging> <name>Logback-Parent</name>

1 0

svn commit: r1443 - logback/trunk/logback-classic/src/test/java/ch/qos/logback/classic/joran
by noreply.seb＠qos.ch 20 Mar '07

20 Mar '07

Author: seb Date: Tue Mar 20 14:02:16 2007 New Revision: 1443 Modified: logback/trunk/logback-classic/src/test/java/ch/qos/logback/classic/joran/IncludeFileActionTest.java Log: removed unused import Modified: logback/trunk/logback-classic/src/test/java/ch/qos/logback/classic/joran/IncludeFileActionTest.java ============================================================================== --- logback/trunk/logback-classic/src/test/java/ch/qos/logback/classic/joran/IncludeFileActionTest.java (original) +++ logback/trunk/logback-classic/src/test/java/ch/qos/logback/classic/joran/IncludeFileActionTest.java Tue Mar 20 14:02:16 2007 @@ -10,7 +10,6 @@ import ch.qos.logback.core.ConsoleAppender; import ch.qos.logback.core.joran.spi.JoranException; import ch.qos.logback.core.status.Status; -import ch.qos.logback.core.util.StatusPrinter; public class IncludeFileActionTest extends TestCase {

1 0

svn commit: r1442 - in logback/trunk/logback-site/src/site/pages: . manual
by noreply.ceki＠qos.ch 19 Mar '07

19 Mar '07

Author: ceki Date: Mon Mar 19 22:16:49 2007 New Revision: 1442 Modified: 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/manual/layouts.html ============================================================================== --- logback/trunk/logback-site/src/site/pages/manual/layouts.html (original) +++ logback/trunk/logback-site/src/site/pages/manual/layouts.html Mon Mar 19 22:16:49 2007 @@ -1340,71 +1340,69 @@ behaviours, such as option handling. </p> -XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - <a name="ClassicHTMLLayout"></a> <h3>HTMLLayout</h3> <p><a href="../xref/ch/qos/logback/classic/html/HTMLLayout.html"> - <code>HTMLLayout</code></a> outputs events in an HTML table. Each - row of the table corresponds to a logging event.</p> + <code>HTMLLayout</code></a> outputs logging events in an HTML + table where each row of the table corresponds to a logging + event.</p> - <p>Here is a sample of the output produced by - <code>HTMLLayout</code> using its default CSS stylesheet:</p> + <p>Here is a sample output produced by <code>HTMLLayout</code> + using its default CSS stylesheet:</p> <img src="images/chapter5/htmlLayout1.gif" alt="HTML Layout Sample Image"/> - <p>The content of the table columns are specified using a - conversion pattern. See <code>PatternLayout</code> for - documentation on the available patterns. This ensures that the - user has full control over the creation of the html table. One can - choose to display any (or all) data that - <code>PatternLayout</code> can provide. + <p>The content of table columns are specified with the help of a + conversion pattern. See <a + href="#PatternLayout"><code>PatternLayout</code></a> for + documentation on conversion patterns. Thus, the user has full + control over the contents and format of the table. You can display + any one of the converters <code>PatternLayout</code> knows about. </p> - <p>One notable point about the use of <code>PatternLayout</code> with <code>HTMLLayout</code> - is that conversion specifiers should not be separated by a space or in general - any literals. Each specifier found in the - pattern will result in a separate column, meaning that each literal will create - an extra column.</p> - <p> - The pattern <em>%ex</em> - used to display an Exception is not the only way to display - an Exception with this layout. If you use this pattern, a - table column will be created to display the potential - Exception's stacktrace. That means that, in most cases, the column - will be empty, and will take quite a lot of space when displaying - an exception's stack trace. - </p> - <p> - Since printing a stack trace on a separate column is not very readable, - a better solution is available in the form of - implementations of the <code>IThrowableRenderer</code> interface. - These implementations can be called and assigned to - <code>HTMLLayout</code> to manage the display of anything related to - Exceptions. + <p>One notable point about the use of <code>PatternLayout</code> + with <code>HTMLLayout</code> is that conversion specifiers should + not be separated by a space or in general any literals. Each + specifier found in the pattern will result in a separate column, + in particular each literal in the pattern. + </p> + + <p>The pattern <em>%ex</em> used to display exceptions is not the + only way to display them. If you use the <em>%em</em> conversion + word, a table column will be created to display exception stack + traces. In most cases the column will be empty, wasting valuable + real-estate on your screen. </p> + <p> - By default, a + Moreover, printing a stack trace on a separate column does yield + very readable results. A better solution is available in the + form of implementations of the <code>IThrowableRenderer</code> + interface. Such an implementation can assigned to + <code>HTMLLayout</code> to manage the display data related to + exceptions. By default, a <a href="../xref/ch/qos/logback/classic/html/DefaultThrowableRenderer.html"> - <code>DefaultThrowableRenderer</code></a> is - assigned to the <code>HTMLLayout</code>. It writes the Exception on a <em>new - table row</em>, along with its stacktrace, in a easily readable - manner, like presented in the picture above. + <code>DefaultThrowableRenderer</code></a> is assigned to each + <code>HTMLLayout</code> isntance. It writes exceptions on a + <em>new table row</em>, along with its stacktrace, in an easily + readable manner, as shown on the figure above. </p> - <p> - If one wants to use the - <em>%ex</em> - pattern anyway, then a + + <p>If for some reason, you still wish to use the <em>%ex</em> + pattern, then you can specify <a href="../xref/ch/qos/logback/core/html/NOPThrowableRenderer.html"> - <code>NOPThrowableRenderer</code></a> can be specified - in the configuration file. + <code>NOPThrowableRenderer</code></a> in the configuration file + in order to disable displaying a separate row for the stack + trace. </p> - <p> - A user-specified external CSS file can be linked to the html - page. In that case, the following - xml element can be nested into the <code><layout></code> element. + + <p>A user-specified external CSS file can be set as the + style-sheet of the HTML output. For this purpose, a + <code>cssBuilder</code> xml element can be nested within a + <code><layout></code> element, as shown below. </p> + <div class="source"><pre><layout> ... <cssBuilder class="ch.qos.logback.core.html.UrlCssBuilder"> @@ -1413,18 +1411,13 @@ ... </layout></pre></div> - <p>In case one does not want to customize the html - output, an internal CSS style is used.</p> + <p>By default, an internal CSS style is used.</p> - <p> - The <code>HTMLLayout</code> is often, although not necessarily used in conjunction with - <code>SMTPAppender</code>, to send a nicely formatted html email. - </p> - <p> - When one wants to use the <code>HTMLLayout</code> with a - <code>SMTPAppender</code>, - the following configuration would be typical. + <p>The <code>HTMLLayout</code> is often used in conjunction with + <code>SMTPAppender</code>, in order to send an email pleasantly + formatted in HTML. Here is a typical configuration: </p> + <div class="source"><pre><configuration> <appender name="SMTP" class="ch.qos.logback.classic.net.SMTPAppender"> <layout class="ch.qos.logback.classic.html.HTMLLayout"> @@ -1442,9 +1435,10 @@ </root> </configuration></pre></div> - <p><code>HTMLLayout</code> can also be used with any <code>FileAppender</code>. In that - case, one can specify a rolling policy to archive log messages automatically. - One real world example could use the configuration below.</p> + <p><code>HTMLLayout</code> can also be used with any + <code>FileAppender</code>, including a a rolling file appender, as + shown in the sample configuration below. + </p> <div class="source"><pre><configuration> <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender"> @@ -1470,24 +1464,28 @@ <h2>Logback access</h2> - <p>Many access layouts are mere adaptations of classic layouts. Logback - classic and access modules address different needs, but offer comparable power - and flexibility.</p> + <p>Most logback-access layouts are mere adaptations of + logback-classic layouts. Logback-classic and logback-access + modules address different needs, but in general offer comparable + power and flexibility.</p> <h3>Writing your own Layout</h3> - <p>Writing a custom <code>Layout</code> for logback access is nearly identical - as to writing a <code>Layout</code> for the classic module.</p> + <p>Writing a custom <code>Layout</code> for logback access is + nearly identical as its sibling<code>Layout</code> in + logback-classic.</p> <a name="AccessPatternLayout"></a> + <h3>PatternLayout</h3> - <p>Access' <a href="../xref/ch/qos/logback/access/PatternLayout.html"> - <code>PatternLayout</code></a> work the exact same way as it's classic counterpart. + <p> <a href="../xref/ch/qos/logback/access/PatternLayout.html"> + <code>PatternLayout</code></a> in logback-access can be configured + in the same way as it's classic counterpart, with the notable + exception of the available conversion specifiers, as appropriate + for HTTP servlet request and response. </p> - <p>However, the conversion specifier are different, giving specific access to request - and response objects' attributes.</p> - - <p>Here are the conversion specifier one can use with logback access - <code>PatternLayout</code>.</p> + + <p>Below is a list of conversion specifiers for + <code>PatternLayout</code> in logback-access.</p> <table class="bodyTable" border="0" CELLPADDING="8"> <th align="center">Conversion Word</th> @@ -1745,11 +1743,23 @@ <p>Logback access' <code>PatternLayout</code> also recognize three keywords, which act like shortcuts to a certain pattern.</p> - <ul> - <p><em>common</em> or <em>CLF</em></p> - <p><em>combined</em></p> - </ul> - + <table class="bodyTable"> + <tr> + <th>keyword</th> + <th>equivalent conversion pattern</th> + </tr> + <tr class="a"> + <td><em>common</em> or <em>CLF</em></td> + <td><em>%h %l %u %t \"%r\" %s %b</em></td> + </tr> + <tr class="b"> + <td><em>combined</em></td> + <td><em>%h %l %u %t \"%r\" %s %b \"%i{Referer}\" \"%i{User-Agent}\"</em></td> + </tr> + + </table> + + <p>The <em>common</em> keyword corresponds to the pattern <em>%h %l %u %t \"%r\" %s %b</em> which displays client host, remote log name, user, date, requested URL, status code and response's content length</p> @@ -1777,18 +1787,24 @@ <p>Content Length</p> </ul> - <p>Here is what you can expect from a configured access <code>HTMLLayout</code>:</p> + <p>Here is a sample output produced by <code>HTMLLayout</code> in logback-access:</p> <img src="images/chapter5/htmlLayoutAccess.gif" alt="Access HTML Layout Sample Image"/> - <p>What's better than a real world example? Our own log4j properties to logback configuration - <a href="http://logback.qos.ch/translator/">translator</a> - is using logback access to showcase a live ouput, using a <code>RollingFileAppender</code> and - access' <code>HTMLLayout</code>.</p> - - <p>You can see the file by <a href="http://logback.qos.ch/translator/logs/access.html">following this link</a>.</p> + <p>What is better than a real world example? Our own log4j + properties to logback <a + href="http://logback.qos.ch/translator/">translator</a> makes use + of logback-access to showcase a live ouput, using a + <code>RollingFileAppender</code> and <code>HTMLLayout</code>.</p> + + <p>You can see the file by <a + href="http://logback.qos.ch/translator/logs/access.html">following + this link</a>.</p> + + <p>Just like any access log, each visit the <a + href="http://logback.qos.ch/translator/">translator</a> + web-application will add a new entry to the access logs. + </p> - <p>Just like any access log, it can be altered simply by visiting the - <a href="http://logback.qos.ch/translator/">translator</a> application.</p> <script src="../templates/footer.js"></script> </div> </body> 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 Mon Mar 19 22:16:49 2007 @@ -30,12 +30,12 @@ <h3>MMMM Dth, 2007 - Release of version 0.9.Y</h3> - <p> - Includes in configuration files are now supported by Joran, logback's - configuration framework. A file can contain an <em>include</em> element - that has a <em>file</em> or <em>url</em> attribute pointing to a configuration file. - See the <a href="manual/joran.html#Include">chapter about configuration</a> in the logback's - online manual for more information. + <p>Includes in configuration files are now supported by Joran, + logback's configuration framework. A file can contain an + <em>include</em> element that has a <em>file</em> or <em>url</em> + attribute pointing to a configuration file. See the <a + href="manual/joran.html#Include">chapter about configuration</a> + in the logback's online manual for more information. </p> <p>

1 0