diff --git a/xdocs/index.xml b/xdocs/index.xml index 2c5959e..bdb9967 100644 --- a/xdocs/index.xml +++ b/xdocs/index.xml @@ -29,15 +29,25 @@
-

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.

+

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.

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.

+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.

+ +

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.

@@ -54,6 +64,9 @@ In particular, you should read the package overview of the org.apache.comm package. In addition, there is a (short) User Guide.

+

The Wiki site has +the latest updates, an FAQ and much other useful information.

+

Users needing to become experts or wanting to help develop JCL should (in addition) consult the Tech Guide. @@ -63,14 +76,24 @@ This gives short introductions to topics such as advanced class loading.

+ +

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.

+

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).

+

For the full details, see the release notes for this version.

+
-

- Note: the 1.0.5 release was abandoned at alpha status. -

-

+

+ Note: the 1.0.5 release was abandoned at alpha status. +

+

The next JCL release will be designated 1.1 since we feel this more - accurately reflects the improvements made to the codebase. -

+ accurately reflects the improvements made to the codebase.