commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From craig...@apache.org
Subject cvs commit: jakarta-commons/logging/xdocs guide.xml proposal.xml
Date Sat, 28 Feb 2004 23:20:57 GMT
craigmcc    2004/02/28 15:20:57

  Modified:    logging  PROPOSAL.html RELEASE-NOTES.txt STATUS.html
                        usersguide.html
               logging/xdocs guide.xml proposal.xml
  Log:
  Update release notes for all the changes (so far) to be included in a
  commons-logging 1.0.4 release.  Tweak documentation to reflect the
  availability of two new Log implementations (Avalon Framework and
  LumberJack).
  
  Revision  Changes    Path
  1.7       +11 -1     jakarta-commons/logging/PROPOSAL.html
  
  Index: PROPOSAL.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/logging/PROPOSAL.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- PROPOSAL.html	28 Feb 2004 22:10:53 -0000	1.6
  +++ PROPOSAL.html	28 Feb 2004 23:20:57 -0000	1.7
  @@ -72,7 +72,17 @@
   <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>
  
  
  
  1.4       +41 -46    jakarta-commons/logging/RELEASE-NOTES.txt
  
  Index: RELEASE-NOTES.txt
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/logging/RELEASE-NOTES.txt,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- RELEASE-NOTES.txt	28 Feb 2004 22:10:53 -0000	1.3
  +++ RELEASE-NOTES.txt	28 Feb 2004 23:20:57 -0000	1.4
  @@ -19,7 +19,7 @@
   $Id$
   
                              Commons Logging Package
  -                                Version 1.0.3
  +                                Version 1.0.4
                                   Release Notes
   
   
  @@ -28,71 +28,66 @@
   
   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.
  -
  -[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.
  -
  -[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.
  -
  -[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.
  +[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.
  +
  +[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.
  +
  +[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/>
  +
   
   BUG FIXES:
   =========
   
  -[build.xml]        Correct the META-INF/MANIFEST.MF that was embedded in the
  -                   generated JAR files to properly contain the version number.
  -
  -[LogFactory]       Fix security violations on several ClassLoader method
  -                   invocations.
  -
  -[SimpleLog]        Dump stack trace through logger, instead of directly to
  -                   System.out, to preserve output sequence.
  +[MANIFEST.MF]      Remove reference to Log4J from the manifest classpath.
   
  -[SimpleLog]        Avoid a security exception if system properties cannot be
  -                   read (such as in an applet).
  +[LogConfigurationException]
  +                   Include root cause in the text of the message, if present.
   
  -[Bugzilla 10825]   NullPointerException when Logger.getClassLoader()
  -                   returns null.
  +[LogFactory]       Improve usability of error messages reporting
  +                   configuration problems.
   
  -[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.
  +[JDK14Logger]      Implement Serializable, remove "final" declaration for
  +                   easy subclassing.
   
  -[Bugzilla 13157]   Incorrect selection of Log4J in a servlet container.
  +[Log4JLogger]      Implement Serializable, remove "final" declaration for
  +                   easy subclassing.
   
  -[Bugzilla 13201]   Log4JLogger should not attempt to auto-configure
  -                   appenders; this is out of scope for commons-logging.
  +[NoOpLogger]       Implement Serializable, remove "final" declaration for
  +                   easy subclassing.
   
  -[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.
   
  
  
  
  1.16      +5 -2      jakarta-commons/logging/STATUS.html
  
  Index: STATUS.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/logging/STATUS.html,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- STATUS.html	28 Feb 2004 22:10:53 -0000	1.15
  +++ STATUS.html	28 Feb 2004 23:20:57 -0000	1.16
  @@ -58,8 +58,10 @@
   <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 @@
       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>
  
  
  
  1.8       +3 -2      jakarta-commons/logging/usersguide.html
  
  Index: usersguide.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/logging/usersguide.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- usersguide.html	28 Feb 2004 22:10:53 -0000	1.7
  +++ usersguide.html	28 Feb 2004 23:20:57 -0000	1.8
  @@ -67,8 +67,9 @@
   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>
   
  
  
  
  1.4       +7 -7      jakarta-commons/logging/xdocs/guide.xml
  
  Index: guide.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/logging/xdocs/guide.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- guide.xml	28 Feb 2004 22:10:53 -0000	1.3
  +++ guide.xml	28 Feb 2004 23:20:57 -0000	1.4
  @@ -40,15 +40,15 @@
   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">
  
  
  
  1.3       +12 -3     jakarta-commons/logging/xdocs/proposal.xml
  
  Index: proposal.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/logging/xdocs/proposal.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- proposal.xml	28 Feb 2004 22:10:53 -0000	1.2
  +++ proposal.xml	28 Feb 2004 23:20:57 -0000	1.3
  @@ -73,9 +73,18 @@
   </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>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message