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>