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>
<li>Java Development Kit (Version 1.1 or later)
</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>
<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
Version 1.0.3
Version 1.0.4
Release Notes
@@ -28,72 +28,67 @@ INTRODUCTION:
This document contains the release notes for this version of the Commons
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
(version 1.0.2).
(version 1.0.3).
NEW FEATURES:
============
[build.xml] Refined build process to correctly avoid compiling classes
when dependencies are not available, and to avoid name
clashes over Ant properties used in different ways.
[ALL FILES] This version of Commons Logging is released under the
Apache License (Version 2.0). All source files have been
modified to reflect this.
[unit tests] Added new suites of tests for the Log4J and JDK 1.4
logging implementations, including tests with multiple
class loaders that closely simulate the scenario of using
commons-logging in a servlet container.
[maven.xml] Added beginnings of a Maven-based build, primarily for the
purpose of creating documentation consistent with Mavenized
commons projects. The official build system for the software
is still the Ant "build.xml" file.
[documentation] Overall cleanup and correction of the JavaDoc documentation
to correctly reflect the current behavior. In particular,
the default logging implementation (selected if nothing
else is configured) is now SimpleLog, not NoOpLog.
[AvalonLogger] Added AvalonLogger, which wraps the logger used by the
Avalon framework. As with other implementations, this
is compiled only if the appropriate dependencies are
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:
=========
[build.xml] Correct the META-INF/MANIFEST.MF that was embedded in the
generated JAR files to properly contain the version number.
[MANIFEST.MF] Remove reference to Log4J from the manifest classpath.
[LogFactory] Fix security violations on several ClassLoader method
invocations.
[LogConfigurationException]
Include root cause in the text of the message, if present.
[SimpleLog] Dump stack trace through logger, instead of directly to
System.out, to preserve output sequence.
[LogFactory] Improve usability of error messages reporting
configuration problems.
[SimpleLog] Avoid a security exception if system properties cannot be
read (such as in an applet).
[JDK14Logger] Implement Serializable, remove "final" declaration for
easy subclassing.
[Bugzilla 10825] NullPointerException when Logger.getClassLoader()
returns null.
[Log4JLogger] Implement Serializable, remove "final" declaration for
easy subclassing.
[Bugzilla 13118] Correct detection of JDK 1.4 that was mis-identifying on a
scenario where a JDK 1.3 implementation included an
implementation of JSR-47 logging.
[NoOpLogger] Implement Serializable, remove "final" declaration for
easy subclassing.
[Bugzilla 13157] Incorrect selection of Log4J in a servlet container.
[Bugzilla 13201] Log4JLogger should not attempt to auto-configure
appenders; this is out of scope for commons-logging.
[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.
[SimpleLog] Make SimpleLog more friendly to the security manager
in an applet environment, by swallowing any security
exceptions when looking up system properties that are
not accessible.
DEPRECATIONS:
============
(These are carried forward from Version 1.0.3)
[LogSource] Previously deprecated, replaced by LogFactory.
[Log4jFactory] A proxy instance of this class was transparently created

7
STATUS.html
View File

@@ -25,7 +25,7 @@
<div align="center">
<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="#Dependencies">[Dependencies]</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>Provide support for Avalon's Logkit</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 <a href="http://sourceforge.net/projects/lumberjack/>
LumberJack</a> logger</li>
<li>Provide pluggable support for other logging APIs</li>
<li>Privide a simple System.out logger</li>
</ul>
@@ -89,6 +91,7 @@ components for compilation:</p>
LogKit</a> (Optional, Version 1.0.1 or later)</li>
<li><a href="http://avalon.apache.org/">Apache Avalon
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
or later) logging APIs (Optional)</li>
</ul>

5
usersguide.html
View File

@@ -67,8 +67,9 @@ a specific logging implementation.
other logging tools, including
<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>,
and
<a>JDK 1.4</a>.
the Avalon Framework's logging infrastructure,
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.
</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.
</p>
<p>
The Jakarta Commons Logging provides a Log interface with thin-wrapper implementations for
<p>The Jakarta Commons Logging provides a Log interface with thin-wrapper implementations for
other logging tools, including
<a href="http://logging.apache.org/log4j/docs/index.html">Log4J</a>,
<a href="http://avalon.apache.org/logkit/index.html">Avalon LogKit</a>,
and
<a>JDK 1.4</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>,
the Avalon Framework's logging infrastructure,
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.
</p>
</p>
</section>
<section name="Users Quick Start">

15
xdocs/proposal.xml
View File

@@ -73,9 +73,18 @@ Non-goals:
</p>
<ul>
<li>Java Development Kit (Version 1.1 or later)
</li>
<li>log4j (compile-time dependency only) </li>
<li>Java Development Kit (Version 1.1 or later)</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>
</subsection>