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 2001/06/19 09:24:38 UTC
cvs commit: jakarta-log4j/docs plan.html critique.html
ceki 01/06/19 00:24:37
Modified: docs critique.html
Added: docs plan.html
Log:
100 and counting.
Revision Changes Path
1.10 +110 -87 jakarta-log4j/docs/critique.html
Index: critique.html
===================================================================
RCS file: /home/cvs/jakarta-log4j/docs/critique.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- critique.html 2001/06/17 09:23:36 1.9
+++ critique.html 2001/06/19 07:24:33 1.10
@@ -11,7 +11,7 @@
<H1>JSR47 vs. log4j</H1>
<font size="+1">by Ceki Gülcü</font>
</CENTER>
-
+
<hr>
<p>I consider it quite distasteful to criticize other people's work,
especially in public. However, since the logging API included in JDK
@@ -271,11 +271,13 @@
million disabled logging requests will cost under a second in both
environments.
-<p>Having said that, logging statements should never be placed in
-tight loops, for example, before or after an element swap instruction
-in a sort algorithm. In common cases, the cost of parameter
-construction before invoking a logging statement will overwhelm any
-other performance consideration.
+<p>In a shipped binary, you can turn off logging entirely and both
+APIs will perform identically. Note that if one is not careful, the
+cost of parameter construction before invoking a disabled log
+statement will overwhelm any other performance consideration.
+Regardless of the API you decide to use, logging statements should
+never be placed in tight loops, for example, before or after an
+element swap instruction in a sort algorithm.
<p>In log4j, caller localization information is optional whereas in
JSR47 it is always extracted. Since the extraction of caller
@@ -296,114 +298,124 @@
<p><b>Please direct your polite and personalized request to <a
href="mailto:java-logging-input@eng.sun.com">java-logging-input@eng.sun.com</a>
-with a cc: to <a href="mailto:cgu@qos.ch">cgu@qos.ch</a>.</b>
+with <em>Bcc:</em> to <a href="mailto:cgu@qos.ch">cgu@qos.ch</a>.</b>
-<p>By the way, the address <code>java-logging-input@eng.sun.com</code>
-is not a mailing list for the JSR47 experts group. From what I hear,
-the mailing list address for JSR47 experts group is considered
-confidential information.
-
-<p>Below is a list of individuals who have written to Sun, with the
-vast majority pushing for the adoption of log4j. I am very grateful
-for their support. Some of these requests are quite detailed and
-insightful.
+<p>By the way, e-mail to <code>java-logging-input@eng.sun.com</code>
+does not go to the JSR47 experts group but is internal to Sun
+Microsystems. <em>The address of the JSR47 experts group mailing list
+is considered confidential information.</em> I do not know it myself.
+
+<p>In just five days one hundred individuals, including some from very
+large accounts, have written to Sun to express their concern; the vast
+majority pushing for the adoption of log4j. Their names and the
+content of their request are listed below. I am very grateful for
+their support. Some of these requests are quite detailed and
+insightful.
<p><UL>
-<li><p><a href="pub-support/AlexBlewitt.html">AlexBlewitt</a>
-<li><p><a href="pub-support/FrankBaxter.html">Frank Baxter</a>
-<li><p><a href="pub-support/EllisTeer.html">Ellis Teer</a>
-<li><p><a href="pub-support/BrentSprecher.html">Brent Sprecher</a>
-<li><p><a href="pub-support/JasonKitcat.html">Jason Kitcat</a>
-<li><p><a href="pub-support/AndyDePue.html">Andy DePue</a> and his <a href="pub-support/AndyDePue2.html">follow up</a>
-<li><p><a href="pub-support/BenjaminRussellStocum.html">Benjamin Russell Stocum</a>
-<li><p><a href="pub-support/DanielSavarese.html">Daniel F. Savarese</a>
+<li><p><a href="pub-support/ChristopherTaylor.html">Christopher Taylor</a> <!-- -->
<li><p>Jon Stevens
-<li><p><a href="pub-support/RichardDallaway.html">Richard Dallaway</a>
-<li><p><a href="pub-support/JeffTurner.html">Jeff Turner</a>
-<li><p><a href="pub-support/GuyLichtman.html">Guy Lichtman</a>
-<li><p><a href="pub-support/AndersKristensen.html">Anders Kristensen</a>
-<li><p><a href="pub-support/MichaelMoser.html">Michael Moser</a>
-<li><p><a href="pub-support/ChristopherTaylor.html">Christopher Taylor</a>
-<li><p><a href="pub-support/PaulGrinchenko.html">Paul Grinchenko</a>
+<li><p><a href="pub-support/PaulGrinchenko.html">Paul Grinchenko</a> <!-- -->
<li><p><a href="pub-support/CourtDemas.html">Court Demas</a> and his <a href="pub-support/CourtDemas2.html">follow up</a>
<li><p><a href="pub-support/NelsonMinar.html">Nelson Minar</a>
-<li><p><a href="pub-support/RobertMahoney.html">Robert Mahoney</a>
+<li><p><a href="pub-support/RobertMahoney.html">Robert Mahoney</a> <!-- -->
+<li><p><a href="pub-support/EllisTeer.html">Ellis Teer</a>
+<li><p><a href="pub-support/GuyLichtman.html">Guy Lichtman</a> <!-- -->
+<li><p><a href="pub-support/MichaelMoser.html">Michael Moser</a> <!-- -->
<li><p><a href="pub-support/HenrikLundahl.html">Henrik Lundahl</a>
<li><p><a href="pub-support/ThomasFenner.html">Thomas Fenner</a>
-<li><p><a href="pub-support/EndreStolsvik.html">Endre Stølsvik</a>
+<li><p><a href="pub-support/EndreStolsvik.html">Endre Stølsvik</a> <!-- -->
<li><p><a href="pub-support/KnutErikBallestad.html">Knut Erik Ballestad</a>
-<li><p><a href="pub-support/JohnVolkar.html">John Volkar </a>
<li><p><a href="pub-support/HenrikFredholm.html">Henrik Fredholm</a> and his <a href="pub-support/HenrikFredholm2.html">follow up</a> to Graham.
-<li><p><a href="pub-support/WilliamJaynes.html">William Jaynes</a>
-<li><p><a href="pub-support/MichaelStacey.html">Michael Stacey</a>
+<li><p><a href="pub-support/JohnVolkar.html">John Volkar</a> <!-- -->
+<li><p><a href="pub-support/WilliamJaynes.html">William Jaynes</a> <!-- -->
+<li><p><a href="pub-support/MichaelStacey.html">Michael Stacey</a> <!-- -->
<li><p><a href="pub-support/StacyCurl.html">Stacy Curl</a>
-<li><p><a href="pub-support/DavidOwens.html">David Owens</a>
+<li><p><a href="pub-support/DavidOwens.html">David Owens</a> <!-- -->
<li><p><a href="pub-support/EoinFlood.html">Eoin Flood </a>
<li><p><a href="pub-support/TonyDean.html">Tony Dean </a>
-<li><p><a href="pub-support/JamesProkash.html">James Prokash</a>
-<li><p><a href="pub-support/RalfHaug.html">Ralf Haug</a>
-<li><p><a href="pub-support/CarlBacher.html">Carl Bacher</a>
-<li><p><a href="pub-support/DanTanner.html">Dan Tanner</a>
-<li><p><a href="pub-support/JohnMunsch.html">John Munsch</a>
-<li><p><a href="pub-support/SteveWingfield.html">Steve Wingfield</a>
-<li><p><a href="pub-support/AbeMirrashidi.html">Abe Mirrashidi</a>
-<li><p><a href="pub-support/RonJacobs.html">Ron Jacobs</a>
-<li><p><a href="pub-support/JoeLoda.html">Joe Loda</a>
-<li><p><a href="pub-support/DavidMaharaj.html">David Maharaj</a>
-<li><p><a href="pub-support/HenryLi.html">Henry Li</a>
-<li><p><a href="pub-support/RichardWilliams.html">Richard Williams </a>
-<li><p><a href="pub-support/JasonHeirtzler.html">Jason Heirtzler</a>
+<li><p><a href="pub-support/AlexBlewitt.html">AlexBlewitt</a>
+<li><p><a href="pub-support/JamesProkash.html">James Prokash</a> <!-- -->
+<li><p><a href="pub-support/RalfHaug.html">Ralf Haug</a> <!-- -->
+<li><p><a href="pub-support/CarlBacher.html">Carl Bacher</a> <!-- -->
+<li><p><a href="pub-support/DanTanner.html">Dan Tanner</a> <!-- -->
+<li><p><a href="pub-support/BrentSprecher.html">Brent Sprecher</a> <!-- -->
+<li><p><a href="pub-support/SteveWingfield.html">Steve Wingfield</a> <!-- -->
+<li><p><a href="pub-support/AndersKristensen.html">Anders Kristensen</a> <!-- -->
+<li><p><a href="pub-support/AbeMirrashidi.html">Abe Mirrashidi</a> <!-- -->
+<li><p><a href="pub-support/JasonKitcat.html">Jason Kitcat</a> <!-- -->
+<li><p><a href="pub-support/RonJacobs.html">Ron Jacobs</a> <!-- -->
+<li><p><a href="pub-support/AndyDePue.html">Andy DePue</a> and his <a href="pub-support/AndyDePue2.html">follow up</a>
+<li><p><a href="pub-support/JoeLoda.html">Joe Loda</a> <!-- -->
+<li><p><a href="pub-support/DavidMaharaj.html">David Maharaj</a> <!-- -->
+<li><p><a href="pub-support/FrankBaxter.html">Frank Baxter</a>
+<li><p><a href="pub-support/HenryLi.html">Henry Li</a> <!-- -->
+<li><p><a href="pub-support/RichardWilliams.html">Richard Williams </a> <!-- -->
+<li><p><a href="pub-support/JasonHeirtzler.html">Jason Heirtzler</a> <!-- -->
<li><p><a href="pub-support/ScottMiller.html">Scott Miller</a>
-<li><p><a href="pub-support/ChandraPatni.html">Chandra Patni</a>
-<li><p><a href="pub-support/DanielHoppe.html">Daniel Hoppe </a>
-<li><p><a href="pub-support/SebastienGuimont.html">Sebastien Guimont</a>
+<li><p><a href="pub-support/ChandraPatni.html">Chandra Patni</a> <!-- -->
+<li><p><a href="pub-support/DanielHoppe.html">Daniel Hoppe </a> <!-- -->
+<li><p><a href="pub-support/SebastienGuimont.html">Sebastien Guimont</a> <!-- -->
<li><p><a href="pub-support/ThomasQuas.html">Thomas Quas</a>
-<li><p><a href="pub-support/DelEdwards.html">Del Edwards</a>
-<li><p><a href="pub-support/Piper.html">Piper</a>
-<li><p><a href="pub-support/TimColson.html">Tim Colson</a>
-<li><p><a href="pub-support/HowardShip.html">Howard Ship</a>
-<li><p><a href="pub-support/LewisGardner.html">Lewis Gardner</a>
-<li><p><a href="pub-support/PayamMirrashidi.html">Payam Mirrashidi</a>
+<li><p><a href="pub-support/JeffTurner.html">Jeff Turner</a>
+<li><p><a href="pub-support/JohnMunsch.html">John Munsch</a>
+<li><p><a href="pub-support/DelEdwards.html">Del Edwards</a> <!-- -->
+<li><p><a href="pub-support/Piper.html">Piper</a> <!-- -->
+<li><p><a href="pub-support/TimColson.html">Tim Colson</a> <!-- -->
+<li><p><a href="pub-support/HowardShip.html">Howard Ship</a> <!-- -->
+<li><p><a href="pub-support/LewisGardner.html">Lewis Gardner</a> <!-- -->
+<li><p><a href="pub-support/DanielSavarese.html">Daniel F. Savarese</a> <!-- -->
+<li><p><a href="pub-support/PayamMirrashidi.html">Payam Mirrashidi</a> <!-- -->
<li><p><a href="pub-support/BruceDeen.html">Bruce W. Deen</a>
-<li><p><a href="pub-support/EmilyBache.html">Emily Bache</a>
+<li><p><a href="pub-support/EmilyBache.html">Emily Bache</a> and her <a href="pub-support/EmilyBache2.html">follow up</a> <!-- -->
<li><p><a href="pub-support/JulienDubois.html">Julien Dubois</a>
<li><p><a href="pub-support/AlefArendsen.html">Alef Arendsen</a>
<li><p><a href="pub-support/SorenHilmer.html">Søren Hilmer</a>
<li><p><a href="pub-support/MaheshBhat.html">Mahesh Bhat</a>
<li><p><a href="pub-support/JeffLinwood.html">Jeff Linwood</a>
<li><p><a href="pub-support/PeterMeulmeester.html">Peter Meulmeester</a>
-<li><p><a href="pub-support/MichaelDuffy.html">Michael Duffy</a>
+<li><p><a href="pub-support/MichaelDuffy.html">Michael Duffy</a> <!-- -->
<li><p><a href="pub-support/BillGriffith.html">Bill Griffith</a>
-<li><p><a href="pub-support/DanielBram.html">Daniel Bram</a>
+<li><p><a href="pub-support/DanielBram.html">Daniel Bram</a> <!-- -->
+<li><p><a href="pub-support/RichardDallaway.html">Richard Dallaway</a> <!-- -->
<li><p><a href="pub-support/ChrisMein.html">Chris Mein</a>
+<li><p><a href="pub-support/BenjaminRussellStocum.html">Benjamin Russell Stocum</a> <!-- -->
<li><p><a href="pub-support/GuyNirpaz.html">Guy Nirpaz</a>
-<li><p><a href="pub-support/GrayJones.html">Gray Jones</a>
+<li><p><a href="pub-support/GrayJones.html">Gray Jones</a> <!-- -->
<li><p><a href="pub-support/CarlosPerez.html">Carlos Perez</a>
-<li><p><a href="pub-support/PaulMichaelReilly.html">Paul Michael Reilly</a>
-<li><p><a href="pub-support/MarcusAhnve.html">Marcus Ahnve</a>
-<li><p><a href="pub-support/DavidDuddleston.html">David Duddleston</a>
+<li><p><a href="pub-support/PaulMichaelReilly.html">Paul Michael Reilly</a> <!-- -->
+<li><p><a href="pub-support/MarcusAhnve.html">Marcus Ahnve</a> <!-- -->
+<li><p><a href="pub-support/DavidDuddleston.html">David Duddleston</a> <!-- -->
<li><p><a href="pub-support/BrianPaulsen.html">Brian Paulsen</a>
<li><p><a href="pub-support/AlexFernandez.html">Alex Fern�ndez</a>
-<li><p><a href="pub-support/DanielStephan.html">Daniel Stephan</a>
+<li><p><a href="pub-support/DanielStephan.html">Daniel Stephan</a> <!-- -->
<li><p><a href="pub-support/AlexanderEvsukov.html">Alexander Evsukov</a>
-<li><p><a href="pub-support/StevenSagaert.html">Steven Sagaert</a>
+<li><p><a href="pub-support/StevenSagaert.html">Steven Sagaert</a> <!-- -->
<li><p><a href="pub-support/DougErickson.html">Doug Erickson</a>
-<li><p><a href="pub-support/ScottGilpin.html">Scott Gilpin </a>
-<li><p><b><a href="pub-support/NateSammons.html">Nate Sammons</a></b> author of <a href="http://protomatter.sourceforge.net">Protomatter Syslog</a>
+<li><p><a href="pub-support/ScottGilpin.html">Scott Gilpin </a> <!-- -->
+<li><p><a href="pub-support/NateSammons.html">Nate Sammons</a> author of <a href="http://protomatter.sourceforge.net">Protomatter Syslog</a> <!-- -->
<li><p><a href="pub-support/StephanSchmidt.html">Stephan J. Schmidt</a>
-<li><p><a href="pub-support/JochenBedersdorfer.html">Jochen Bedersdorfer</a>
-<li><p><a href="pub-support/BalajiKithiganahalli.html">Balaji Kithiganahalli</a>
+<li><p><a href="pub-support/JochenBedersdorfer.html">Jochen Bedersdorfer</a> <!-- -->
+<li><p><a href="pub-support/BalajiKithiganahalli.html">Balaji Kithiganahalli</a> and his <a href="pub-support/BalajiKithiganahalli2.html">follow up</a>
<li><p><a href="pub-support/ChrisYearsley.html">Chris Yearsley</a>
-<li><p><a href="pub-support/ScottFleming.html">Scott Fleming</a>
-<li><p><a href="pub-support/PaulCraven.html">Paul Craven</a>
-<li><p><a href="pub-support/BruceKroeze.html">Bruce Kroeze</a>
-<li><p><a href="pub-support/AndrewHarris.html">Andrew Harris</a>
+<li><p><a href="pub-support/ScottFleming.html">Scott Fleming</a> <!-- -->
+<li><p><a href="pub-support/PaulCraven.html">Paul Craven</a> <!-- -->
+<li><p><a href="pub-support/BruceKroeze.html">Bruce Kroeze</a> <!-- -->
+<li><p><a href="pub-support/AndrewHarris.html">Andrew Harris</a> <!-- -->
+<li><p><a href="pub-support/BernshtamPavel.html">Bernshtam Pavel</a> <!-- -->
+<li><p><a href="pub-support/TomJanofsky.html">Tom Janofsky</a>
+<li><p><a href="pub-support/StephenAshcroft.html">Stephen Ashcroft</a>
+<li><p><a href="pub-support/BradleySchatz.html">Bradley Schatz</a> <!-- -->
+<li><p><a href="pub-support/ErikBergersjo.html">Erik Bergersjö</a> <!-- -->
+<li><p><a href="pub-support/KevinHuber.html">Kevin Huber</a> <!-- -->
+<li><p><a href="pub-support/LeeTHall.html">Lee T Hall</a> <!-- -->
+<li><p><a href="pub-support/JoelSchneider.html">Joel Schneider</a> <!-- -->
+<li><p><a href="pub-support/IvanRosero.html">Ivan Rosero</a> <!-- -->
+<li><p><a href="pub-support/ArndtSchoenewald.html">Arndt Schoenewald</a> <!-- -->
+<li><p><a href="pub-support/ScottEllsworth.html">Scott Ellsworth</a>
+<li><p><a href="pub-support/BrettMorgan.html">Brett Morgan </a> <!-- -->
<!--
-
-
-
-
<li><p><a href="pub-support/ .html"></a>
<li><p><a href="pub-support/ .html"></a>
<li><p><a href="pub-support/ .html"></a>
@@ -413,7 +425,13 @@
<li><p><a href="pub-support/ .html"></a>
<li><p><a href="pub-support/ .html"></a>
<li><p><a href="pub-support/ .html"></a>
-
+<li><p><a href="pub-support/ .html"></a>
+<li><p><a href="pub-support/ .html"></a>
+<li><p><a href="pub-support/ .html"></a>
+<li><p><a href="pub-support/ .html"></a>
+<li><p><a href="pub-support/ .html"></a>
+<li><p><a href="pub-support/ .html"></a>
+<li><p><a href="pub-support/ .html"></a>
-->
@@ -421,9 +439,10 @@
</UL>
-<p>Do not hesitate to contact <a href="cgu@qos.ch">cgu@qos.ch</a> in
-case you are uncomfortable seeing your name or the contents of your
-request reproduced publicly.
+<p>Most of the e-mail notes are reproduced with permission. However,
+do not hesitate to contact <a href="cgu@qos.ch">cgu@qos.ch</a> in case
+you are uncomfortable seeing your name or the contents of your request
+reproduced publicly.
<h2>Sun's response</h2>
@@ -437,15 +456,19 @@
sources and we've tried to support a wide set of requirements.
</pre>
-<p>Unfortunately, given the uproar that this API is generating, it is
+<p>Unfortunately, given the uproar that this API is causing, it is
becoming increasingly clear that the resulting API is unlikely to meet
-a wide set of requirements. The apparent failure of JSR47 API may be
-the inevitable consequence of the Java Community Process. <a
+a wide set of requirements. The apparent failure of JSR47 API is also
+casting a shadow on the nature of the Java Community Process. <a
href="http://www.zdnet.com/eweek/stories/general/0,11011,2666270,00.html">Michael
C. Daconta</a> has some interesting comments on the JCP. All said and
done, Java remains a wonderful computing platform. Sun deserves
credit for their ongoing investment. They have also introduced a
number of amazingly innovative APIs. However, no one gets it right
<em>all</em> the time.
+
+<p>Given the volume and the quality of support we are receiving from
+the community, I would not be surprised to see the JSR47 API retracted
+or replaced wholesale by log4j.
</body> </HTML>
1.1 jakarta-log4j/docs/plan.html
Index: plan.html
===================================================================
<HTML>
<HEAD>
<TITLE>Release plan for log4j 1.2</TITLE>
</HEAD>
<BODY>
<center>
<h2>Release plan for log4j 1.2</h2>
C. Gülcü
</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
its ready. Your comments and suggestions are most welcome.
<p>After we get appropriate feedback we can proceed with a vote.
<p><TABLE border="1" cellpadding="3" cellspacing="2">
<TR>
<TH>Label
<TH>Comment
<TH>Volunteer
<TR bgcolor="DDDDDD">
<TD>More test cases
<TD>We need more automated test cases to catch bugs as early is possible.
<p>Contributors are expected to be familiar with the log4j test
environment. They are also <em>required</em> to add a new test case
with each new feature or component.
<TD>All committers
</TR>
<TR>
<TD>JMX support
<TD>A common request is to change log4j settings without shutting down
a running application. The JMX API is designed to handle such
management tasks.
<p>For example, a <code>HierarchyAgent</code> could list all existing
categories in a hierarchy, create new categories, change the priority
or attach a new appender to a category. Log4j core needs to be
enhanced to report events such as the creation of a new categories,
priority changes, appender attachments/removals etc.
<TD>TBD
</TR>
<TR bgcolor="DDDDDD">
<TD>JDBCAppender
<TD>We currently have two competing JDBCAppenders: one by Thomas
Fenner and the other by Kevin Steppe. After proper testing, we should
include at least of one of these in the standard log4j distribution.
<TD>TBD
<TR>
<TD>Log4j in applets
<TD>In order to minimize network traffic, the size of log4j-core.jar
needs to be reduced to at most 50KB.
<TD>TBD
<TR bgcolor="DDDDDD">
<TD>Improved documentation
<TD>Log4j documentation needs to be enhanced with configuration
examples and much more hand-holding.
<TD>TBD
<TR>
<TD valign="top">Mapped Diagnostic Contexts
<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.
<TD>C. Gülcü
</TABLE>
</BODY>
</HTML>
---------------------------------------------------------------------
To unsubscribe, e-mail: log4j-cvs-unsubscribe@jakarta.apache.org
For additional commands, e-mail: log4j-cvs-help@jakarta.apache.org