[logback-dev] svn commit: r2173 - logback/trunk/logback-site/src/site/pages/manual

[noreply.ceki at qos.ch]

Author: ceki
Date: Fri Feb 27 15:15:20 2009
New Revision: 2173

Modified:
   logback/trunk/logback-site/src/site/pages/manual/layouts.html

Log:
Clarification on the %c conversion word, in particular the abbreviation algorithm.

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	Fri Feb 27 15:15:20 2009
@@ -400,10 +400,11 @@
 					<p>This conversion word can take an integer as its first and
 					only option. The converter's abbreviation algorithm will
 					shorten the logger name, usually without significant loss of
-					meaning. Setting the value of this option to zero will cause
-					the conversoin specifier to return the string right to the
-					rightmost dot character. The next table provides examples of
-					the abbreviation algorithm in action.
+					meaning. Setting the value of this option to zero has
+					special meaning. It will cause the conversoin specifier to
+					return the string right to the rightmost dot character. The
+					next table provides examples of the abbreviation algorithm
+					in action.
           </p>
 
 					<table class="bodyTable dark" border="0" cellpadding="8">
@@ -425,6 +426,12 @@
 						</tr>
 
 						<tr>
+							<td>%logger{5}</td>
+							<td>mainPackage.sub.sample.Bar</td>
+							<td>m.s.s.Bar</td>
+						</tr>
+
+						<tr>
 							<td>%logger{10}</td>
 							<td>mainPackage.sub.sample.Bar</td>
 							<td>m.s.s.Bar</td>
@@ -448,6 +455,12 @@
 							<td>mainPackage.sub.sample.Bar</td>
 						</tr>
 					</table>
+
+          <p>Please note that the right most segment in a logger name
+          is never abbreviated, even if its length is longer than the
+          <em>length</em> option. Other segments may be shortened to
+          at most a single character but are never removed.</p>
+
 				</td>
 			</tr>