commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r371221 - /jakarta/commons/proper/logging/trunk/xdocs/index.xml
Date Sun, 22 Jan 2006 06:56:49 GMT
Author: skitching
Date: Sat Jan 21 22:56:46 2006
New Revision: 371221

Add section for 1.1 release.
Other minor updates.


Modified: jakarta/commons/proper/logging/trunk/xdocs/index.xml
--- jakarta/commons/proper/logging/trunk/xdocs/index.xml (original)
+++ jakarta/commons/proper/logging/trunk/xdocs/index.xml Sat Jan 21 22:56:46 2006
@@ -29,15 +29,25 @@
 <section name="The Logging Component">
-<p>There is a great need for debugging and logging information inside of
-Commons components such as HTTPClient and DBCP.  However, there are many
-logging APIs out there and it is difficult to choose among them.</p>
+<p>When writing a library it is very useful to log information. However there
+are many logging implementations out there, and a library cannot impose the use
+of a particular one on the overall application that the library is a part of.</p>
 <p>The Logging package is an ultra-thin bridge between different logging
-libraries.  Commons components may use the Logging API to remove
-compile-time and run-time dependencies on any particular logging package,
-and contributors may write Log implementations for the library of
-their choice.</p>
+implementations.  A library that uses the commons-logging API can be used with
+any logging implementation at runtime. Commons-logging comes with support for a
+number of popular logging implementations, and writing adapters for others is a
+reasonably simple task.</p>
+<p>Applications (rather than libraries) may also choose to use commons-logging.
+While logging-implementation independence is not as important for applications
+as it is for libraries, using commons-logging does allow the application to
+change to a different logging implementation without recompiling code. Note
+that commons-logging does not attempt to initialise or terminate the underlying
+logging implementation that is used at runtime; that is the responsibility of
+the application. However many popular logging implementations do automatically
+initialise themselves; in this case an application may be able to avoid
+containing any code that is specific to the logging implementation used.</p>
@@ -54,6 +64,9 @@
 package. In addition, there is a (short)
 <a href="guide.html">User Guide</a>.</p>
+<p>The <a href="">Wiki site</a>
+the latest updates, an FAQ and much other useful information.</p>
 Users needing to become experts or wanting to help develop JCL should
 (in addition) consult the <a href='tech.html'>Tech Guide</a>.
@@ -63,14 +76,24 @@
 <section name="Releases">
+    <subsection name='1.1 Release'>
+      <p>This release makes several changes that are intended to resolve issues that
+      have been encountered when using commons-logging in servlet containers or j2ee
+      containers where complex classpaths are present and multiple copies of
+      commons-logging libraries are present at different levels.</p>
+      <p>This release also adds support for the TRACE level added to log4j in the
+      1.2.12 release. In former commons-logging versions, the log.trace method
+      caused log4j to output the message at the DEBUG level (the lowest level
+      supported by log4j at that time).</p>
+      <p>For the full details, see the release notes for this version.</p> 
+    </subsection>
     <subsection name='1.0.5 Release (Alpha)'>
-    		<p>
-    <strong>Note:</strong> the 1.0.5 release was abandoned at alpha status.
-    		</p>
-    		<p>
+      <p>
+        <strong>Note:</strong> the 1.0.5 release was abandoned at alpha status.
+      </p>
+      <p>
     The next JCL release will be designated 1.1 since we feel this more 
-    accurately reflects the improvements made to the codebase.
-    		</p>
+    accurately reflects the improvements made to the codebase.</p>
     <subsection name='1.0.4 Release'>

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message