logging-log4j-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From carn...@apache.org
Subject cvs commit: logging-log4j/src/xdocs/stylesheets project.xml
Date Tue, 10 May 2005 15:23:02 GMT
carnold     2005/05/10 08:23:02

  Modified:    docs     chainsaw.html codes.html contributors.html
                        documentation.html download.html earlier.html
                        faq.html history.html index.html
                        install-chainsaw.html plan.html ugli.html
               src/xdocs download.xml index.xml ugli.xml
               src/xdocs/stylesheets project.xml
  Log:
  Remove 1.2.10 from log4j docs, move Chainsaw out of 3rd party downloads, add SLF4J and JCL, Remove SLF4J from nav menu
  
  Revision  Changes    Path
  1.5       +5 -3      logging-log4j/docs/chainsaw.html
  
  Index: chainsaw.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/chainsaw.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- chainsaw.html	3 Jan 2005 15:26:56 -0000	1.4
  +++ chainsaw.html	10 May 2005 15:23:01 -0000	1.5
  @@ -126,7 +126,7 @@
                
                   <!-- FOOTER -->
                 <div align="center"><font color="#525D76" size="-1"><em>
  -                 Copyright &#169; 1999-2004, Apache Software Foundation
  +                 Copyright &#169; 1999-2005, Apache Software Foundation
                  </em></font></div>
   
              <!-- END main table --> 
  @@ -141,9 +141,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.11      +5 -3      logging-log4j/docs/codes.html
  
  Index: codes.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/codes.html,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -r1.10 -r1.11
  --- codes.html	3 Jan 2005 15:26:56 -0000	1.10
  +++ codes.html	10 May 2005 15:23:01 -0000	1.11
  @@ -214,7 +214,7 @@
                
                   <!-- FOOTER -->
                 <div align="center"><font color="#525D76" size="-1"><em>
  -                 Copyright &#169; 1999-2004, Apache Software Foundation
  +                 Copyright &#169; 1999-2005, Apache Software Foundation
                  </em></font></div>
   
              <!-- END main table --> 
  @@ -229,9 +229,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.16      +5 -3      logging-log4j/docs/contributors.html
  
  Index: contributors.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/contributors.html,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- contributors.html	3 Jan 2005 15:26:56 -0000	1.15
  +++ contributors.html	10 May 2005 15:23:01 -0000	1.16
  @@ -206,7 +206,7 @@
                
                   <!-- FOOTER -->
                 <div align="center"><font color="#525D76" size="-1"><em>
  -                 Copyright &#169; 1999-2004, Apache Software Foundation
  +                 Copyright &#169; 1999-2005, Apache Software Foundation
                  </em></font></div>
   
              <!-- END main table --> 
  @@ -221,9 +221,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.36      +5 -3      logging-log4j/docs/documentation.html
  
  Index: documentation.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/documentation.html,v
  retrieving revision 1.35
  retrieving revision 1.36
  diff -u -r1.35 -r1.36
  --- documentation.html	3 Jan 2005 15:26:56 -0000	1.35
  +++ documentation.html	10 May 2005 15:23:01 -0000	1.36
  @@ -215,7 +215,7 @@
                
                   <!-- FOOTER -->
                 <div align="center"><font color="#525D76" size="-1"><em>
  -                 Copyright &#169; 1999-2004, Apache Software Foundation
  +                 Copyright &#169; 1999-2005, Apache Software Foundation
                  </em></font></div>
   
              <!-- END main table --> 
  @@ -230,9 +230,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.60      +35 -28    logging-log4j/docs/download.html
  
  Index: download.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/download.html,v
  retrieving revision 1.59
  retrieving revision 1.60
  diff -u -r1.59 -r1.60
  --- download.html	3 Jan 2005 15:26:56 -0000	1.59
  +++ download.html	10 May 2005 15:23:01 -0000	1.60
  @@ -74,6 +74,8 @@
             future versions may bring further radical changes, and all
             the usual caveats apply.
             </p>
  +                                                <h2>Chainsaw v2 (NEW!)</h2>
  +                                                <p><a href="chainsaw.html">Chainsaw</a> is GUI-based log viewer from the log4j subproject.</p>
                                                           <h3>Earlier Releases</strong></h3>
                                       <p>We also maintain <a href="earlier.html">earlier
   	      versions of log4j</a> for download, intended for the
  @@ -84,16 +86,6 @@
                                       <dl>
   
   	<!-- ============================================================================== -->
  -	
  -	<dt><a href="chainsaw.html"><b>Chainsaw v2 (NEW!)</b></a></dt>
  -
  -	<dd>A new and improved version of the venerable Chainsaw
  -	utility, now being written by the log4j development team is
  -	getting closer to release.  You can see screen shots of it and
  -	install it and run over <A href="chainsaw.html">here</A>
  -	</dd>
  -
  -	<!-- ============================================================================== -->
   	<dt><a href="http://minaret.biz/tips/datedFileAppender.html"><b>DatedFileAppender</b></a></dt>
   
   	<dd><code>DatedFileAppender</code> works in the same manner as
  @@ -126,6 +118,19 @@
   	  this JDBCAppender more suitable then the one that ships with
   	  log4j 1.2. 
   	</dd>
  +	
  +	<!-- ============================================================================== -->
  +
  +
  +	<dt><a href="http://jakarta.apache.org/commons/logging/">
  +	    <b>Jakarta Commons Logging (JCL)</b></a>
  +	</dt>
  +
  +	<dd>The Jakarta Commons Logging package is an ultra-thin bridge between different logging libraries. 
  +	The Logging API may be used to remove compile-time and run-time dependencies 
  +	on any particular logging package.
  +	</dd>
  +
   
          <!-- ============================================================================== -->
   
  @@ -164,22 +169,8 @@
   	logging.
           </dd>
   
  -	<!-- ============================================================================== -->	
  -	
  -	<dt><a href="http://cvs.apache.org/viewcvs/jakarta-log4j/log4jMini/"><b>log4j<em>ME</em></b></a></dt>
   
  -	<dd>Log4j<em>ME</em>, or log4j MiniEdition, is based on the
  -	same code as log4j. However, as the name indicates the
  -	mini-edition is much smaller. It offers the same client
  -	interface such that code compiled for log4jME is 100%
  -	compatible with log4j standard edition. You can choose to
  -	upgrade to log4j standard edition at any time by replacing
  -	<em>log4jME.jar</em> with <em>log4j.jar</em> in your
  -	classpath. At this time, log4jME is only available through
  -	CVS.
  -	</dd>
  -	
  -       <!-- ============================================================================== -->	
  +    <!-- ============================================================================== -->	
   	
   	<dt><a href="http://www.openfuture.de/Log4Unit/"><b>log4<em>Unit</em></b></a></dt>
   
  @@ -222,6 +213,20 @@
   	configurable through this interface.
   	</dd>
   
  +
  +	<!-- ============================================================================== -->
  +
  +
  +	<dt><a href="http://www.slf4j.org">
  +	    <b>Simple Logging Facade for Java (SLF4J)</b></a>
  +	</dt>
  +
  +	<dd>The Simple Logging Facade for Java or (SLF4J) is intended to  serve as a simple facade for various 
  +	  logging APIs allowing to the  end-user to plug in the desired implementation at 
  +	  deployment time.  SLF4J is a continuation of the Universal and Generic Logging Interface 
  +	  (UGLI) effort of the log4j project.
  +	</dd>
  +
   	<!-- ============================================================================== -->
   
   
  @@ -386,7 +391,7 @@
                
                   <!-- FOOTER -->
                 <div align="center"><font color="#525D76" size="-1"><em>
  -                 Copyright &#169; 1999-2004, Apache Software Foundation
  +                 Copyright &#169; 1999-2005, Apache Software Foundation
                  </em></font></div>
   
              <!-- END main table --> 
  @@ -401,9 +406,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.27      +5 -3      logging-log4j/docs/earlier.html
  
  Index: earlier.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/earlier.html,v
  retrieving revision 1.26
  retrieving revision 1.27
  diff -u -r1.26 -r1.27
  --- earlier.html	3 Jan 2005 15:26:56 -0000	1.26
  +++ earlier.html	10 May 2005 15:23:01 -0000	1.27
  @@ -67,7 +67,7 @@
                
                   <!-- FOOTER -->
                 <div align="center"><font color="#525D76" size="-1"><em>
  -                 Copyright &#169; 1999-2004, Apache Software Foundation
  +                 Copyright &#169; 1999-2005, Apache Software Foundation
                  </em></font></div>
   
              <!-- END main table --> 
  @@ -82,9 +82,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.9       +4 -2      logging-log4j/docs/faq.html
  
  Index: faq.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/faq.html,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- faq.html	10 Feb 2005 13:06:36 -0000	1.8
  +++ faq.html	10 May 2005 15:23:01 -0000	1.9
  @@ -1099,9 +1099,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.30      +8 -6      logging-log4j/docs/history.html
  
  Index: history.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/history.html,v
  retrieving revision 1.29
  retrieving revision 1.30
  diff -u -r1.29 -r1.30
  --- history.html	3 Jan 2005 15:26:56 -0000	1.29
  +++ history.html	10 May 2005 15:23:01 -0000	1.30
  @@ -50,9 +50,9 @@
   		       
                                            <h1>Project history</strong></h1>
                                       <p>The <a href="HISTORY.txt"><b>project history</b></a> gives a
  -	brief summary of changes and additions. Users frequently
  -	report bugs that are solved in newer versions of log4j. Please
  -	have a look at the history file before asking for help.
  +      brief summary of changes and additions. Users frequently report
  +      bugs that are solved in newer versions of log4j. Please have a
  +      look at the history file before asking for help.
         </p>
                                                   <p>The project's official URL is <a href="http://logging.apache.org/log4j">http://logging.apache.org/log4j</a>.
         </p>
  @@ -84,7 +84,7 @@
                
                   <!-- FOOTER -->
                 <div align="center"><font color="#525D76" size="-1"><em>
  -                 Copyright &#169; 1999-2004, Apache Software Foundation
  +                 Copyright &#169; 1999-2005, Apache Software Foundation
                  </em></font></div>
   
              <!-- END main table --> 
  @@ -99,9 +99,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.29      +6 -5      logging-log4j/docs/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/index.html,v
  retrieving revision 1.28
  retrieving revision 1.29
  diff -u -r1.28 -r1.29
  --- index.html	3 Jan 2005 15:26:56 -0000	1.28
  +++ index.html	10 May 2005 15:23:01 -0000	1.29
  @@ -82,8 +82,7 @@
   	minimize the cost of logging.</p>
                                                   <p>The target of the log output can be a file, an
   	<code>OutputStream</code>, a <code>java.io.Writer</code>, a
  -	remote log4j server, a remote Unix Syslog daemon, or even a NT
  -	Event logger among many other output targets.</p>
  +	remote log4j server, a remote Unix Syslog daemon, or many other output targets.</p>
                                                   <p>On an AMD Duron clocked at 800Mhz running JDK 1.3.1, it costs
   	about 5 nanoseconds to determine if a logging statement should
   	be logged or not. Actual logging is also quite fast, ranging
  @@ -105,7 +104,7 @@
                
                   <!-- FOOTER -->
                 <div align="center"><font color="#525D76" size="-1"><em>
  -                 Copyright &#169; 1999-2004, Apache Software Foundation
  +                 Copyright &#169; 1999-2005, Apache Software Foundation
                  </em></font></div>
   
              <!-- END main table --> 
  @@ -120,9 +119,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.5       +5 -3      logging-log4j/docs/install-chainsaw.html
  
  Index: install-chainsaw.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/install-chainsaw.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- install-chainsaw.html	3 Jan 2005 15:26:56 -0000	1.4
  +++ install-chainsaw.html	10 May 2005 15:23:01 -0000	1.5
  @@ -57,7 +57,7 @@
                
                   <!-- FOOTER -->
                 <div align="center"><font color="#525D76" size="-1"><em>
  -                 Copyright &#169; 1999-2004, Apache Software Foundation
  +                 Copyright &#169; 1999-2005, Apache Software Foundation
                  </em></font></div>
   
              <!-- END main table --> 
  @@ -72,9 +72,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.15      +5 -3      logging-log4j/docs/plan.html
  
  Index: plan.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/plan.html,v
  retrieving revision 1.14
  retrieving revision 1.15
  diff -u -r1.14 -r1.15
  --- plan.html	3 Jan 2005 15:26:56 -0000	1.14
  +++ plan.html	10 May 2005 15:23:01 -0000	1.15
  @@ -290,7 +290,7 @@
                
                   <!-- FOOTER -->
                 <div align="center"><font color="#525D76" size="-1"><em>
  -                 Copyright &#169; 1999-2004, Apache Software Foundation
  +                 Copyright &#169; 1999-2005, Apache Software Foundation
                  </em></font></div>
   
              <!-- END main table --> 
  @@ -305,9 +305,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.7       +9 -152    logging-log4j/docs/ugli.html
  
  Index: ugli.html
  ===================================================================
  RCS file: /home/cvs/logging-log4j/docs/ugli.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- ugli.html	10 Feb 2005 13:06:36 -0000	1.6
  +++ ugli.html	10 May 2005 15:23:01 -0000	1.7
  @@ -24,7 +24,7 @@
               <link href="./css/site.css" rel="stylesheet" type="text/css"/>
                                      
   
  -            <title>Log4j project - Universal and Generic Logging Interface (UGLI) </title>
  +            <title>Log4j project - Universal and Generic Logging Interface (UGLI)</title>
           </head>
   
           <body bgcolor="#ffffff" text="#000000" link="#525D76">        
  @@ -49,160 +49,15 @@
                <hr noshade="" size="1"/>
   		       
                                          <h1>Universal and Generic Logging Interface (UGLI)</h1>
  -                                                      <p>The Universal and Generic Logging Interface or UGLI is
  -      intended to serve as a simple abstraction of various logging
  -      APIs allowing to plug in the desired implementation at
  -      deployment time. Note that log4j version 1.3 and later support
  -      UGLI directly. Log4j is implemented in terms of the UGLI
  -      interfaces.
  -      </p>
  -                                                      <h2>Typical usage pattern</h2>
  -                                                      <pre class="source">
  - 1: <b>import org.apache.ugli.ULogger;</b>
  - 2: <b>import org.apache.ugli.LoggerFactory;</b>
  - 3: 
  - 4: public class Wombat {
  - 5:  
  - 6:   <b>final ULogger logger = LoggerFactory.getLogger(Wombat.class);</b>
  - 7:   Integer t;
  - 8:   Integer oldT;
  - 9:
  -10:   public void setTemperature(Integer temparature) {
  -11:    
  -12:     oldT = t;        
  -13:     t = temperature;
  -14:
  -15:     <b>logger.debug("Temperature set to {}. Old temperature was {}.", t, oldT);</b>
  -16:
  -17:     if(temperature.intValue() &gt; 50) {
  -18:       <b>logger.info("Temperature has risen above 50 degrees".);</b>
  -19:     }
  -20:   }
  -21: }
  -      </pre>
  -                                                      <p>The example above illustrates the typical usage pattern for
  -      UGLI. Note the use of parameterized log messages on line 15. See
  -      the question <a href="http://logging.apache.org/log4j/docs/faq.html#2.3">
  -      "What is the fastest way of (not) logging?"</a> in the log4j
  -      FAQ for more details.
  -      </p>
  -                                                      <h2>Swapping implementations at deployment time</h2>
  -                                                      <p>UGLI currently supports four implementations, namely, NOP,
  -        Simple, JDK 1.4 logging and log4j. Log4j 1.3 ships with four
  -        jar files <em>ugli-nop.jar</em>, <em>ugli-simple.jar</em>,
  -        <em>ugli-jdk14.jar</em> and <em>log4j.jar</em>. Each of these
  -        jar files are hardwired <em>at compile-time</em> to use just one 
  -        implementation,  that is NOP, Simple, JDK 1.4 logging and log4j, 
  -        respectively.
  -        </p>
  -                                                      <p>Small applications where configuring log4j can be somewhat
  -        of an overkill can drop in <em>ugli-simple.jar</em> in place
  -        of <em>log4j.jar</em>. 
  -        </p>
  -                                                      <p>Authors of widely-distributed components and libraries may
  -        code against the UGLI interface in order to avoid imposing an
  -        logging API implementation on the end-user.  At deployment
  -        time, the end-user may choose the desired logging API
  -        implementation by inserting the corresponding jar file in her
  -        classpath. This stupid, simple but robust approach avoids many
  -        of the painful bugs associated with dynamic discovery
  -        processes. Life is too short to be spending it hunting down
  -        class loader problems.
  -        </p>
  -                                                      <h2>Simplicity</h2>
  -                                                      <p>The UGLI interfaces and their various adapters are
  -        extremely simple. Most developers familiar with the Java
  -        language should be able to read and fully understand the code
  -        in less than one hour. 
  -        </p>
  -                                                      <p>As noted earlier, UGLI does not rely on any classloader
  -        tricks. Every variant of <em>ugli-&lt;impl&gt;.jar</em> is
  -        statically hardwired (at compile time) to use one specific
  -        implementation. Thus, UGLI suffers none of the <a href="http://www.qos.ch/logging/classloader.jsp">class loader
  -        problems observed when using JCL</a>.</p>
  -                                                      <p>We hope that simplicity of the UGLI interfaces and the
  -        deployment model will make it easy for developers of other
  -        logging APIs to conform to the UGLI model.
  -        </p>
  -                                                      <h2>Built-in support in log4j</h2>
  -                                                      <p>The <code>Logger</code> class in log4j directly implements
  -        UGLI's <code>ULogger</code> interface. Moreover, log4j makes
  -        extensive use of UGLI internally.
  -        </p>
  -                                                      <p>Log4j's built-in support for UGLI means that the adapter
  -        for log4j does not need to wrap log4j objects in order to make
  -        them conform to UGLI's <code>ULogger</code> interface. A log4j
  -        <code>Logger</code> <em>is</em> a <code>ULogger</code>. Thus,
  -        using UGLI in conjunction with log4j involves strictly zero
  -        memory overhead and near-zero computational overhead. The
  -        computational overhead is so small as to be unobservable.
  -        </p>
  -                                                      <h2>Where can I get UGLI?</h2>
  -                                                      <p>UGLI ships with log4j version 1.3alpha-6 and later.</p>
  -                                                      <h2>Summary</h2>
  -                                                      <table class="ls" cellspacing="4" cellpadding="4">
  -          <tr>
  -            <th align="left">Advantage</th>
  -            <th align="left">Description</th>
  -          </tr>
  -
  -          <tr>
  -            <td>Fail-safe operation</td>
  -            <td>Assuming the appropriate jar file is available on the
  -            classpath, under no circumstances will UGLI cause your
  -            application to fail. This is because no UGLI class loaded
  -            in memory will <em>ever</em> throw an exception.
  -
  -            <p>Contrast this with
  -            <code>LogConfigurationException</code> thrown by
  -            commons-logging which will cause your otherwise
  -            functioning application to fail. Commons-logging will
  -            throw a <code>LogConfigurationException</code> in case the
  -            <a href="http://jakarta.apache.org/commons/logging/api/org/apache/commons/logging/Log.html">Log</a>
  -            interface and its dynamically discovered implementation
  -            are loaded by different class loaders.
  -            </p>
  -            </td>
  -          </tr>
  -
  -          <tr>
  -            <td>Swappable logging API implementations</td>
  -            <td>The desired logging API can be plugged in at
  -            deployment time by inserting the appropriate jar file on
  -            the classpath.
  -            </td>
  -          </tr>
  -
  -          <tr>
  -            <td>Adapter implementations for the most popular APIs
  -            </td>
  -
  -            <td>UGLI supports the most popular logging APIs, namely
  -            log4j, JDK 1.4 logging, Simple logging and NOP.
  -            </td>
  -          </tr>
  -
  -          <tr>
  -            <td>Support for parameterized log messages</td>
  -
  -            <td>All UGLI adapters support parameterized log messages.</td>
  -          </tr>
  -
  -          <tr>
  -            <td>Built-in support in log4j</td>
  -
  -            <td>Log4j's built-in support for UGLI directly translates
  -            into smaller memory footprint and better CPU efficiency.
  -            </td>
  -          </tr>
  -        </table>
  +                                                      <p>The Universal and Generic Logging Interface effort has been
  +      renamed as SLF4J and assumed by <a href="http://www.slf4j.org">slf4j.org</a>.</p>
                             
               
     
  -                                                                                                                                        <hr/>
  +                            <hr/>
   
     
  -                                                                                                                                                                                                                                                                
  +                                        
   
                
                   <!-- FOOTER -->
  @@ -222,9 +77,11 @@
     </div>
                 	 <div class="menu_item">        <a href="./documentation.html">Documentation</a>
     </div>
  -              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
  +              	 <div class="menu_item">        <a href="./contactUs.html">Contact us</a>
  +  </div>
  +              	 <div class="menu_item">        <a href="./contributors.html">Contributors</a>
     </div>
  -              	 <div class="menu_item">        <a href="./ugli.html">UGLI</a>
  +              	 <div class="menu_item">        <a href="./chainsaw.html">Chainsaw</a>
     </div>
                 	 <div class="menu_item">        <a href="./history.html">History</a>
     </div>
  
  
  
  1.82      +48 -20    logging-log4j/src/xdocs/download.xml
  
  Index: download.xml
  ===================================================================
  RCS file: /home/cvs/logging-log4j/src/xdocs/download.xml,v
  retrieving revision 1.81
  retrieving revision 1.82
  diff -u -r1.81 -r1.82
  --- download.xml	29 Apr 2005 17:39:41 -0000	1.81
  +++ download.xml	10 May 2005 15:23:02 -0000	1.82
  @@ -8,7 +8,7 @@
   
         <body>
   	
  -      <section name="log4j version 1.2.10">
  +      <section name="log4j version 1.2.9">
   	<p>Log4j is <a
   	      href="http://logging.apache.org/site/binindex.cgi"><b>available
   	      for download</b></a> from a number of mirrors. Please
  @@ -16,11 +16,9 @@
   	      bandwidth.
   	  </p>
   	  
  -	  <p>Log4j version 1.2.10 adds support for <a
  -	  href="http://www.slf4j.org">SLF4J</a>. It also fixes several
  -	  relatively minor bugs. Version 1.2.9 is identical to version
  -	  1.2.8, except that several key methods have been deprecated
  -	  in preparation for version 1.3.0, the next major release of
  +	  <p>Log4j version 1.2.9, is identical to version 1.2.8,
  +	  except that several key methods have been deprecated in
  +	  preparation for version 1.3.0, the next major release of
   	  log4j. These changes are intended to enforce the rule that
   	  client code should never refer to the <code>Category</code>
   	  class directly, but use the <code>Logger</code> class
  @@ -37,11 +35,25 @@
             <h2>log4j version 1.3 (alpha)</h2>
             
             <p>An alpha version of log4j version 1.3 has been recently
  -          made available. As the alpha prefix indicates, this release
  -          is still being tested, future versions may bring further
  -          radical changes, and all the usual caveats apply.
  +          made available. It can be downloaded from the same As the
  +          alpha prefix indicates, this release is still being tested,
  +          future versions may bring further radical changes, and all
  +          the usual caveats apply.
             </p>
           
  +          
  +     <h2>Chainsaw v2 (NEW!)</h2>
  +     
  +     <p><a href="chainsaw.html">Chainsaw</a> is GUI-based log viewer from the log4j subproject.</p> 
  +	  <subsection name='Earlier Releases'>
  +	    <p>We also maintain <a
  +	      href="earlier.html">earlier
  +	      versions of log4j</a> for download, intended for the
  +	      curious paleontologist -- there seems to be quite a few
  +	      of them!
  +	    </p>
  +	  </subsection>
  +
   	</section>
   
   
  @@ -50,17 +62,6 @@
         <dl>
   
   	<!-- ============================================================================== -->
  -	
  -	<dt><a
  -	href="chainsaw.html"><b>Chainsaw v2 (NEW!)</b></a></dt>
  -
  -	<dd>A new and improved version of the venerable Chainsaw
  -	utility, now being written by the log4j development team is
  -	getting closer to release.  You can see screen shots of it and
  -	install it and run over <A href="chainsaw.html">here</A>
  -	</dd>
  -
  -	<!-- ============================================================================== -->
   	<dt><a href="http://minaret.biz/tips/datedFileAppender.html"><b>DatedFileAppender</b></a></dt>
   
   	<dd><code>DatedFileAppender</code> works in the same manner as
  @@ -94,6 +95,19 @@
   	  this JDBCAppender more suitable then the one that ships with
   	  log4j 1.2. 
   	</dd>
  +	
  +	<!-- ============================================================================== -->
  +
  +
  +	<dt><a href="http://jakarta.apache.org/commons/logging/">
  +	    <b>Jakarta Commons Logging (JCL)</b></a>
  +	</dt>
  +
  +	<dd>The Jakarta Commons Logging package is an ultra-thin bridge between different logging libraries. 
  +	The Logging API may be used to remove compile-time and run-time dependencies 
  +	on any particular logging package.
  +	</dd>
  +
   
          <!-- ============================================================================== -->
   
  @@ -179,6 +193,20 @@
   	configurable through this interface.
   	</dd>
   
  +
  +	<!-- ============================================================================== -->
  +
  +
  +	<dt><a href="http://www.slf4j.org">
  +	    <b>Simple Logging Facade for Java (SLF4J)</b></a>
  +	</dt>
  +
  +	<dd>The Simple Logging Facade for Java or (SLF4J) is intended to  serve as a simple facade for various 
  +	  logging APIs allowing to the  end-user to plug in the desired implementation at 
  +	  deployment time.  SLF4J is a continuation of the Universal and Generic Logging Interface 
  +	  (UGLI) effort of the log4j project.
  +	</dd>
  +
   	<!-- ============================================================================== -->
   
   
  
  
  
  1.14      +1 -2      logging-log4j/src/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/logging-log4j/src/xdocs/index.xml,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- index.xml	22 Nov 2004 18:22:11 -0000	1.13
  +++ index.xml	10 May 2005 15:23:02 -0000	1.14
  @@ -51,8 +51,7 @@
   
         <p>The target of the log output can be a file, an
   	<code>OutputStream</code>, a <code>java.io.Writer</code>, a
  -	remote log4j server, a remote Unix Syslog daemon, or even a NT
  -	Event logger among many other output targets.</p>
  +	remote log4j server, a remote Unix Syslog daemon, or many other output targets.</p>
   
         <p>On an AMD Duron clocked at 800Mhz running JDK 1.3.1, it costs
   	about 5 nanoseconds to determine if a logging statement should
  
  
  
  1.7       +3 -169    logging-log4j/src/xdocs/ugli.xml
  
  Index: ugli.xml
  ===================================================================
  RCS file: /home/cvs/logging-log4j/src/xdocs/ugli.xml,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- ugli.xml	10 Feb 2005 13:06:36 -0000	1.6
  +++ ugli.xml	10 May 2005 15:23:02 -0000	1.7
  @@ -3,181 +3,15 @@
   
     <properties>
       <author>Ceki Gulcu</author>
  -    <title>Universal and Generic Logging Interface (UGLI) </title>
  +    <title>Universal and Generic Logging Interface (UGLI)</title>
     </properties>
   
     <body>
   
       <h1>Universal and Generic Logging Interface (UGLI)</h1>
   
  -      <p>The Universal and Generic Logging Interface or UGLI is
  -      intended to serve as a simple abstraction of various logging
  -      APIs allowing to plug in the desired implementation at
  -      deployment time. Note that log4j version 1.3 and later support
  -      UGLI directly. Log4j is implemented in terms of the UGLI
  -      interfaces.
  -      </p>
  -
  -      <h2>Typical usage pattern</h2>
  -
  -      <pre class="source">
  - 1: <b>import org.apache.ugli.ULogger;</b>
  - 2: <b>import org.apache.ugli.LoggerFactory;</b>
  - 3: 
  - 4: public class Wombat {
  - 5:  
  - 6:   <b>final ULogger logger = LoggerFactory.getLogger(Wombat.class);</b>
  - 7:   Integer t;
  - 8:   Integer oldT;
  - 9:
  -10:   public void setTemperature(Integer temparature) {
  -11:    
  -12:     oldT = t;        
  -13:     t = temperature;
  -14:
  -15:     <b>logger.debug("Temperature set to {}. Old temperature was {}.", t, oldT);</b>
  -16:
  -17:     if(temperature.intValue() > 50) {
  -18:       <b>logger.info("Temperature has risen above 50 degrees".);</b>
  -19:     }
  -20:   }
  -21: }
  -      </pre>
  -      
  -      <p>The example above illustrates the typical usage pattern for
  -      UGLI. Note the use of parameterized log messages on line 15. See
  -      the question <a
  -      href="http://logging.apache.org/log4j/docs/faq.html#2.3">
  -      "What is the fastest way of (not) logging?"</a> in the log4j
  -      FAQ for more details.
  -      </p>
  -
  -      <h2>Swapping implementations at deployment time</h2>
  -
  -        <p>UGLI currently supports four implementations, namely, NOP,
  -        Simple, JDK 1.4 logging and log4j. Log4j 1.3 ships with four
  -        jar files <em>ugli-nop.jar</em>, <em>ugli-simple.jar</em>,
  -        <em>ugli-jdk14.jar</em> and <em>log4j.jar</em>. Each of these
  -        jar files are hardwired <em>at compile-time</em> to use just one 
  -        implementation,  that is NOP, Simple, JDK 1.4 logging and log4j, 
  -        respectively.
  -        </p>
  -
  -        <p>Small applications where configuring log4j can be somewhat
  -        of an overkill can drop in <em>ugli-simple.jar</em> in place
  -        of <em>log4j.jar</em>. 
  -        </p>
  -
  -        <p>Authors of widely-distributed components and libraries may
  -        code against the UGLI interface in order to avoid imposing an
  -        logging API implementation on the end-user.  At deployment
  -        time, the end-user may choose the desired logging API
  -        implementation by inserting the corresponding jar file in her
  -        classpath. This stupid, simple but robust approach avoids many
  -        of the painful bugs associated with dynamic discovery
  -        processes. Life is too short to be spending it hunting down
  -        class loader problems.
  -        </p>
  -     
  -        <h2>Simplicity</h2>
  -
  -        <p>The UGLI interfaces and their various adapters are
  -        extremely simple. Most developers familiar with the Java
  -        language should be able to read and fully understand the code
  -        in less than one hour. 
  -        </p>           
  -
  -        <p>As noted earlier, UGLI does not rely on any classloader
  -        tricks. Every variant of <em>ugli-&lt;impl&gt;.jar</em> is
  -        statically hardwired (at compile time) to use one specific
  -        implementation. Thus, UGLI suffers from none of the <a
  -        href="http://www.qos.ch/logging/classloader.jsp">class loader
  -        problems observed when using JCL</a>.</p>
  -        
  -        <p>We hope that simplicity of the UGLI interfaces and the
  -        deployment model will make it easy for developers of other
  -        logging APIs to conform to the UGLI model.
  -        </p>
  -
  -        <h2>Built-in support in log4j</h2>
  -
  -        <p>The <code>Logger</code> class in log4j directly implements
  -        UGLI's <code>ULogger</code> interface. Moreover, log4j makes
  -        extensive use of UGLI internally.
  -        </p>
  -        
  -        <p>Log4j's built-in support for UGLI means that the adapter
  -        for log4j does not need to wrap log4j objects in order to make
  -        them conform to UGLI's <code>ULogger</code> interface. A log4j
  -        <code>Logger</code> <em>is</em> a <code>ULogger</code>. Thus,
  -        using UGLI in conjunction with log4j involves strictly zero
  -        memory overhead and near-zero computational overhead. The
  -        computational overhead is so small as to be unobservable.
  -        </p>
  -
  -        <h2>Where can I get UGLI?</h2>
  -
  -        <p>UGLI ships with log4j version 1.3alpha-6 and later.</p>
  -        
  -        <h2>Summary</h2>
  -
  -        <table class="ls" cellspacing="4" cellpadding="4">
  -          <tr>
  -            <th align="left">Advantage</th>
  -            <th align="left">Description</th>
  -          </tr>
  -
  -          <tr>
  -            <td>Fail-safe operation</td>
  -            <td>Assuming the appropriate jar file is available on the
  -            classpath, under no circumstances will UGLI cause your
  -            application to fail. This is because no UGLI class loaded
  -            in memory will <em>ever</em> throw an exception.
  -
  -            <p>Contrast this with
  -            <code>LogConfigurationException</code> thrown by
  -            commons-logging which will cause your otherwise
  -            functioning application to fail. Commons-logging will
  -            throw a <code>LogConfigurationException</code> in case the
  -            <a
  -            href="http://jakarta.apache.org/commons/logging/api/org/apache/commons/logging/Log.html">Log</a>
  -            interface and its dynamically discovered implementation
  -            are loaded by different class loaders.
  -            </p>
  -            </td>
  -          </tr>
  -
  -          <tr>
  -            <td>Swappable logging API implementations</td>
  -            <td>The desired logging API can be plugged in at
  -            deployment time by inserting the appropriate jar file on
  -            the classpath.
  -            </td>
  -          </tr>
  -
  -          <tr>
  -            <td>Adapter implementations for the most popular APIs
  -            </td>
  -
  -            <td>UGLI supports the most popular logging APIs, namely
  -            log4j, JDK 1.4 logging, Simple logging and NOP.
  -            </td>
  -          </tr>
  -
  -          <tr>
  -            <td>Support for parameterized log messages</td>
  -
  -            <td>All UGLI adapters support parameterized log messages.</td>
  -          </tr>
  -
  -          <tr>
  -            <td>Built-in support in log4j</td>
  -
  -            <td>Log4j's built-in support for UGLI directly translates
  -            into smaller memory footprint and better CPU efficiency.
  -            </td>
  -          </tr>
  -        </table>
  +      <p>The Universal and Generic Logging Interface effort has been
  +      renamed as SLF4J and assumed by <a href="http://www.slf4j.org">slf4j.org</a>.</p>
           
     </body>  
   
  
  
  
  1.24      +0 -4      logging-log4j/src/xdocs/stylesheets/project.xml
  
  Index: project.xml
  ===================================================================
  RCS file: /home/cvs/logging-log4j/src/xdocs/stylesheets/project.xml,v
  retrieving revision 1.23
  retrieving revision 1.24
  diff -u -r1.23 -r1.24
  --- project.xml	29 Apr 2005 17:39:41 -0000	1.23
  +++ project.xml	10 May 2005 15:23:02 -0000	1.24
  @@ -24,10 +24,6 @@
         <item name="Bug Reporting" href="http://logging.apache.org/site/bugreport.html"/>
       </menu>
   
  -    <menu name="Related Projects">
  -      <item name="SLF4J"          href="http://www.slf4j.org"/>
  -    </menu>
  -
       <menu name="Translations">
         <item name="Korean" href="http://jakarta.apache-korea.org/log4j/index.html"/>
         <item name="Japanese" href="http://www.ingrid.org/jajakarta/log4j/"/>
  
  
  

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


Mime
View raw message