Siphalor/tweed5-commons-logging
1
0
Fork 0
Code Activity

Update release notes for all the changes (so far) to be included in a

Browse Source 
commons-logging 1.0.4 release.  Tweak documentation to reflect the
availability of two new Log implementations (Avalon Framework and
LumberJack).


git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/logging/trunk@139013 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Craig R. McClanahan
2004-02-28 23:20:57 +00:00
parent 37c89a6d88
commit af56b24b58
6 changed files with 76 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
PROPOSAL.html
View File

@@ -72,7 +72,17 @@ Non-goals:
<ul> <ul>
<li>Java Development Kit (Version 1.1 or later) <li>Java Development Kit (Version 1.1 or later)
</li> </li>
<li>log4j (compile-time dependency only) </li> <li>Avalon Framework (compile-time dependency only unless this Log
implementation is selected at runtime)
<li>Avalon LogKit (compile-time dependency only unless this Log
implementation is selected at runtime)
<li>JDK 1.4 (compile-time dependency only unless this log implementation
is selected at runtime).
<li>Log4J (compile-time dependency only unless this Log
implementation is selected at runtime)</li>
<li><a href="http://sourceforge.net/projects/lumberjack/">Lumberjack</a>
(compile-time dependency only unless this Log
implementation is selected at runtime)</li>
</ul> </ul>
<h3>(2) Required Jakarta-Commons Resources</h3> <h3>(2) Required Jakarta-Commons Resources</h3>

81
RELEASE-NOTES.txt
View File

@@ -16,10 +16,10 @@
--> -->
$Id: RELEASE-NOTES.txt,v 1.3 2004/02/28 22:10:53 craigmcc Exp $ $Id: RELEASE-NOTES.txt,v 1.4 2004/02/28 23:20:57 craigmcc Exp $
Commons Logging Package Commons Logging Package
Version 1.0.3 Version 1.0.4
Release Notes Release Notes
@@ -28,72 +28,67 @@ INTRODUCTION:
This document contains the release notes for this version of the Commons This document contains the release notes for this version of the Commons
Logging package. It is primarily a maintenance and code cleanup release, Logging package. It is primarily a maintenance and code cleanup release,
with minimal new features. with some new features.
The following paragraphs document changes since the previous release The following paragraphs document changes since the previous release
(version 1.0.2). (version 1.0.3).
NEW FEATURES: NEW FEATURES:
============ ============
[build.xml] Refined build process to correctly avoid compiling classes [ALL FILES] This version of Commons Logging is released under the
when dependencies are not available, and to avoid name Apache License (Version 2.0). All source files have been
clashes over Ant properties used in different ways. modified to reflect this.
[unit tests] Added new suites of tests for the Log4J and JDK 1.4 [maven.xml] Added beginnings of a Maven-based build, primarily for the
logging implementations, including tests with multiple purpose of creating documentation consistent with Mavenized
class loaders that closely simulate the scenario of using commons projects. The official build system for the software
commons-logging in a servlet container. is still the Ant "build.xml" file.
[documentation] Overall cleanup and correction of the JavaDoc documentation [AvalonLogger] Added AvalonLogger, which wraps the logger used by the
to correctly reflect the current behavior. In particular, Avalon framework. As with other implementations, this
the default logging implementation (selected if nothing is compiled only if the appropriate dependencies are
else is configured) is now SimpleLog, not NoOpLog. satisfied.
[Jdk13LumberjackLogger]
Added Jdk13LumberjackLogger, which wraps the implementation
of the JSR-47 logging APIs (for JDKs before 1.4) provided
by the SourceForge "lumberjack" project.
<http://sourceforge.net/projects/lumberjack/>
[LogFactory] Add a static release(ClassLoader) method that allows,
for example, a webapp to clean up all c-l references
prior to being shut down.
BUG FIXES: BUG FIXES:
========= =========
[build.xml] Correct the META-INF/MANIFEST.MF that was embedded in the [MANIFEST.MF] Remove reference to Log4J from the manifest classpath.
generated JAR files to properly contain the version number.
[LogFactory] Fix security violations on several ClassLoader method [LogConfigurationException]
invocations. Include root cause in the text of the message, if present.
[SimpleLog] Dump stack trace through logger, instead of directly to [LogFactory] Improve usability of error messages reporting
System.out, to preserve output sequence. configuration problems.
[SimpleLog] Avoid a security exception if system properties cannot be [JDK14Logger] Implement Serializable, remove "final" declaration for
read (such as in an applet). easy subclassing.
[Bugzilla 10825] NullPointerException when Logger.getClassLoader() [Log4JLogger] Implement Serializable, remove "final" declaration for
returns null. easy subclassing.
[Bugzilla 13118] Correct detection of JDK 1.4 that was mis-identifying on a [NoOpLogger] Implement Serializable, remove "final" declaration for
scenario where a JDK 1.3 implementation included an easy subclassing.
implementation of JSR-47 logging.
[Bugzilla 13157] Incorrect selection of Log4J in a servlet container. [SimpleLog] Make SimpleLog more friendly to the security manager
in an applet environment, by swallowing any security
[Bugzilla 13201] Log4JLogger should not attempt to auto-configure exceptions when looking up system properties that are
appenders; this is out of scope for commons-logging. not accessible.
[Bugzilla 17561] Attempts to override Log4J configuration.
[Bugzilla 17894] Unable to configure commons-logging SimpleLog for a webapp.
[Bugzilla 18184] Jdk14Logger should not waste the effort to create a
Throwable (to extract calling class and method) if the
message is not going to be logged anyway.
DEPRECATIONS: DEPRECATIONS:
============ ============
(These are carried forward from Version 1.0.3)
[LogSource] Previously deprecated, replaced by LogFactory. [LogSource] Previously deprecated, replaced by LogFactory.
[Log4jFactory] A proxy instance of this class was transparently created [Log4jFactory] A proxy instance of this class was transparently created

7
STATUS.html
View File

@@ -25,7 +25,7 @@
<div align="center"> <div align="center">
<h1>The Jakarta Commons <em>Logging</em> Component</h1> <h1>The Jakarta Commons <em>Logging</em> Component</h1>
$Id: STATUS.html,v 1.15 2004/02/28 22:10:53 craigmcc Exp $<br /> $Id: STATUS.html,v 1.16 2004/02/28 23:20:57 craigmcc Exp $<br />
<a href="#Introduction">[Introduction]</a> <a href="#Introduction">[Introduction]</a>
<a href="#Dependencies">[Dependencies]</a> <a href="#Dependencies">[Dependencies]</a>
<a href="#Release Info">[Release Info]</a> <a href="#Release Info">[Release Info]</a>
@@ -58,8 +58,10 @@ The package does :
<li>Have an API which should be as simple to use as possible</li> <li>Have an API which should be as simple to use as possible</li>
<li>Provide support for Avalon's Logkit</li> <li>Provide support for Avalon's Logkit</li>
<li>Provide support for JDK 1.4 logging</li> <li>Provide support for JDK 1.4 logging</li>
<li>Provide support for log4j</li> <li>Provide support for Log4J</li>
<li>Provide support for Avalon-Framework's Logger</li> <li>Provide support for Avalon-Framework's Logger</li>
<li>Provide support for <a href="http://sourceforge.net/projects/lumberjack/>
LumberJack</a> logger</li>
<li>Provide pluggable support for other logging APIs</li> <li>Provide pluggable support for other logging APIs</li>
<li>Privide a simple System.out logger</li> <li>Privide a simple System.out logger</li>
</ul> </ul>
@@ -89,6 +91,7 @@ components for compilation:</p>
LogKit</a> (Optional, Version 1.0.1 or later)</li> LogKit</a> (Optional, Version 1.0.1 or later)</li>
<li><a href="http://avalon.apache.org/">Apache Avalon <li><a href="http://avalon.apache.org/">Apache Avalon
Framework</a> (Optional, Version 4.0 or later)</li> Framework</a> (Optional, Version 4.0 or later)</li>
<li><a href="http://projects.sourceforge.net/lumberjack/">LumberJack</a></li>
<li><a href="http://java.sun.com/j2se">Java Development Kit</a> (Version 1.4 <li><a href="http://java.sun.com/j2se">Java Development Kit</a> (Version 1.4
or later) logging APIs (Optional)</li> or later) logging APIs (Optional)</li>
</ul> </ul>

5
usersguide.html
View File

@@ -67,8 +67,9 @@ a specific logging implementation.
other logging tools, including other logging tools, including
<a href="http://jakarta.apache.org/log4j/docs/index.html">Log4J</a>, <a href="http://jakarta.apache.org/log4j/docs/index.html">Log4J</a>,
<a href="http://jakarta.apache.org/avalon/logkit/index.html">Avalon LogKit</a>, <a href="http://jakarta.apache.org/avalon/logkit/index.html">Avalon LogKit</a>,
and the Avalon Framework's logging infrastructure,
<a>JDK 1.4</a>. JDK 1.4, and an implementation of JDK 1.4 logging APIs (JSR-47) for pre-1.4
systems.
The interface maps closely to Log4J and LogKit. The interface maps closely to Log4J and LogKit.
</p> </p>

14
xdocs/guide.xml
View File

@@ -40,15 +40,15 @@ a specific logging implementation.
Familiarity with high-level details of various Logging implementations is presumed. Familiarity with high-level details of various Logging implementations is presumed.
</p> </p>
<p> <p>The Jakarta Commons Logging provides a Log interface with thin-wrapper implementations for
The Jakarta Commons Logging provides a Log interface with thin-wrapper implementations for
other logging tools, including other logging tools, including
<a href="http://logging.apache.org/log4j/docs/index.html">Log4J</a>, <a href="http://jakarta.apache.org/log4j/docs/index.html">Log4J</a>,
<a href="http://avalon.apache.org/logkit/index.html">Avalon LogKit</a>, <a href="http://jakarta.apache.org/avalon/logkit/index.html">Avalon LogKit</a>,
and the Avalon Framework's logging infrastructure,
<a>JDK 1.4</a>. JDK 1.4, and an implementation of JDK 1.4 logging APIs (JSR-47) for pre-1.4
systems.
The interface maps closely to Log4J and LogKit. The interface maps closely to Log4J and LogKit.
</p> </p>
</section> </section>
<section name="Users Quick Start"> <section name="Users Quick Start">

15
xdocs/proposal.xml
View File

@@ -73,9 +73,18 @@ Non-goals:
</p> </p>
<ul> <ul>
<li>Java Development Kit (Version 1.1 or later) <li>Java Development Kit (Version 1.1 or later)</li>
</li> <li>Avalon Framework (compile-time dependency only unless this Log
<li>log4j (compile-time dependency only) </li> implementation is selected at runtime)
<li>Avalon LogKit (compile-time dependency only unless this Log
implementation is selected at runtime)
<li>JDK 1.4 (compile-time dependency only unless this log implementation
is selected at runtime).
<li>Log4J (compile-time dependency only unless this Log
implementation is selected at runtime)</li>
<li><a href="http://sourceforge.net/projects/lumberjack/">Lumberjack</a>
(compile-time dependency only unless this Log
implementation is selected at runtime)</li>
</ul> </ul>
</subsection> </subsection>