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 © 1999-2004, Apache Software Foundation
+ Copyright © 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 © 1999-2004, Apache Software Foundation
+ Copyright © 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 © 1999-2004, Apache Software Foundation
+ Copyright © 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 © 1999-2004, Apache Software Foundation
+ Copyright © 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 © 1999-2004, Apache Software Foundation
+ Copyright © 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 © 1999-2004, Apache Software Foundation
+ Copyright © 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 © 1999-2004, Apache Software Foundation
+ Copyright © 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 © 1999-2004, Apache Software Foundation
+ Copyright © 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 © 1999-2004, Apache Software Foundation
+ Copyright © 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 © 1999-2004, Apache Software Foundation
+ Copyright © 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() > 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-<impl>.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-<impl>.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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
