Author: ceki Date: Tue Jul 5 13:15:54 2005 New Revision: 113 Added: nlog4j/trunk/docs/changes.html Log:
File generated by src/xdocs/changes.xml Added: nlog4j/trunk/docs/changes.html ============================================================================== --- (empty file) +++ nlog4j/trunk/docs/changes.html Tue Jul 5 13:15:54 2005 @@ -0,0 +1,178 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> + +<!-- Content Stylesheet for Site --> + + + + + +<!-- start the processing --> + <!-- ====================================================================== --> + <!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! --> + <!-- Main Page Section --> + <!-- ====================================================================== --> + <html> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> + + <meta name="author" value="Ceki Gulcu"> + <meta name="email" value="[EMAIL PROTECTED]"> + + + + + <link href="./css/site.css" rel="stylesheet" type="text/css"/> + + + <title>NLOG4j - Changes in NLOG4J</title> + </head> + + <body bgcolor="#ffffff" text="#000000" link="#525D76"> + <!-- START Header table --> + <table class="banner" border="0"> + <tr> + <td valign="top"> + <a href="http://www.slf4j.org/";> + <img src="images/slf4j-logo.jpg" border="0"/> + </a> + </td> + <td align="right"> + <a href="http://www.slf4j.org/nlog4j/";> + <img src="./images/nlog4j-logo.jpg" alt="NLOG4J project" border="0"/> + </a> + </td> + </tr> + </table> + <!-- END Header table --> + + <div class="centercol"> + <hr noshade="" size="1"/> + + <h1>Differences between NLOG4J and log4j</strong></h1> + <p>NLOG4J is a production-quality log4j-replacement with direct + SLF4J API support. NLOG4J is maintained by Ceki G�lc�, the + founder of the log4j project. In a nutshell, unless you invoke + logger methods using messages of arbitrary type instead of just + <code>String</code>, NLOG4J can be considered as a drop-in + replacement for log4j version 1.2.9. + </p> + <h2><code>String</code> instead of <code>Object</code></h2> + <p>The <code>org.slf4j.Logger</code> interface restricts the + type of messages that can be logged to + <code>java.lang.String</code> instead of + <code>java.lang.Object</code>. + </p> + <p>Thus, while in log4j you can write</p> + <p class="source">logger.debug(new Interger(10)); </p> + <p>in NLOG4J the previous line will not compile and needs to be + re-rewitten as:</p> + <p class="source">logger.debug((new Interger(10)).toString());</p> + <p>or alternatively, as:</p> + <p class="source">logger.debug("{}", new Interger(10)); // recommended and more efficient form</p> + <p>We recommend the second form because it avoids the + <code>toString()</code> invocation on the Interger object in + case the log statement is disabled for the DEBUG level. See the + <a href="http://www.slf4j.org/faq.html#2.3";>Question 2.3</a> in SLF4J FAQ for more details.</p> + <h2>LF5, chainsaw and <code>NTEventAppender</code></h2> + <p>In order to save space, it was decided <em>not</em> to + bundle LF5, chainsaw and <code>NTEventAppender</code> with + NLOG4J. + </p> + <h1>Changes in NLOG4J 1.2.14</strong></h1> + <p>Nick Faiz from the Apache Directory project reported + compatibility issues with NLOG4J when used in conjunction with + Jakarta Commons Logging. + </p> + <p>As mentioned above, while printing methods in log4j take an + argument of type <code>java.lang.Object</code>, the + <code>org.slf4j.Logger</code> interface imposes that this + parameter be of type <code>java.lang.String</code>. NLOG4J + Logger's which directly implement the + <code>org.slf4j.Logger</code> interface relays this restriction. + </p> + <p>Luckily, JCL uses a special printing method which lies beyond + those in the <code>org.slf4j.Logger</code> interface. NLOG4J + release 1.2.14 modifies this special printing method so to retain + compatibility with JCL while still adhering to the SLF4J Logger + interface. + </p> + <h1>Changes in NLOG4J 1.2.13</strong></h1> + <p>Following discussions on the SLF4J developers list, the + signatures of the printing methods in + <code>org.slf4j.Logger</code> interface have been modified to + admit messages of type <code>String</code> instead of type + <code>Object</code> as previously. + </p> + <p>NLOG4J release 1.2.13 reflects changes in the SLF4J API. + </p> + <h1>Changes in NLOG4J 1.2.12</strong></h1> + <p>Release 1.2.12 reflects changes in the SLF4J API, in + particular renaming of <code>org.slf4j.ULogger</code> interface + as <code>org.slf4j.Logger</code>. + </p> + <h1>Changes NLOG4J 1.2.11</strong></h1> + <p> NLOG4J project is based on log4j 1.2.9. It is differs from + log4j 1.2.9 in its native support for the SLF4J API. Due to + space considerations, NLOG4J does <em>not</em> bundle LF5, + chainsaw nor <code>NTEventLogAppender</code>. + </p> + <p>NLOG4J should be considered as a production quality drop-in + replacement for log4j version 1.2.9. NLOG4J is maintained by + Ceki G�lc�, the founder of the log4j project. + </p> + + + + <hr/> + + + + + + <!-- FOOTER --> + <div align="center"><font color="#525D76" size="-1"><em> + Copyright © 2005, slf4j.org + </em></font></div> + + <!-- END main table --> + + <!-- LEFT SIDE NAVIGATION --> + <!-- ============================================================ --> + <div class="leftcol"> + <div class="menu_header">NLOG4J Project</div> + <div class="menu_item"> <a href="./index.html">Introduction</a> + </div> + <div class="menu_item"> <a href="./download.html">Download</a> + </div> + <div class="menu_item"> <a href="./documentation.html">Documentation</a> + </div> + <div class="menu_header">Parent Project</div> + <div class="menu_item"> <a href="http://www.slf4j.org";>SLF4J</a> + </div> + </div> + + + </body> + </html> +<!-- end the processing --> + + + + + + + + + + + + + + + + + + + + + _______________________________________________ nlog4j-dev mailing list [EMAIL PROTECTED] http://slf4j.org/mailman/listinfo/nlog4j-dev
