You are viewing a plain text version of this content. The canonical link for it is here.
Posted to log4j-cvs@jakarta.apache.org by ce...@apache.org on 2002/04/02 11:07:35 UTC
cvs commit: jakarta-log4j/src/xdocs contributors.xml history.xml plan.xml
ceki 02/04/02 01:07:35
Modified: docs HISTORY manual.html plan.html
src/xdocs contributors.xml history.xml plan.xml
Log:
Added new items to the "plan".
Revision Changes Path
1.87 +6 -2 jakarta-log4j/docs/HISTORY
Index: HISTORY
===================================================================
RCS file: /home/cvs/jakarta-log4j/docs/HISTORY,v
retrieving revision 1.86
retrieving revision 1.87
diff -u -r1.86 -r1.87
--- HISTORY 25 Mar 2002 22:37:21 -0000 1.86
+++ HISTORY 2 Apr 2002 09:07:34 -0000 1.87
@@ -11,8 +11,9 @@
(beta5)
- - In the Category class, the .getChainedPriority method has been
- replaced with getEffectiveLevel method. [*]
+ - Added Oliver Burn's chainsaw tool to the core log4j
+ distribution. Visualisation and dynamic filtering of log events is
+ bound to be a very important area of activity in the future. [*]
- Added the org.apache.log4j.jdbc.JDBCAppender which as the name
indicates sends events to a database using the JDBC API. Thanks to
@@ -21,6 +22,9 @@
- Added SocketHubAppender class as contributed by Mark Womack. This
appender sends LoggingEvent objects to a set of remote a log
servers. [*]
+
+ - In the Category class, the getChainedPriority method has been
+ replaced with getEffectiveLevel method. [*]
(beta4)
1.29 +13 -15 jakarta-log4j/docs/manual.html
Index: manual.html
===================================================================
RCS file: /home/cvs/jakarta-log4j/docs/manual.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- manual.html 11 Feb 2002 22:19:27 -0000 1.28
+++ manual.html 2 Apr 2002 09:07:34 -0000 1.29
@@ -10,7 +10,7 @@
<font size="+2">Ceki Gülcü</font>
<br><br>
- February 2002
+ March 2002
<br>
</center>
@@ -41,7 +41,7 @@
own tracing API. This was in early 1996. After countless enhancements,
several incarnations and much work that API has evolved to become
log4j, a popular logging package for Java. The package is distributed
-under the <a href=../LICENSE.APL>Apache Software License</a>, a
+under the <a href=../LICENSE.txt>Apache Software License</a>, a
fully-fledged open source license certified by the <a
href="http://www.opensource.org">open source</a> initiative. The
latest log4j version, including full-source code, class files and
@@ -80,11 +80,11 @@
debugging sessions are transient.
</pre>
-<p>Logging does have its drawbacks. It can slow down an application. If
-too verbose, it can cause scrolling blindness. To alleviate these
-concerns, log4j is designed to be fast and flexible. Since logging is
-rarely the main focus of an application, log4j API strives to be
-simple to understand and to use.
+<p>Logging does have its drawbacks. It can slow down an
+application. If too verbose, it can cause scrolling blindness. To
+alleviate these concerns, log4j is designed to be reliable, fast and
+extensible. Since logging is rarely the main focus of an application,
+log4j API strives to be simple to understand and to use.
<h2>Loggers, Appenders and Layouts</h2>
@@ -101,14 +101,12 @@
certain log statements while allowing others to print unhindered. This
capability assumes that the logging space, that is, the space of all
possible logging statements, is categorized according to some
-developer-chosen criteria.
-
-
-This observation had previously led us to choose <em>category</em> as
-the central concept of the package. However, since log4j version 1.2,
-Logger class has replaced the Category class. For those familiar with
-earlier versions of log4j, the logger class can be considered as a
-mere alias to the category class.
+developer-chosen criteria. This observation had previously led us to
+choose <em>category</em> as the central concept of the
+package. However, since log4j version 1.2, <code>Logger</code> class
+has replaced the <code>Category</code> class. For those familiar with
+earlier versions of log4j, the <code>Logger</code> class can be
+considered as a mere alias to the <code>Category</code> class.
<p> Loggers are named entities. Logger names are case-sensitive and
they follow the hierarchical naming rule:
1.8 +769 -152 jakarta-log4j/docs/plan.html
Index: plan.html
===================================================================
RCS file: /home/cvs/jakarta-log4j/docs/plan.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- plan.html 11 Jan 2002 16:17:49 -0000 1.7
+++ plan.html 2 Apr 2002 09:07:34 -0000 1.8
@@ -1,181 +1,798 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<HTML>
-<HEAD>
- <TITLE>Release plan for log4j 1.2</TITLE>
-</HEAD>
-
- <BODY>
-
- <center>
- <h2>Workplan for log4j 1.2</h2>
- </center>
- <p>Here is my proposed plan for the next major log4j release. As
- customary, there is no scheduled release date. It will be ready when
- it is ready. Your comments and suggestions are most welcome.</p>
-
- <p><TABLE border="1" cellpadding="3" cellspacing="2">
-
- <TR>
- <TH>Label</th>
- <TH>Comment</th>
- <TH>Volunteer</th>
- <TH>Status</th>
- </tr>
-
- <TR bgcolor="DDDDDD">
- <TD>More test cases</td>
-
- <TD>We need more automated test cases to catch bugs as early
- is possible.It is highly recommended to add a new test case
- with each new feature or component.
- </p>
- </td>
+<!-- Content Stylesheet for Site -->
- <TD>All committers</td>
- <td>ongoing effort</td>
+
+<!-- start the processing -->
+ <!-- ====================================================================== -->
+ <!-- Main Page Section -->
+ <!-- ====================================================================== -->
+ <html>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+
+ <meta name="author" value="Ceki Gulcu">
+ <meta name="email" value="ceki@apache.org">
+
+
+
+ <title>Log4j project - Release plan for log4j 1.2</title>
+ </head>
+
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+ <table border="0" width="100%" cellspacing="0">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td align="left">
+<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
+</td>
+<td align="right">
+<a href="http://jakarta.apache.org/"><img src="./images/logo.jpg" alt="The log4j project" border="0"/></a>
+</td>
+ </tr>
+ </table>
+ <table border="0" width="100%" cellspacing="4">
+ <tr><td colspan="2">
+ <hr noshade="" size="1"/>
+ </td></tr>
+
+ <tr>
+ <!-- LEFT SIDE NAVIGATION -->
+ <td width="20%" valign="top" nowrap="true">
+ <p><strong>Log4j Project</strong></p>
+ <ul>
+ <li> <a href="./index.html">Introduction</a>
+</li>
+ <li> <a href="./download.html">Download</a>
+</li>
+ <li> <a href="./documentation.html">Documentation</a>
+</li>
+ <li> <a href="./plan.html">Plan</a>
+</li>
+ <li> <a href="./contactUs.html">Contact us</a>
+</li>
+ <li> <a href="./contributors.html">Contributors</a>
+</li>
+ <li> <a href="./history.html">History</a>
+</li>
+ </ul>
+ <p><strong>Jakarta (parent project)</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/">Home page</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/news.html">News</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
+</li>
+ </ul>
+ <p><strong>Translations</strong></p>
+ <ul>
+ <li> <a href="http://www.ingrid.org/jajakarta/log4j/">Japanese</a>
+</li>
+ </ul>
+ </td>
+ <td width="80%" align="left" valign="top">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Plan? What plan?"><strong>Plan? What plan?</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>The following paragragh was adapted from the <a href="http://jakarta.apache.org/cactus/todo.html">Cactus
+ project's roadmap</a> with the author's permission.
+ </p>
+ <p>Our users keep inventing better ways and adding new
+ requirements. The downside is that our todo list keeps
+ growing. The upside is that there is plenty of work to go
+ around. If you are interested in participating, send an email
+ on the log4j-dev@ mailing list stating your interest. You'll
+ be promptly enrolled. We're always looking for help! Don't be
+ put off if in the "Volunteer" column already has a person
+ listed. Programming is fun, especially if it is done in a
+ group.
+ </p>
+ <p>
+
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Workplan for log4j 1.3"><strong>Workplan for log4j 1.3</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>With log4j 1.2 still in beta, the workplan for log4j 1.3 is
+ obviously not final. It is included here to give you an idea
+ of the future. The items are not listed in any particular
+ order.
+ </p>
+ <table>
+ <tr>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Label
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Comment
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Volunteer
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Status
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <b>test cases</b>
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ <p>Writing test cases is not the most sexy part of
+ software development but it is one of the most
+ important. Automated test cases allow us to catch bugs
+ as early is possible. It is strongly recommended to add
+ a new test case with each new feature or component.</p>
+
+ <p>Existing <em>Perl</em> language based test cases are
+ gradually being migrated to junit (all-Java)based test
+ cases. The new tests are placed under the
+ <code>tests/</code> directory. It should be thus
+ possible for participants in the project to understand
+ the stucture of our tests and add tests for their
+ components.
+ </p>
- </TR>
-
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ All committers
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ ongoing effort
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Extensible XML configuration files
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ <p>The DOMConfigurator is complex and not very
+ flexible. It can only deal with elements that the
+ developer knew about at compilation time. This has been
+ an important drawback in the design of several appenders
+ such as the the SMTPAppender and the
+ RollingFileAppenders and its variants. These appenders
+ need to delegate certain task to sub-components which
+ are configured separately.
+ </p>
- <TR >
- <TD>Removal of deprecated methods</td>
+ <p>The support for extensible configuration files will be
+ based on the code in commons-digester authored by Craig
+ McClanahan and Scott Sanders. They graciously granted
+ permission for the modification of their code and its
+ inclusion in log4j.</p>
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ceki
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ design board
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Log4j Domains
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ <p>This is a very powerful and innovative concept that
+ extends the notion of hierarchical loggers. It will also
+ allow dynamic logging with pin-point accuracy. It was
+ first suggested to me by Scott Stark of <a href="http://www.jboss.org">JBoss</a> fame.
+ </p>
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ceki
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ design board
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Multiple implementations of Logger
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ <p>Based on <code>RepositorySelectors</code> introduced in
+ log4j 1.2, the user will be able to replace the
+ <code>Logger</code> implementation. Several
+ implementations will be provided offering different
+ properties and functionality although none of the
+ implementations will add new public methods.
+ </p>
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ ?
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ vaporware
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Improvements to Chainsaw
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ <p>Visualisation and dynamic filtering of logging event is
+ bound to be a very important area of activity in the
+ future. A number of important improvements to chainsaw
+ have been suggested.
+ </p>
- <TD>Deprecated <code>setOption</code> and <code>getOption</code>
- method should be removed.</td>
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Oliver Burn
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ under discusison
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Custom conversion characters in PatternLayout
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Users often want to add new conversions characters or
+ override the existing ones. This should be made easy using
+ new configuration directives. This feature would use the
+ extensions to XML configuration language mentioed
+ above.
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ ?
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ not started
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Overture to other programming languages
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ It is higly desriable to allow log4j ports in other languages
+ to access log4j services in a language independent way.
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ ?
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ not started
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Strategy based rollovers
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ <p>Contrary to our own DailyRollingFileAppender, Avalon's
+ logkit has a nice and clean implementation for rolling
+ files. See the
+ <code>org.apache.log.output.io.rotate</code> package for
+ exact details.
+ </p>
+
+ <p>Their implementation is based on strategies which are
+ sub-components of appender. We will be able to configure
+ such sub-components with the new XML configuration
+ scripts.
+ </p>
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Kevin Steppe
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ not started
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Redesign of configure and watch architecture in
+ configurators
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ This is a very useful feature and the current architecture is not very good.
+
+ <p>Contributions have been received by Mark Womack and others.</p>
+
+ <p>See
+ <pre>
+ http://www.mail-archive.com/log4j-dev@jakarta.apache.org/msg01390.html
+ http://www.mail-archive.com/log4j-user@jakarta.apache.org/msg00666.html
+ http://marc.theaimsgroup.com/?t=101010070500002&r=1&w=2
+ </pre>
+ </p>
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Mark Womack
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ initial implementation
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Performance improvements to LoggingEvent serialization
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ <p>Ole Dalgaard has shown that by implementing the
+ java.io.Externalizable interface instead of
+ java.io.Serializable in the LoggingEvent class, the
+ speed of serialiazation is increased by a factor of 4 or
+ more.
+ </p>
+
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ole Dalgaard?
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ initial implementation
+ </font>
+</td>
+ </tr>
+ </table>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Workplan for log4j 1.2"><strong>Workplan for log4j 1.2</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ Here is workplan for the 1.2 release. As always, there is no
+ scheduled release date. The lack of schedule suprises and
+ disturbs some people. Writing good software, like good
+ cooking, takes time. If we make you wait, it is to create a
+ better and more reliable product.
+ </p>
+ <table>
+ <tr>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Label
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Comment
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Volunteer
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Status
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ More test cases
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ We need more automated test cases to catch bugs as early
+ is possible.It is highly recommended to add a new test case
+ with each new feature or component.
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ All committers
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ ongoing effort
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Removal of deprecated methods
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Deprecated <code>setOption</code> and <code>getOption</code>
+ methods in appender and layouts should be removed.
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ceki
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ done
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ JDBCAppender
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ <p>We currently have two competing JDBCAppenders: one by
+ Thomas Fenner and the other by Kevin Steppe.</p>
- <TD>Ceki</td>
- <td>done</td>
- <TR bgcolor="DDDDDD">
- <TD>JDBCAppender</td>
+ <p>Kevin Steppe stood up and did it.</p>
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Kevin Steppe
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ not started
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Log4j in applets
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ In order to minimize network traffic, the size of log4j-core.jar
+ needs to be reduced to at most 50KB.
+
+ <p>Log4jME has been released. It's less than 20KB.</p>
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ceki
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ done
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Improved documentation
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Log4j documentation needs to be enhanced with configuration
+ examples and much more hand-holding.
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ceki
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ ongoing effort
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Mapped Diagnostic Contexts
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Mapped Diagnostic Contexts are similar to the NDC
+ except that the MDC is a string to string map instead of
+ a stack that the user sets when entering a special
+ context. The <code>PatternLayout</code> has to be
+ enhanced to support this by extending the %x pattern to
+ accept an argument. Here is an example:
+
+ <pre>
+ ConversionPattern=3D%d %p %c %x{server} %x{host} - %m%n
+ </pre>
+
+ User code:
+ <pre>
+ {
+ MDC.put("server", "totoServer");
+ MDC.put("host", "someHost");
- <TD>We currently have two competing JDBCAppenders: one by
- Thomas Fenner and the other by Kevin Steppe. We should try
- to get both authors to collaborate.
-
- <p>We must be careful not to dismiss an implementation
- without proper testing and due study. We should include at
- least of one of these implemetation in the standard log4j
- distribution. </p>
- </td>
-
- <TD>?</td>
-
- <td>not started</td>
- </tr>
-
- <TR>
- <TD>Log4j in applets</td>
+ logger.debug("Hello");
- <TD>In order to minimize network traffic, the size of log4j-core.jar
- needs to be reduced to at most 50KB.
+ }
+</pre>
+ will print:
+ <pre>2000-01-24 10:00:00,000 DEBUG totoServer someHost - Hello</pre>
+
+ <p>To make MDCs truly user friendly
+ <code>ThreadLocal</code> variables are required. This
+ will allow the MDC to be inherited by child
+ threads. <code>ThreadLocal</code> are only supported
+ under JDK 1.2 and above. In JDK 1.1, the MDC will not
+ work but won't harm the user application either.</p>
- <p>Log4jME has been released. It's less than 20KB.</p>
- </td>
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ceki
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ done
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Enhanced variable substitution support in DOMConfigurator
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ceki
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ done
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ FallbackErrorHandler
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ The FallbackErrorHandler implements the ErrorHandler
+ interface such that a secondary appender may be
+ specified. This secondary appender takes over if the primary
+ appender fails for whatever reason.
+
+ <p>The DOMConfigurator needs to be extended to support the
+ FallbackErrorHandler</p>
- <td>Ceki</td>
- <TD>done</td>
- </tr>
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ceki
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ implemented, requires further testing
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ensure backward compatibility of LoggingEvent
+ objects
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ To avoid deployment problems we must ensure that
+ LoggingEvent objects are compatible between 1.2 and 1.1.3.
+
+ <p>Robert Bushman has proposed a very innovative way for
+ solving this problem. See <a href="http://www.mail-archive.com/log4j-dev@jakarta.apache.org/msg01397.html">
+ http://www.mail-archive.com/log4j-dev@jakarta.apache.org/msg01397.html</a>
+ for further details.
+ </p>
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Ceki
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ implemented, manually tested, requires automated test cases
+ </font>
+</td>
+ </tr>
+ </table>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ </td>
+ </tr>
+
+ <!-- FOOTER -->
+ <tr><td colspan="2">
+ <hr noshade="" size="1"/>
+ </td></tr>
+ <tr><td colspan="2">
+ <div align="center"><font color="#525D76" size="-1"><em>
+ Copyright © 1999-2002, Apache Software Foundation
+ </em></font></div>
+ </td></tr>
+ </table>
+ </body>
+ </html>
+<!-- end the processing -->
+
- <TR bgcolor="DDDDDD">
- <TD>Improved documentation</td>
- <TD>Log4j documentation needs to be enhanced with configuration
- examples and much more hand-holding.</td>
- <TD>Ceki</td>
-
- <td>under discussion</td>
- </tr>
- <TR>
-
- <TD valign="top">Mapped Diagnostic Contexts</td>
- <TD>Mapped Diagnostic Contexts are similar to the NDC
- except that the MDC is a string to string map instead of
- a stack that the user sets when entering a special
- context. The <code>PatternLayout</code> has to be
- enhanced to support this by extending the %x pattern to
- accept an argument. Here is an example:
- <pre>
- ConversionPattern=3D%d %p %c %x{server} %x{host} - %m%n
- </pre>
- User code:
- <pre>
- {
- MDC.put("server", "totoServer");
- MDC.put("host", "someHost");
-
- cat.debug("Hello");
-
- }
- </pre>
- will print:
- <pre>2000-01-24 10:00:00,000 DEBUG totoServer someHost - Hello</pre>
-
- <p>To make MDCs truly user friendly <code>ThreadLocal</code> variables
- are required. This will allow the MDC to be inherited by child
- threads. <code>ThreadLocal</code> are only supported under JDK 1.2 and
- above. In JDK 1.1, the MDC will not work but won't harm the user
- application either.</p>
-
- <TD>Ceki</td>
- <td>done</td>
-
- </td>
-
- <TR bgcolor="DDDDDD">
- <TD>Enhanced variable substitution support in DOMConfigurator</td>
- <TD></td>
-
- <TD>Ceki</td>
- <td>done</td>
- </tr>
-
- <tr>
- <td>FallbackErrorHandler</td>
-
- <td>The FallbackErrorHandler implements the ErrorHandler
- interface such that a secondary appender may be
- specified. This secondary appender takes over if the primary
- appender fails for whatever reason.
- <p>The DOMConfigurator needs to be extended to support the
- FallbackErrorHandler</p>
-
- </td>
- <td>Ceki</td>
- <td>implemented, requires further testing</td>
- </tr>
- <tr bgcolor="DDDDDD">
- <td>Review of the configure and watch architecture in configurators</td>
- <td>This is a very useful feature and the current architecture is not very good.
- <p>Contributions have been received by Mark Womack and others.</p>
-
- <p>See
- <br>http://www.mail-archive.com/log4j-dev@jakarta.apache.org/msg01390.html
- <br>http://www.mail-archive.com/log4j-user@jakarta.apache.org/msg00666.html
- <br/>http://marc.theaimsgroup.com/?t=101010070500002&r=1&w=2
- </pre>
- </p>
- </td>
- <td>?</td>
- <td>not yet started</td>
- </tr>
-
-</TABLE>
-</BODY>
-</HTML>
\ No newline at end of file
1.7 +7 -3 jakarta-log4j/src/xdocs/contributors.xml
Index: contributors.xml
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/xdocs/contributors.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- contributors.xml 17 Jan 2002 18:11:33 -0000 1.6
+++ contributors.xml 2 Apr 2002 09:07:35 -0000 1.7
@@ -39,8 +39,11 @@
<li><b>Ceki Gülcü</b>
- <p>Ceki is the founder and current maintainer of the log4j
- project.
+ <p>Ceki is the founder the log4j project which still takes
+ much of his time. He enjoys writing software altough he is
+ discovering that it is far more difficult than it looks. He
+ is also slowly building an IT services company called <a
+ href="http://qos.ch">qos.ch</a>.
</p>
</li>
@@ -72,7 +75,8 @@
<p>Chris is the author NTEventLogAppender. In around 1832,
he ported our previous GNU-make build system to at the time
- unknown but promising jakarta-ant.
+ unknown but promising <a
+ href="jakarta.apache.org/ant/">jakarta-ant</a>.
</p>
</li>
1.11 +37 -31 jakarta-log4j/src/xdocs/history.xml
Index: history.xml
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/xdocs/history.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- history.xml 11 Feb 2002 16:14:34 -0000 1.10
+++ history.xml 2 Apr 2002 09:07:35 -0000 1.11
@@ -8,37 +8,43 @@
<body>
-<section name="Project history">
+ <section name="Project history">
-<p>The <a href="HISTORY"><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.</p>
-
-<p>The project's official URL is <a
-href="http://jakarta.apache.org/log4j">http://jakarta.apache.org/log4j</a>.</p>
-
-<p>Many thanks to all the log4j users who keep sending us input and
-sometimes even praise for our collective effort. The first ancestor of
-log4j was written for the E.U. sponsored <a
-href="http://www.semper.org">SEMPER</a> project. N. Asokan, Ceki
-Gülcü and Michael Steiner came up with the idea of
-hierarchical categories back in 1996. Their idea is still at the heart
-of log4j. The package was considerably improved over the years at the
-<a href="http://www.zurich.ibm.com"><b>IBM Zurich Research
-Laboratory</b></a>. However, log4j is no longer associated nor
-supported by IBM.</p>
-
-<p>Special thanks to M. Niksch from ZRL for his assistance on many
-large and small matters. The Apache members, Pier Fumagalli and Sam
-Ruby in particular, have been extremely helpful in easing the move to
-Apache.</p>
-
-<p>The log4j logo was designed and kindly donated by <a
-href="http://www.cyberlab.ch"><IMG src="images/cyberlab15.gif"
-ALT="Cyberlab S.A." ALIGN="abscenter"/></a> of Switzerland.</p>
-</section>
+ <p>The <a href="HISTORY"><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.
+ </p>
+
+ <p>The project's official URL is <a
+ href="http://jakarta.apache.org/log4j">http://jakarta.apache.org/log4j</a>.
+ </p>
+
+ <p>Many thanks to all the log4j users who keep sending us input
+ and sometimes even praise for our collective effort. The first
+ ancestor of log4j was written for the E.U. sponsored <a
+ href="http://www.semper.org">SEMPER</a> project. N. Asokan,
+ Ceki Gülcü and Michael Steiner came up with the idea
+ of hierarchical loggers back in 1996. Their idea is still
+ at the heart of log4j. The package was considerably improved
+ over the years at the <a
+ href="http://www.zurich.ibm.com"><b>IBM Zurich Research
+ Laboratory</b></a>. However, log4j is no longer associated nor
+ supported by IBM.
+ </p>
+
+ <p>Special thanks to M. Niksch from ZRL for his assistance on
+ many large and small matters. The Apache members, Pier
+ Fumagalli and Sam Ruby in particular, have been extremely
+ helpful in easing the move to Apache.
+ </p>
+
+ <p>The log4j logo was designed and kindly donated by <a
+ href="http://www.cyberlab.ch"><IMG
+ src="images/cyberlab15.gif" ALT="Cyberlab S.A."
+ ALIGN="abscenter"/></a> of Switzerland.
+ </p>
-</body>
+ </section>
+ </body>
</document>
-
1.4 +46 -13 jakarta-log4j/src/xdocs/plan.xml
Index: plan.xml
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/xdocs/plan.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- plan.xml 28 Mar 2002 11:27:47 -0000 1.3
+++ plan.xml 2 Apr 2002 09:07:35 -0000 1.4
@@ -12,7 +12,7 @@
<p>The following paragragh was adapted from the <a
href="http://jakarta.apache.org/cactus/todo.html">Cactus
- project's roadmap</a>. Permission to quote pending.
+ project's roadmap</a> with the author's permission.
</p>
<p>Our users keep inventing better ways and adding new
@@ -36,8 +36,10 @@
<section name="Workplan for log4j 1.3">
<p>With log4j 1.2 still in beta, the workplan for log4j 1.3 is
- obviously not final. It is included here to give you an idea of
- the future.</p>
+ obviously not final. It is included here to give you an idea
+ of the future. The items are not listed in any particular
+ order.
+ </p>
<table border="1" cellpadding="3" cellspacing="2">
@@ -82,8 +84,8 @@
an important drawback in the design of several appenders
such as the the SMTPAppender and the
RollingFileAppenders and its variants. These appenders
- need to delegate certain task to sub-components which we
- should be able to configure separately.
+ need to delegate certain task to sub-components which
+ are configured separately.
</p>
<p>The support for extensible configuration files will be
@@ -112,7 +114,7 @@
</tr>
<tr>
- <td>Multiple implementation of Logger</td>
+ <td>Multiple implementations of Logger</td>
<td>
<p>Based on <code>RepositorySelectors</code> introduced in
@@ -129,6 +131,43 @@
<td>vaporware</td>
</tr>
+ <tr>
+ <td>Improvements to Chainsaw</td>
+
+ <td>
+ <p>Visualisation and dynamic filtering of logging event is
+ bound to be a very important area of activity in the
+ future. A number of important improvements to chainsaw
+ have been suggested.
+ </p>
+
+ </td>
+ <td>Oliver Burn</td>
+ <td>under discusison</td>
+ </tr>
+
+ <tr>
+ <td>Custom conversion characters in PatternLayout</td>
+ <td>Users often want to add new conversions characters or
+ override the existing ones. This should be made easy using
+ new configuration directives. This feature would use the
+ extensions to XML configuration language mentioed
+ above.</td>
+
+ <td>?</td>
+ <td>not started</td>
+ </tr>
+
+ <tr>
+ <td>Overture to other programming languages</td>
+
+ <td>It is higly desriable to allow log4j ports in other languages
+ to access log4j services in a language independent way.
+ </td>
+
+ <td>?</td>
+ <td>not started</td>
+ </tr>
<tr>
<td>Strategy based rollovers</td>
@@ -147,7 +186,7 @@
scripts.
</p>
</td>
- <td>?</td>
+ <td>Kevin Steppe</td>
<td>not started</td>
</tr>
@@ -184,16 +223,10 @@
more.
</p>
- <p>Their implementation is based on strategies which are
- sub-components of appender. We will be able to configure
- such sub-components with the new XML configuration
- scripts.
- </p>
</td>
<td>Ole Dalgaard?</td>
<td>initial implementation</td>
</tr>
-
</table>
</section>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>