c7d566cf10
Other minor updates. git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/logging/trunk@371221 13f79535-47bb-0310-9956-ffa450edef68
137 lines
5.1 KiB
XML
137 lines
5.1 KiB
XML
<?xml version="1.0"?>
|
|
|
|
<!--
|
|
|
|
Copyright 2001-2004 The Apache Software Foundation.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
|
|
-->
|
|
|
|
<document>
|
|
|
|
<properties>
|
|
<title>Commons</title>
|
|
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
|
</properties>
|
|
|
|
<body>
|
|
|
|
<section name="The Logging Component">
|
|
|
|
<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
|
|
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>
|
|
|
|
</section>
|
|
|
|
|
|
<section name="Documentation">
|
|
|
|
<p>The <a href="http://jakarta.apache.org/commons/logging/RELEASE-NOTES.txt">
|
|
Release Notes</a> document the new features and bug fixes that have been
|
|
included in the latest release.</p>
|
|
|
|
<p>The <a href="http://jakarta.apache.org/commons/logging/apidocs/index.html">
|
|
JavaDoc API documents</a> for the latest release are available online.
|
|
In particular, you should read the package overview of the <code>org.apache.commons.logging</code>
|
|
package. In addition, there is a (short)
|
|
<a href="guide.html">User Guide</a>.</p>
|
|
|
|
<p>The <a href="http://wiki.apache.org/jakarta-commons/Logging">Wiki site</a> has
|
|
the latest updates, an FAQ and much other useful information.</p>
|
|
|
|
<p>
|
|
Users needing to become experts or wanting to help develop JCL should
|
|
(in addition) consult the <a href='tech.html'>Tech Guide</a>.
|
|
This gives short introductions to topics such as advanced class loading.
|
|
</p>
|
|
</section>
|
|
|
|
|
|
<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>
|
|
The next JCL release will be designated 1.1 since we feel this more
|
|
accurately reflects the improvements made to the codebase.</p>
|
|
</subsection>
|
|
<subsection name='1.0.4 Release'>
|
|
<p>
|
|
The 1.0.4 release of commons-logging is a service
|
|
release containing support for both the 1.2.x and 1.3.x series of Log4J releases.
|
|
</p>
|
|
</subsection>
|
|
<subsection name='Mirrored Releases'>
|
|
<p>
|
|
Releases after 1.0.2 should be downloaded from a mirror. Please remember to verify the
|
|
signature of the release from the
|
|
<a href='http://www.apache.org/dist/jakarta/commons/logging/'>main apache site</a>
|
|
when downloading from a mirror.
|
|
</p>
|
|
<p>
|
|
Binary and source releases are available
|
|
<a href="http://jakarta.apache.org/site/downloads/downloads_commons-logging.cgi">here</a>.
|
|
</p>
|
|
<p>
|
|
<ul>
|
|
<li>Version 1.0.4 (latest) - 16 Jun 2004</li>
|
|
<li>Version 1.0.3 - 7 Apr 2003</li>
|
|
</ul>
|
|
</p>
|
|
</subsection>
|
|
<subsection name='Older Releases (Not Mirrored)'>
|
|
<p>
|
|
<ul>
|
|
<ul>
|
|
<li><a href="http://archive.apache.org/dist/jakarta/commons/logging/binaries/">Binary releases</a></li>
|
|
<li><a href="http://archive.apache.org/dist/jakarta/commons/logging/source/">Source releases</a></li>
|
|
</ul>
|
|
</ul>
|
|
</p>
|
|
</subsection>
|
|
</section>
|
|
|
|
|
|
</body>
|
|
</document>
|