[logback-dev] svn commit: r1131 - in logback/trunk: log4j-bridge/compatibility logback-site/src/site/xdocTemplates/manual

noreply.seb at qos.ch noreply.seb at qos.ch
Tue Dec 19 20:17:24 CET 2006

Author: seb
Date: Tue Dec 19 20:17:24 2006
New Revision: 1131


on going work on chapter 3
minor fix on build.xml

Modified: logback/trunk/log4j-bridge/compatibility/build.xml
--- logback/trunk/log4j-bridge/compatibility/build.xml	(original)
+++ logback/trunk/log4j-bridge/compatibility/build.xml	Tue Dec 19 20:17:24 2006
@@ -80,7 +80,7 @@
 		<javac srcdir="${source.home}" 
-			      deprecation="${deprecation}" debug="on">
+			     deprecation="${deprecation}" debug="on">
 			<classpath refid="log4j12.classpath" />

Modified: logback/trunk/logback-site/src/site/xdocTemplates/manual/joran.xml
--- logback/trunk/logback-site/src/site/xdocTemplates/manual/joran.xml	(original)
+++ logback/trunk/logback-site/src/site/xdocTemplates/manual/joran.xml	Tue Dec 19 20:17:24 2006
@@ -739,6 +739,33 @@
 <h4>Configuring Loggers</h4>
+Loggers are configured using <em>logger</em> elements. A <em>logger</em> element takes exactly
+one mandatory name atttribute and an optional additivity attribute, which takes values
+<em>true</em> or <em>false</em>. The <em>logger</em> element admits at most one <em>level</em>
+element which is discussed next. It may also contain zero or more <em>appender-ref</em> elements;
+each appender thus referenced is added to the named logger. It is important to keep mind that 
+each named logger that is declared with a <em>logger</em> element first has all its 
+appenders removed and only then are the referenced appenders attached to it. 
+In particular, if there are no appender references, then the named logger will 
+lose all its appenders. 
+The <em>level</em> element is used to set logger levels. It admits two attributes 
+<em>value</em> and <em>class</em>. The value attribute can be one of the strings <em>DEBUG</em>, 
+<em>INFO</em>, <em>WARN</em> <em>ERROR</em>, <em>ALL</em> or <em>OFF</em>.  
+The special case-insensitive value <em>INHERITED</em>, or its synonym <em>NULL</em>, 
+will force the level of the logger to be inherited from higher up in the hierarchy. 
+Note that the level of the root logger cannot be inherited. 
+If you set the level of a logger and later decide that it should inherit 
+its level, then you need to specify <em>INHERITED</em> or its synonym <em>NULL</em> 
+as the level value. The class attribute allows you to specify a custom 
+level where the value of the attribute is the fully qualified name of a 
+custom level class. You may alternatively use the <em>level#classname</em> syntax within 
+the value attribute. The <em>level</em> element has no children.
 Setting the level of a logger is as simple as declaring it and setting 
 its level, as the next example illustrates. Suppose we are no longer interested 
 in seeing any <code>DEBUG</code> level logs from any component 
@@ -877,7 +904,7 @@
   <b>%lt;logger name="chapter3">
     %lt;level value="INFO" />
-  %lt;/logger>
+  %lt;/logger></b>
     <b>%lt;level value="OFF" /></b>
@@ -941,6 +968,18 @@
 <h4>Configuring Appenders + multiple + additivity</h4>
 <h4>Variable substitution</h4>

More information about the logback-dev mailing list