commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: jakarta-commons/logging/src/java/org/apache/commons/logging package.html
Date Tue, 22 Jan 2002 22:10:46 GMT
rdonkin     02/01/22 14:10:45

  Modified:    logging/src/java/org/apache/commons/logging package.html
  Updated package documentation to reflect latest Log interface
  Revision  Changes    Path
  1.4       +9 -7      jakarta-commons/logging/src/java/org/apache/commons/logging/package.html
  Index: package.html
  RCS file: /home/cvs/jakarta-commons/logging/src/java/org/apache/commons/logging/package.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- package.html	8 Jan 2002 21:35:10 -0000	1.3
  +++ package.html	22 Jan 2002 22:10:45 -0000	1.4
  @@ -14,7 +14,7 @@
       JDK Logging API</a>, included in JDK 1.4 or later systems.  Each named
       <a href="Log.html">Log</a> instance is connected to a corresponding
       <code>java.util.logging.Logger</code> instance.</li>
  -<li><a href="">LogKit</a> from
  +<li><a href="">LogKit</a> from Apache's
       Jakarta project.  Each named <a href="Log.html">Log</a> instance is
       connected to a corresponding LogKit <code>Logger</code>.</li>
   <li><a href="NoOpLog.html">NoOpLog</a> implementation that simply swallows
  @@ -26,6 +26,8 @@
   <h3>Configuring the Logging Package APIs</h3>
  +<h4>Choosing A <code>Log</code> Implementation</h4>
   <p>The Logging Package APIs are configured based on the values of system
   properties, which are normally set on the command line that started your
   application.  The following system properties are global to all
  @@ -49,8 +51,13 @@
       throws away all logged output.</li>
  +<h4>Configuring the Underlying Logging System</h4>
  +<p>The basic principle is that the user is totally responsible for the 
  +configuration of the underlying logging system. 
  +Commons-logging should not change the existing configuration.</p>
  -<p>Additionally, each individual <a href="Log.html">Log</a> implementation
  +<p>Each individual <a href="Log.html">Log</a> implementation may
   support its own configuration properties.  These will be documented in the
   class descriptions for the corresponding implementation class.</p>
  @@ -72,11 +79,6 @@
       references to multiple loggers that are used for different
       purposes.  A typical scenario for a server application is to have each
       major component of the server use its own Log instance.</li>
  -<li>Optionally, you can dynamically change the logging detail level by
  -    calling <a href="Log.html#setLevel(int)">Log.setLevel()</a> with
  -    an appropriate constant from the <code>Log</code> interface.  Note that,
  -    in most cases, the underlying logging system configuration will have
  -    been preconfigured by the system administrator.</li>
   <li>Cause messages to be logged (if the corresponding detail level is enabled)
       by calling appropriate methods (<code>debug()</code>, <code>info()</code>,
       <code>warn()</code>, <code>error</code>, and <code>fatal()</code>).</li>

To unsubscribe, e-mail:   <>
For additional commands, e-mail: <>

View raw message