ceki        01/06/19 08:45:09

  Modified:    docs     HISTORY critique.html download.html
               src/java/org/apache/log4j BasicConfigurator.java
                        Category.java Hierarchy.java
               src/java/org/apache/log4j/performance NotLogging.java
               src/java/org/apache/log4j/xml DOMConfigurator.java log4j.dtd
               src/xdocs download.xml index.xml
  Log:
  Minor documentation changes.
  
  Revision  Changes    Path
  1.53      +11 -0     jakarta-log4j/docs/HISTORY
  
  Index: HISTORY
  ===================================================================
  RCS file: /home/cvs/jakarta-log4j/docs/HISTORY,v
  retrieving revision 1.52
  retrieving revision 1.53
  diff -u -r1.52 -r1.53
  --- HISTORY   2001/06/07 21:09:59     1.52
  +++ HISTORY   2001/06/19 15:44:42     1.53
  @@ -5,6 +5,17 @@
          client code. 
    [***] Changes requiring important modifications to existing client code.
   
  + June 19, 2001
  +
  + - Release of version 1.1.3
  +
  + - Added a missing namespace declaration in the log4j:configuration
  +   element in log4j.dtd. The missing declaration caused the new
  +   generation of namespace aware parsers to barf when parsing log4j
  +   configuration files. [*]
  +
  + - Minor documentation changes. [*]
  +
    June 7, 2001
   
    - Release of version 1.1.2
  
  
  
  1.11      +29 -27    jakarta-log4j/docs/critique.html
  
  Index: critique.html
  ===================================================================
  RCS file: /home/cvs/jakarta-log4j/docs/critique.html,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -r1.10 -r1.11
  --- critique.html     2001/06/19 07:24:33     1.10
  +++ critique.html     2001/06/19 15:44:44     1.11
  @@ -298,15 +298,15 @@
   
   <p><b>Please direct your polite and personalized request to <a
   href="mailto:[EMAIL PROTECTED]";>[EMAIL PROTECTED]</a>
  -with <em>Bcc:</em> to <a href="mailto:[EMAIL PROTECTED]";>[EMAIL PROTECTED]</a>.</b>
  +with Bcc: to <a href="mailto:[EMAIL PROTECTED]";>[EMAIL PROTECTED]</a>.</b>
   
   <p>By the way, e-mail to <code>[EMAIL PROTECTED]</code>
   does not go to the JSR47 experts group but is internal to Sun
   Microsystems. <em>The address of the JSR47 experts group mailing list
   is considered confidential information.</em> I do not know it myself.
   
  -<p>In just five days one hundred individuals, including some from very
  -large accounts, have written to Sun to express their concern; the vast
  +<p>Over one hundred individuals, including some from very large
  +accounts, have written to Sun to express their concern, in their vast
   majority pushing for the adoption of log4j. Their names and the
   content of their request are listed below. I am very grateful for
   their support. Some of these requests are quite detailed and
  @@ -316,24 +316,24 @@
   <li><p><a href="pub-support/ChristopherTaylor.html">Christopher Taylor</a> <!-- -->
   <li><p>Jon Stevens
   <li><p><a href="pub-support/PaulGrinchenko.html">Paul Grinchenko</a> <!-- -->
  -<li><p><a href="pub-support/CourtDemas.html">Court Demas</a> and his <a 
href="pub-support/CourtDemas2.html">follow up</a>
  -<li><p><a href="pub-support/NelsonMinar.html">Nelson Minar</a> 
  +<li><p><a href="pub-support/CourtDemas.html">Court Demas</a> and his <a 
href="pub-support/CourtDemas2.html">follow up</a> <!-- -->
  +<li><p><a href="pub-support/NelsonMinar.html">Nelson Minar</a> <!-- -->
   <li><p><a href="pub-support/RobertMahoney.html">Robert Mahoney</a> <!-- -->
   <li><p><a href="pub-support/EllisTeer.html">Ellis Teer</a> 
   <li><p><a href="pub-support/GuyLichtman.html">Guy Lichtman</a> <!-- -->
   <li><p><a href="pub-support/MichaelMoser.html">Michael Moser</a> <!-- -->
   <li><p><a href="pub-support/HenrikLundahl.html">Henrik Lundahl</a> 
  -<li><p><a href="pub-support/ThomasFenner.html">Thomas Fenner</a> 
  +<li><p><a href="pub-support/ThomasFenner.html">Thomas Fenner</a> <!-- -->
   <li><p><a href="pub-support/EndreStolsvik.html">Endre St&oslash;lsvik</a> <!-- -->
   <li><p><a href="pub-support/KnutErikBallestad.html">Knut Erik Ballestad</a> 
   <li><p><a href="pub-support/HenrikFredholm.html">Henrik Fredholm</a> and his <a 
href="pub-support/HenrikFredholm2.html">follow up</a> to Graham.
   <li><p><a href="pub-support/JohnVolkar.html">John Volkar</a> <!-- -->
   <li><p><a href="pub-support/WilliamJaynes.html">William Jaynes</a> <!-- -->
   <li><p><a href="pub-support/MichaelStacey.html">Michael Stacey</a> <!-- -->
  -<li><p><a href="pub-support/StacyCurl.html">Stacy Curl</a> 
  +<li><p><a href="pub-support/StacyCurl.html">Stacy Curl</a> <!-- -->
   <li><p><a href="pub-support/DavidOwens.html">David Owens</a> <!-- -->
  -<li><p><a href="pub-support/EoinFlood.html">Eoin Flood </a> 
  -<li><p><a href="pub-support/TonyDean.html">Tony Dean </a> 
  +<li><p><a href="pub-support/EoinFlood.html">Eoin Flood </a> <!-- -->
  +<li><p><a href="pub-support/TonyDean.html">Tony Dean </a> <!-- -->
   <li><p><a href="pub-support/AlexBlewitt.html">AlexBlewitt</a> 
   <li><p><a href="pub-support/JamesProkash.html">James Prokash</a> <!-- -->
   <li><p><a href="pub-support/RalfHaug.html">Ralf Haug</a> <!-- -->
  @@ -345,10 +345,10 @@
   <li><p><a href="pub-support/AbeMirrashidi.html">Abe Mirrashidi</a> <!-- -->
   <li><p><a href="pub-support/JasonKitcat.html">Jason Kitcat</a> <!-- -->
   <li><p><a href="pub-support/RonJacobs.html">Ron Jacobs</a> <!-- -->
  -<li><p><a href="pub-support/AndyDePue.html">Andy DePue</a>  and his <a 
href="pub-support/AndyDePue2.html">follow up</a> 
  +<li><p><a href="pub-support/AndyDePue.html">Andy DePue</a>  and his <a 
href="pub-support/AndyDePue2.html">follow up</a> <!-- -->
   <li><p><a href="pub-support/JoeLoda.html">Joe Loda</a> <!-- -->
   <li><p><a href="pub-support/DavidMaharaj.html">David Maharaj</a> <!-- -->
  -<li><p><a href="pub-support/FrankBaxter.html">Frank Baxter</a> 
  +<li><p><a href="pub-support/FrankBaxter.html">Frank Baxter</a> <!-- -->
   <li><p><a href="pub-support/HenryLi.html">Henry Li</a> <!-- -->
   <li><p><a href="pub-support/RichardWilliams.html">Richard Williams </a> <!-- -->
   <li><p><a href="pub-support/JasonHeirtzler.html">Jason Heirtzler</a> <!-- -->
  @@ -356,9 +356,9 @@
   <li><p><a href="pub-support/ChandraPatni.html">Chandra Patni</a> <!-- -->
   <li><p><a href="pub-support/DanielHoppe.html">Daniel Hoppe </a> <!-- -->
   <li><p><a href="pub-support/SebastienGuimont.html">Sebastien Guimont</a> <!-- -->
  -<li><p><a href="pub-support/ThomasQuas.html">Thomas Quas</a> 
  +<li><p><a href="pub-support/ThomasQuas.html">Thomas Quas</a> <!-- -->
   <li><p><a href="pub-support/JeffTurner.html">Jeff Turner</a> 
  -<li><p><a href="pub-support/JohnMunsch.html">John Munsch</a> 
  +<li><p><a href="pub-support/JohnMunsch.html">John Munsch</a> <!-- -->
   <li><p><a href="pub-support/DelEdwards.html">Del Edwards</a> <!-- -->
   <li><p><a href="pub-support/Piper.html">Piper</a> <!-- -->
   <li><p><a href="pub-support/TimColson.html">Tim Colson</a> <!-- -->
  @@ -368,35 +368,35 @@
   <li><p><a href="pub-support/PayamMirrashidi.html">Payam Mirrashidi</a> <!-- -->
   <li><p><a href="pub-support/BruceDeen.html">Bruce W. Deen</a> 
   <li><p><a href="pub-support/EmilyBache.html">Emily Bache</a> and her <a 
href="pub-support/EmilyBache2.html">follow up</a> <!-- -->
  -<li><p><a href="pub-support/JulienDubois.html">Julien Dubois</a> 
  -<li><p><a href="pub-support/AlefArendsen.html">Alef Arendsen</a> 
  +<li><p><a href="pub-support/JulienDubois.html">Julien Dubois</a> <!-- -->
  +<li><p><a href="pub-support/AlefArendsen.html">Alef Arendsen</a> <!-- -->
   <li><p><a href="pub-support/SorenHilmer.html">S&oslash;ren Hilmer</a> 
  -<li><p><a href="pub-support/MaheshBhat.html">Mahesh Bhat</a> 
  +<li><p><a href="pub-support/MaheshBhat.html">Mahesh Bhat</a> <!-- -->
   <li><p><a href="pub-support/JeffLinwood.html">Jeff Linwood</a> 
  -<li><p><a href="pub-support/PeterMeulmeester.html">Peter Meulmeester</a> 
  +<li><p><a href="pub-support/PeterMeulmeester.html">Peter Meulmeester</a> <!-- -->
   <li><p><a href="pub-support/MichaelDuffy.html">Michael Duffy</a> <!-- -->
   <li><p><a href="pub-support/BillGriffith.html">Bill Griffith</a> 
   <li><p><a href="pub-support/DanielBram.html">Daniel Bram</a> <!-- -->
   <li><p><a href="pub-support/RichardDallaway.html">Richard Dallaway</a> <!-- -->
  -<li><p><a href="pub-support/ChrisMein.html">Chris Mein</a> 
  +<li><p><a href="pub-support/ChrisMein.html">Chris Mein</a> <!-- -->
   <li><p><a href="pub-support/BenjaminRussellStocum.html">Benjamin Russell Stocum</a> 
<!-- -->
   <li><p><a href="pub-support/GuyNirpaz.html">Guy Nirpaz</a> 
   <li><p><a href="pub-support/GrayJones.html">Gray Jones</a> <!-- -->
  -<li><p><a href="pub-support/CarlosPerez.html">Carlos Perez</a> 
  +<li><p><a href="pub-support/CarlosPerez.html">Carlos Perez</a> <!-- -->
   <li><p><a href="pub-support/PaulMichaelReilly.html">Paul Michael Reilly</a> <!-- -->
   <li><p><a href="pub-support/MarcusAhnve.html">Marcus Ahnve</a> <!-- -->
   <li><p><a href="pub-support/DavidDuddleston.html">David Duddleston</a> <!-- -->
   <li><p><a href="pub-support/BrianPaulsen.html">Brian Paulsen</a> 
  -<li><p><a href="pub-support/AlexFernandez.html">Alex Fernández</a> 
  +<li><p><a href="pub-support/AlexFernandez.html">Alex Fernández</a> <!-- -->
   <li><p><a href="pub-support/DanielStephan.html">Daniel Stephan</a> <!-- -->
  -<li><p><a href="pub-support/AlexanderEvsukov.html">Alexander Evsukov</a> 
  +<li><p><a href="pub-support/AlexanderEvsukov.html">Alexander Evsukov</a> <!-- -->
   <li><p><a href="pub-support/StevenSagaert.html">Steven Sagaert</a> <!-- -->
   <li><p><a href="pub-support/DougErickson.html">Doug Erickson</a> 
   <li><p><a href="pub-support/ScottGilpin.html">Scott Gilpin </a> <!-- -->
   <li><p><a href="pub-support/NateSammons.html">Nate Sammons</a> author of <a 
href="http://protomatter.sourceforge.net";>Protomatter Syslog</a> <!-- -->
  -<li><p><a href="pub-support/StephanSchmidt.html">Stephan J. Schmidt</a> 
  +<li><p><a href="pub-support/StephanSchmidt.html">Stephan J. Schmidt</a> <!-- -->
   <li><p><a href="pub-support/JochenBedersdorfer.html">Jochen Bedersdorfer</a> <!-- 
-->
  -<li><p><a href="pub-support/BalajiKithiganahalli.html">Balaji Kithiganahalli</a> 
and his <a href="pub-support/BalajiKithiganahalli2.html">follow up</a>
  +<li><p><a href="pub-support/BalajiKithiganahalli.html">Balaji Kithiganahalli</a> 
and his <a href="pub-support/BalajiKithiganahalli2.html">follow up</a> <!-- -->
   <li><p><a href="pub-support/ChrisYearsley.html">Chris Yearsley</a> 
   <li><p><a href="pub-support/ScottFleming.html">Scott Fleming</a> <!-- -->
   <li><p><a href="pub-support/PaulCraven.html">Paul Craven</a> <!-- -->
  @@ -404,7 +404,7 @@
   <li><p><a href="pub-support/AndrewHarris.html">Andrew Harris</a> <!-- -->
   <li><p><a href="pub-support/BernshtamPavel.html">Bernshtam Pavel</a> <!-- -->
   <li><p><a href="pub-support/TomJanofsky.html">Tom Janofsky</a> 
  -<li><p><a href="pub-support/StephenAshcroft.html">Stephen Ashcroft</a> 
  +<li><p><a href="pub-support/StephenAshcroft.html">Stephen Ashcroft</a> <!-- -->
   <li><p><a href="pub-support/BradleySchatz.html">Bradley Schatz</a> <!-- -->
   <li><p><a href="pub-support/ErikBergersjo.html">Erik Bergersj&ouml;</a> <!-- -->
   <li><p><a href="pub-support/KevinHuber.html">Kevin Huber</a>  <!-- -->
  @@ -414,11 +414,13 @@
   <li><p><a href="pub-support/ArndtSchoenewald.html">Arndt Schoenewald</a> <!-- -->
   <li><p><a href="pub-support/ScottEllsworth.html">Scott Ellsworth</a> 
   <li><p><a href="pub-support/BrettMorgan.html">Brett Morgan </a> <!-- -->
  +<li><p><a href="pub-support/HorstScheruga.html">Horst Scheruga</a> <!-- -->
  +<li><p><a href="pub-support/AxelBoness.html">Axel Boness</a> <!-- -->
  +<li><p><a href="pub-support/EdHowland.html">Ed Howland</a> <!-- -->
   
  +
   <!--
  -<li><p><a href="pub-support/ .html"></a> 
  -<li><p><a href="pub-support/ .html"></a> 
  -<li><p><a href="pub-support/ .html"></a> 
  +
   <li><p><a href="pub-support/ .html"></a> 
   <li><p><a href="pub-support/ .html"></a> 
   <li><p><a href="pub-support/ .html"></a> 
  
  
  
  1.29      +25 -14    jakarta-log4j/docs/download.html
  
  Index: download.html
  ===================================================================
  RCS file: /home/cvs/jakarta-log4j/docs/download.html,v
  retrieving revision 1.28
  retrieving revision 1.29
  diff -u -r1.28 -r1.29
  --- download.html     2001/06/17 07:33:54     1.28
  +++ download.html     2001/06/19 15:44:45     1.29
  @@ -116,7 +116,7 @@
                                                                       <table 
border="0" cellspacing="0" cellpadding="2" width="100%">
         <tr><td bgcolor="#525D76">
           <font color="#ffffff" face="arial,helvetica,sanserif">
  -          <a name="log4j version 1.1.2"><strong>log4j version 1.1.2</strong></a>
  +          <a name="log4j version 1.1.3"><strong>log4j version 1.1.3</strong></a>
           </font>
         </td></tr>
         <tr><td><br/></td></tr>
  @@ -126,13 +126,13 @@
                                                   <h2>Join our <a 
href="critique.html">campaign</a> to influence the JSR47 API.
   </h2>
                                                   <hr />
  -                                                <p>Download version 1.1.2 including 
<i>full source code</i>, class files
  +                                                <p>Download version 1.1.3 including 
<i>full source code</i>, class files
   and documentation in
  -<a href="../jakarta-log4j-1.1.2.tar.gz"><b>TAR.GZ</b></a> format or in
  -<a href="../jakarta-log4j-1.1.2.zip"><b>ZIP</b></a> format. You may
  +<a href="../jakarta-log4j-1.1.3.tar.gz"><b>TAR.GZ</b></a> format or in
  +<a href="../jakarta-log4j-1.1.3.zip"><b>ZIP</b></a> format. You may
   elect to browse log4j <a href="documentation.html"><b>documentation</b></a> online. 
   </p>
  -                                                <p><a 
href="http://www.javaworld.com/javaworld/jw-05-2001/jw-0504-finalists.html";><img 
src="images/ecaward_finalist_logo.gif" align="right" border="0" /></a>Version 1.1.2 is 
the 21st major public release of
  +                                                <p><a 
href="http://www.javaworld.com/javaworld/jw-05-2001/jw-0504-finalists.html";><img 
src="images/ecaward_finalist_logo.gif" align="right" border="0" /></a>Version 1.1.3 is 
the 21st major public release of
   log4j. It is backward compatible with log4j version 1.0.x.</p>
                                                   <p>We also maintain a list of <a 
href="earlier.html">earlier
   versions</a> of log4j for download, intended for the curious
  @@ -152,27 +152,38 @@
         <tr><td>
           <blockquote>
                                       <dl>
  +  <dt><a href="http://sourceforge.net/projects/log4cpp/";><b>log4cpp</b></a></dt>
  +  <dd>A library of C++ classes for flexible logging to files, syslog, IDSA and 
  +      other destinations modeled after log4j by Bastiaan Bakker.</dd>
  +
     <dt><a href="http://log4p.sourceforge.net";><b>log4p</b></a></dt>
     <dd>A Python translation of log4j by Igor Poteryaev.</dd>
   
  +  <dt><a 
href="http://support.klopotek.de/log4j/jdbc/index.html";><b>JDBCAppender</b></a></dt>
  +  <dd>A JDBCAppender by <a href="mailto:[EMAIL PROTECTED]";>Thomas 
Fenner</a>.</dd>
   
  -  <dt><a href="http://www.japhy.de/configLog4j";><b>configLog4j</b></a></dt>
  -  <dd>A visual log4j configuration file editor by Tobias Dezulian.</dd>
  +  <dt /><a 
href="http://www.servidium.com/site/logfactor5/index.html";><b>LogFactor5</b></a>
   
  +  <dd>A GUI appender (commercial).</dd>
   
  -  <dt><a href="http://sourceforge.net/projects/log4cpp/";><b>log4cpp</b></a></dt>
  -  <dd>A library of C++ classes for flexible logging to files, syslog, IDSA and 
  -      other destinations modeled after log4j by Bastiaan Bakker.</dd>
  +  <dt><a href="http://jakarta.apache.org/taglibs/doc/log-doc/intro.html";>
  +         <b>Log Tag</b></a>
  +  </dt>
  +  <dd>A custom log tag from the <a 
href="http://jakarta.apache.org/taglibs/index.html";>Jakarta Taglibs</a> project.</dd>
  +
  +  <dt><a href="http://www.epesh.com/logtags.jsp";><b>The Log Tag Library</b></a></dt>
  +  <dd>Yet another tag library designed to give JSP tag-level access to log4j.</dd>
   
  +  <dt><a href="http://www.japhy.de/configLog4j";><b>configLog4j</b></a></dt>
  +  <dd>A visual log4j configuration file editor by Tobias Dezulian.</dd>
  +
  +    
     <dt><a href="http://developer.jini.org/exchange/projects/log";><b>JINI logging 
service</b></a></dt>
     <dd>A log4j wrapper for JINI Jerome Bernard.</dd>
   
   
  -  <dt><a 
href="http://support.klopotek.de/log4j/jdbc/index.html";><b>JDBCAppender</b></a></dt>
  -  <dd>A JDBCAppender by <a href="mailto:[EMAIL PROTECTED]";>Thomas 
Fenner</a>.</dd>
   
  -  <dt><a href="http://www.epesh.com/logtags.jsp";><b>The Log Tag Library</b></a></dt>
  -  <dd>A tag library designed to give JSP tag-level access to log4j.</dd>
  +  
   </dl>
                                                   <p>If you would like your software 
to be listed here, then send a note
   to the <a 
href="mailto:[EMAIL PROTECTED]";>[EMAIL PROTECTED]</a>
  
  
  
  1.14      +1 -1      jakarta-log4j/src/java/org/apache/log4j/BasicConfigurator.java
  
  Index: BasicConfigurator.java
  ===================================================================
  RCS file: /home/cvs/jakarta-log4j/src/java/org/apache/log4j/BasicConfigurator.java,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- BasicConfigurator.java    2001/05/09 18:59:11     1.13
  +++ BasicConfigurator.java    2001/06/19 15:44:50     1.14
  @@ -38,7 +38,7 @@
        Hierarchy#disableAll}, {@link Hierarchy#disableDebug} and {@link
        Hierarchy#disableInfo}. Thus, enabling normal evaluation of logging
        requests, i.e. according to the <a
  -     href="../../manual.html#selectionRule">Basic Selection Rule</a>.
  +     href="../../../../manual.html#selectionRule">Basic Selection Rule</a>.
   
        <p>If both <code>log4j.disableOverride</code> and a
        <code>log4j.disable</code> options are present, then
  
  
  
  1.30      +47 -39    jakarta-log4j/src/java/org/apache/log4j/Category.java
  
  Index: Category.java
  ===================================================================
  RCS file: /home/cvs/jakarta-log4j/src/java/org/apache/log4j/Category.java,v
  retrieving revision 1.29
  retrieving revision 1.30
  diff -u -r1.29 -r1.30
  --- Category.java     2001/05/31 22:23:04     1.29
  +++ Category.java     2001/06/19 15:44:51     1.30
  @@ -628,14 +628,15 @@
     }
   
     /**
  -     Return the {@link ResourceBundle} for this category.
  +     Return the <em>inherited</em> {@link ResourceBundle} for this
  +     category.
   
        <p>This method walks the hierarchy to find the appropriate
  -     resource bundle.
  +     resource bundle. It will return the resource bundle attached to
  +     the closest ancestor of this category, much like the way
  +     priorities are searched. In case there is no bundle in the
  +     hierarchy then <code>null</code> is returned.
   
  -     <p>In case there is no bundle in the hierarchy then
  -     <code>null</code> is returned.
  -
        @since 0.9.0 */
     public
     ResourceBundle getResourceBundle() {
  @@ -647,6 +648,14 @@
       return null;
     }
   
  +  /**
  +     Returns the string resource coresponding to <code>key</code> in
  +     this category's inherited resource bundle. See also {@link
  +     #getResourceBundle}.
  +
  +     <p>If the resource cannot be found, then an {@link #error error}
  +     message will be logged complaining about the missing resource.
  +  */
     protected
     String getResourceBundleString(String key) {
       ResourceBundle rb = getResourceBundle();
  @@ -712,40 +721,39 @@
     }
   
     /**
  -     Check whether this category is enabled for the <code>DEBUG</code>
  -     priority.
  -     
  -     <p> This function is intended to lessen the computational cost of
  -     disabled log debug statements.
  -
  -     <p> For some <code>cat</code> Category object, when you write,
  -     <pre>
  -       cat.debug("This is entry number: " + i );
  -     </pre>
  -
  -     <p>You incur the cost constructing the message, concatenatiion in
  -     this case, regardless of whether the message is logged or not.
  -
  -     <p>If you are worried about speed, then you should write
  -     <pre>
  -       if(cat.isDebugEnabled()) {
  -         cat.debug("This is entry number: " + i );
  -       }
  -     </pre>
  -
  -     <p>This way you will not incur the cost of parameter construction
  -     if debugging is disabled for <code>cat</code>. On the other hand,
  -     if the <code>cat</code> is debug enabled, you will incur the cost
  -     of evaluating whether the category is debug enabled twice. Once
  -     in <code>isDebugEnabled</code> and once in the
  -     <code>debug</code>.  This is an insignificant overhead since
  -     evaluating a category takes about 1% of the time it takes to
  -     actually log.
  -
  -     @return boolean - <code>true</code> if this category is debug
  -     enabled, <code>false</code> otherwise.
  -     
  -   */
  +    *  Check whether this category is enabled for the <code>DEBUG</code>
  +    *  priority.
  +    *  
  +    *  <p> This function is intended to lessen the computational cost of
  +    *  disabled log debug statements.
  +    * 
  +    *  <p> For some <code>cat</code> Category object, when you write,
  +    *  <pre>
  +    *      cat.debug("This is entry number: " + i );
  +    *  </pre>
  +    *  
  +    *  <p>You incur the cost constructing the message, concatenatiion in
  +    *  this case, regardless of whether the message is logged or not.
  +    * 
  +    *  <p>If you are worried about speed, then you should write
  +    *  <pre>
  +    *         if(cat.isDebugEnabled()) { 
  +    *           cat.debug("This is entry number: " + i );
  +    *         }
  +    *  </pre>
  +    * 
  +    *  <p>This way you will not incur the cost of parameter
  +    *  construction if debugging is disabled for <code>cat</code>. On
  +    *  the other hand, if the <code>cat</code> is debug enabled, you
  +    *  will incur the cost of evaluating whether the category is debug
  +    *  enabled twice. Once in <code>isDebugEnabled</code> and once in
  +    *  the <code>debug</code>.  This is an insignificant overhead
  +    *  since evaluating a category takes about 1%% of the time it
  +    *  takes to actually log.
  +    * 
  +    *  @return boolean - <code>true</code> if this category is debug
  +    *  enabled, <code>false</code> otherwise.
  +    *   */
     public
     boolean isDebugEnabled() {
       if(hierarchy.disable >=  Priority.DEBUG_INT)
  
  
  
  1.18      +2 -2      jakarta-log4j/src/java/org/apache/log4j/Hierarchy.java
  
  Index: Hierarchy.java
  ===================================================================
  RCS file: /home/cvs/jakarta-log4j/src/java/org/apache/log4j/Hierarchy.java,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- Hierarchy.java    2001/06/06 16:07:11     1.17
  +++ Hierarchy.java    2001/06/19 15:44:53     1.18
  @@ -209,8 +209,8 @@
        regardless of category. Note that DEBUG messages are also
        disabled.  
   
  -     <p>Invoking this method is equivalent to calling {@link #disable}
  -     with the argument {@link Priority#INFO}.
  +     <p>Invoking this method is equivalent to calling {@link
  +     #disable(Priority)} with the argument {@link Priority#INFO}.
   
        @since 0.8.5 */
     public
  
  
  
  1.5       +4 -5      
jakarta-log4j/src/java/org/apache/log4j/performance/NotLogging.java
  
  Index: NotLogging.java
  ===================================================================
  RCS file: 
/home/cvs/jakarta-log4j/src/java/org/apache/log4j/performance/NotLogging.java,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- NotLogging.java   2001/02/13 17:37:25     1.4
  +++ NotLogging.java   2001/06/19 15:44:56     1.5
  @@ -124,13 +124,12 @@
       
       ConsoleAppender appender = new ConsoleAppender(new SimpleLayout());
       
  -    if("false".equals(args[0]))
  -      ;       
  -    else if ("true".equals(args[0])) {
  +    if("false".equals(args[0])) {
  +      // nothing to do
  +    } else if ("true".equals(args[0])) {
         System.out.println("Flagging as shipped code.");
         Category.getDefaultHierarchy().disableInfo();
  -    }
  -    else 
  +    } else 
         Usage();
   
       SHORT_CAT.setPriority(Priority.INFO);      
  
  
  
  1.23      +1 -4      jakarta-log4j/src/java/org/apache/log4j/xml/DOMConfigurator.java
  
  Index: DOMConfigurator.java
  ===================================================================
  RCS file: 
/home/cvs/jakarta-log4j/src/java/org/apache/log4j/xml/DOMConfigurator.java,v
  retrieving revision 1.22
  retrieving revision 1.23
  diff -u -r1.22 -r1.23
  --- DOMConfigurator.java      2001/06/14 10:07:49     1.22
  +++ DOMConfigurator.java      2001/06/19 15:44:59     1.23
  @@ -50,13 +50,10 @@
      line. Alternatively, set the <code>debug</code> attribute in the
      <code>log4j:configuration</code> element. As in
   <pre>
  -   <log4j:configuration debug=true" xmlns:log4j='http://jakarta.apache.org/log4j/'>
  +   <log4j:configuration debug=true" xmlns:log4j="http://jakarta.apache.org/log4j/";>
      ...
      </log4j:configuration>
   </pre>
  -
  -   
  -
   
      <p>There are sample XML files included in the package.
      
  
  
  
  1.8       +1 -1      jakarta-log4j/src/java/org/apache/log4j/xml/log4j.dtd
  
  Index: log4j.dtd
  ===================================================================
  RCS file: /home/cvs/jakarta-log4j/src/java/org/apache/log4j/xml/log4j.dtd,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- log4j.dtd 2001/06/18 07:58:12     1.7
  +++ log4j.dtd 2001/06/19 15:45:01     1.8
  @@ -28,7 +28,7 @@
   
        
   <!ATTLIST log4j:configuration
  -  xmlns:log4j              CDATA #FIXED "http://jakarta.apache.org/log4j"; 
  +  xmlns:log4j              CDATA #FIXED "http://jakarta.apache.org/log4j/"; 
     disable                  (debug|info|warn|error|fatal|null)  "null"
     disableOverride          (true|false|null)  "null"
     debug                    (true|false|null)  "null"
  
  
  
  1.26      +33 -21    jakarta-log4j/src/xdocs/download.xml
  
  Index: download.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-log4j/src/xdocs/download.xml,v
  retrieving revision 1.25
  retrieving revision 1.26
  diff -u -r1.25 -r1.26
  --- download.xml      2001/06/07 21:10:09     1.25
  +++ download.xml      2001/06/19 15:45:06     1.26
  @@ -32,60 +32,72 @@
   -->
   
    
  -<section name="log4j version 1.1.2">
  +<section name="log4j version 1.1.3">
   
  -<p>Download version 1.1.2 including <i>full source code</i>, class files
  +<hr/>
  +<h2>Join our <a href="critique.html">campaign</a> to influence the JSR47 API.
  +</h2>
  +<hr/>
  +
  +<p>Download version 1.1.3 including <i>full source code</i>, class files
   and documentation in
  -<a href="../jakarta-log4j-1.1.2.tar.gz"><b>TAR.GZ</b></a> format or in
  -<a href="../jakarta-log4j-1.1.2.zip"><b>ZIP</b></a> format. You may
  +<a href="../jakarta-log4j-1.1.3.tar.gz"><b>TAR.GZ</b></a> format or in
  +<a href="../jakarta-log4j-1.1.3.zip"><b>ZIP</b></a> format. You may
   elect to browse log4j <a
   href="documentation.html"><b>documentation</b></a> online. 
   </p>
   
  + 
   <p><a
   href="http://www.javaworld.com/javaworld/jw-05-2001/jw-0504-finalists.html";><img
   src="images/ecaward_finalist_logo.gif" align="right"
  -border="0"/></a>Version 1.1.2 is the 21st major public release of
  +border="0"/></a>Version 1.1.3 is the 21st major public release of
   log4j. It is backward compatible with log4j version 1.0.x.</p>
   
   <p>We also maintain a list of <a href="earlier.html">earlier
   versions</a> of log4j for download, intended for the curious
   paleontologist.</p>
   
  -<p>Thanks to <a href="mailto:[EMAIL PROTECTED]";>Henri Gomez</a>, Linux
  -users can now fetch log4j in RPM format at <a
  -href="http://rpmized.free.fr";>http://rpmized.free.fr</a> or
  -alternatively at <a
  
-href="ftp://ftp.falsehope.com/home/gomez/log4j/";>ftp://ftp.falsehope.com/home/gomez/log4j/</a>.</p>
  -
  -
   </section>
   
   <section name="Third-party software">
   
   <dl>
  +  <dt><a href="http://sourceforge.net/projects/log4cpp/";><b>log4cpp</b></a></dt>
  +  <dd>A library of C++ classes for flexible logging to files, syslog, IDSA and 
  +      other destinations modeled after log4j by Bastiaan Bakker.</dd>
  +
     <dt><a href="http://log4p.sourceforge.net";><b>log4p</b></a></dt>
     <dd>A Python translation of log4j by Igor Poteryaev.</dd>
   
  +  <dt><a 
href="http://support.klopotek.de/log4j/jdbc/index.html";><b>JDBCAppender</b></a></dt>
  +  <dd>A JDBCAppender by <a href="mailto:[EMAIL PROTECTED]";>Thomas 
Fenner</a>.</dd>
   
  -  <dt><a href="http://www.japhy.de/configLog4j";><b>configLog4j</b></a></dt>
  -  <dd>A visual log4j configuration file editor by Tobias Dezulian.</dd>
  +  <dt></dt><a
  +  href="http://www.servidium.com/site/logfactor5/index.html";><b>LogFactor5</b></a>
   
  +  <dd>A GUI appender (commercial).</dd>
   
  -  <dt><a href="http://sourceforge.net/projects/log4cpp/";><b>log4cpp</b></a></dt>
  -  <dd>A library of C++ classes for flexible logging to files, syslog, IDSA and 
  -      other destinations modeled after log4j by Bastiaan Bakker.</dd>
  +  <dt><a href="http://jakarta.apache.org/taglibs/doc/log-doc/intro.html";>
  +         <b>Log Tag</b></a>
  +  </dt>
  +  <dd>A custom log tag from the <a 
href="http://jakarta.apache.org/taglibs/index.html";>Jakarta Taglibs</a> project.</dd>
  +
  +  <dt><a href="http://www.epesh.com/logtags.jsp";><b>The Log Tag Library</b></a></dt>
  +  <dd>Yet another tag library designed to give JSP tag-level access to log4j.</dd>
   
  +  <dt><a href="http://www.japhy.de/configLog4j";><b>configLog4j</b></a></dt>
  +  <dd>A visual log4j configuration file editor by Tobias Dezulian.</dd>
  +
  +    
     <dt><a href="http://developer.jini.org/exchange/projects/log";><b>JINI logging 
service</b></a></dt>
     <dd>A log4j wrapper for JINI Jerome Bernard.</dd>
   
   
  -  <dt><a 
href="http://support.klopotek.de/log4j/jdbc/index.html";><b>JDBCAppender</b></a></dt>
  -  <dd>A JDBCAppender by <a href="mailto:[EMAIL PROTECTED]";>Thomas 
Fenner</a>.</dd>
   
  -  <dt><a href="http://www.epesh.com/logtags.jsp";><b>The Log Tag Library</b></a></dt>
  -  <dd>A tag library designed to give JSP tag-level access to log4j.</dd>
  +  
   </dl>
  +
   
   <p>If you would like your software to be listed here, then send a note
   to the <a
  
  
  
  1.4       +7 -0      jakarta-log4j/src/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-log4j/src/xdocs/index.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- index.xml 2001/05/20 10:39:31     1.3
  +++ index.xml 2001/06/19 15:45:07     1.4
  @@ -8,7 +8,14 @@
   
   <body>
   
  +
  +
   <section name="Introduction">
  +
  +<hr/>
  +<h2>Join our <a href="critique.html">campaign</a> to influence the JSR47 API.
  +</h2>
  +<hr/>
   
   <p>Inserting log statements into your code is a low-tech method for
   debugging it.  It may also be the only way because debuggers are not
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to