diff --git a/PROPOSAL.html b/PROPOSAL.html index 3fb0f30..98f71a9 100644 --- a/PROPOSAL.html +++ b/PROPOSAL.html @@ -72,7 +72,17 @@ Non-goals:

(2) Required Jakarta-Commons Resources

diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index 52510b0..70cefb0 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -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. + -[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 diff --git a/STATUS.html b/STATUS.html index 98e2e87..48ae636 100644 --- a/STATUS.html +++ b/STATUS.html @@ -25,7 +25,7 @@

The Jakarta Commons Logging Component

-$Id: STATUS.html,v 1.15 2004/02/28 22:10:53 craigmcc Exp $
+$Id: STATUS.html,v 1.16 2004/02/28 23:20:57 craigmcc Exp $
[Introduction] [Dependencies] [Release Info] @@ -58,8 +58,10 @@ The package does :
  • Have an API which should be as simple to use as possible
  • Provide support for Avalon's Logkit
  • Provide support for JDK 1.4 logging
    • -
  • Provide support for log4j
    • +
  • Provide support for Log4J
  • Provide support for Avalon-Framework's Logger
    • +
  • Provide support for Apache Avalon Framework (Optional, Version 4.0 or later)
    • +
  • LumberJack
  • Java Development Kit (Version 1.4 or later) logging APIs (Optional)
    • diff --git a/usersguide.html b/usersguide.html index 4ef12ff..ca1d3c8 100644 --- a/usersguide.html +++ b/usersguide.html @@ -67,8 +67,9 @@ a specific logging implementation. other logging tools, including Log4J, Avalon LogKit, -and -JDK 1.4. +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.

    diff --git a/xdocs/guide.xml b/xdocs/guide.xml index 2afdffe..4b025c6 100644 --- a/xdocs/guide.xml +++ b/xdocs/guide.xml @@ -40,15 +40,15 @@ a specific logging implementation. Familiarity with high-level details of various Logging implementations is presumed.

    -

    -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 -Log4J, -Avalon LogKit, -and -JDK 1.4. +Log4J, +Avalon LogKit, +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. -

    +

    diff --git a/xdocs/proposal.xml b/xdocs/proposal.xml index fc5660c..499c8ec 100644 --- a/xdocs/proposal.xml +++ b/xdocs/proposal.xml @@ -73,9 +73,18 @@ Non-goals:

      -
    • Java Development Kit (Version 1.1 or later) -
      • -
    • log4j (compile-time dependency only)
      • +
    • Java Development Kit (Version 1.1 or later)
      • +
    • Avalon Framework (compile-time dependency only unless this Log + implementation is selected at runtime) +
    • Avalon LogKit (compile-time dependency only unless this Log + implementation is selected at runtime) +
    • JDK 1.4 (compile-time dependency only unless this log implementation + is selected at runtime). +
    • Log4J (compile-time dependency only unless this Log + implementation is selected at runtime)
      • +
    • Lumberjack + (compile-time dependency only unless this Log + implementation is selected at runtime)