ceki 02/04/04 06:46:02
Modified: . build.xml
docs HISTORY
src/java/org/apache/log4j PropertyConfigurator.java
src/java/org/apache/log4j/chainsaw package.html
src/java/org/apache/log4j/jdbc JDBCAppender.java
src/java/org/apache/log4j/net SocketAppender.java
SocketHubAppender.java
src/java/org/apache/log4j/spi LoggerFactory.java
src/xdocs download.xml earlier.xml
Log:
Preparing log4j 1.2rc1
- javadoc changes
- changes to the download page (1.2rc1 becomes the first item)
Revision Changes Path
1.26 +1 -1 jakarta-log4j/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/jakarta-log4j/build.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- build.xml 26 Mar 2002 23:00:40 -0000 1.25
+++ build.xml 4 Apr 2002 14:46:02 -0000 1.26
@@ -14,7 +14,7 @@
<!-- prefixed with "env". -->
<property environment="env"/>
- <property name="version" value="1.2beta5"/>
+ <property name="version" value="1.2rc1"/>
<!-- The base directory relative to which most targets are built -->
<property name="base" value="."/>
1.88 +1 -1 jakarta-log4j/docs/HISTORY
Index: HISTORY
===================================================================
RCS file: /home/cvs/jakarta-log4j/docs/HISTORY,v
retrieving revision 1.87
retrieving revision 1.88
diff -u -r1.87 -r1.88
--- HISTORY 2 Apr 2002 09:07:34 -0000 1.87
+++ HISTORY 4 Apr 2002 14:46:02 -0000 1.88
@@ -9,7 +9,7 @@
- Release of version 1.2
- (beta5)
+ (rc1)
- Added Oliver Burn's chainsaw tool to the core log4j
distribution. Visualisation and dynamic filtering of log events is
1.51 +1 -2
jakarta-log4j/src/java/org/apache/log4j/PropertyConfigurator.java
Index: PropertyConfigurator.java
===================================================================
RCS file:
/home/cvs/jakarta-log4j/src/java/org/apache/log4j/PropertyConfigurator.java,v
retrieving revision 1.50
retrieving revision 1.51
diff -u -r1.50 -r1.51
--- PropertyConfigurator.java 19 Mar 2002 21:25:17 -0000 1.50
+++ PropertyConfigurator.java 4 Apr 2002 14:46:02 -0000 1.51
@@ -228,8 +228,7 @@
<h3>Example</h3>
<p>An example configuration is given below. Other configuration
- file examples are given in {@link org.apache.log4j.examples.Sort}
- class documentation.
+ file examples are given in the <code>examples</code> folder.
<pre>
1.3 +1 -3 jakarta-log4j/src/java/org/apache/log4j/chainsaw/package.html
Index: package.html
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/java/org/apache/log4j/chainsaw/package.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- package.html 4 Apr 2002 14:29:20 -0000 1.2
+++ package.html 4 Apr 2002 14:46:02 -0000 1.3
@@ -54,9 +54,7 @@
<H2>Running chainsaw</H2>
<H3>Setup</H3>
- <P>You need to include the following JARs in the classpath:</P>
- <OL>
- <LI><SPAN class=default>log4j.jar</SPAN> </LI></OL>
+ <P>You need to include the <code>log4j.jar</code> in the classpath.
<H3>Usage</H3>
1.4 +1 -1 jakarta-log4j/src/java/org/apache/log4j/jdbc/JDBCAppender.java
Index: JDBCAppender.java
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/java/org/apache/log4j/jdbc/JDBCAppender.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- JDBCAppender.java 25 Mar 2002 22:37:21 -0000 1.3
+++ JDBCAppender.java 4 Apr 2002 14:46:02 -0000 1.4
@@ -32,7 +32,7 @@
conversion patterns in <code>PatternLayout</code> can be used
inside of the statement. (see the test cases for examples)
- <p>Overriding the {@link getLogStatement} method allows more
+ <p>Overriding the {@link #getLogStatement} method allows more
explicit control of the statement used for logging.
<p>For use as a base class:
1.11 +4 -4 jakarta-log4j/src/java/org/apache/log4j/net/SocketAppender.java
Index: SocketAppender.java
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/java/org/apache/log4j/net/SocketAppender.java,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- SocketAppender.java 3 Apr 2002 22:18:14 -0000 1.10
+++ SocketAppender.java 4 Apr 2002 14:46:02 -0000 1.11
@@ -85,10 +85,10 @@
be untransmitted data in the pipe which might be lost. This is a
common problem on Windows based systems.
- <p>To avoid lost data, it is usually sufficient to {@link #close}
- the <code>SocketAppender</code> either explicitly or by calling
- the {@link Category#shutdown} method before exiting the
- application.
+ <p>To avoid lost data, it is usually sufficient to {@link
+ #close} the <code>SocketAppender</code> either explicitly or by
+ calling the {@link org.apache.log4j.LogManager#shutdown} method
+ before exiting the application.
</ul>
1.3 +3 -4
jakarta-log4j/src/java/org/apache/log4j/net/SocketHubAppender.java
Index: SocketHubAppender.java
===================================================================
RCS file:
/home/cvs/jakarta-log4j/src/java/org/apache/log4j/net/SocketHubAppender.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- SocketHubAppender.java 25 Mar 2002 22:37:21 -0000 1.2
+++ SocketHubAppender.java 4 Apr 2002 14:46:02 -0000 1.3
@@ -87,13 +87,12 @@
<p>To avoid lost data, it is usually sufficient to {@link #close}
the <code>SocketHubAppender</code> either explicitly or by calling
- the {@link Category#shutdown} method before exiting the
- application.
+ the {@link org.apache.log4j.LogManager#shutdown} method before
+ exiting the application.
</ul>
- @author Mark Womack
-*/
+ @author Mark Womack */
public class SocketHubAppender extends AppenderSkeleton {
1.2 +1 -1 jakarta-log4j/src/java/org/apache/log4j/spi/LoggerFactory.java
Index: LoggerFactory.java
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/java/org/apache/log4j/spi/LoggerFactory.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- LoggerFactory.java 3 Sep 2001 22:33:21 -0000 1.1
+++ LoggerFactory.java 4 Apr 2002 14:46:02 -0000 1.2
@@ -14,7 +14,7 @@
Implement this interface to create new instances of Logger or
a sub-class of Logger.
- <p>See {@link org.apache.log4j.examples.MyCategory} for an example.
+ <p>See <code>examples/subclass/MyLogger.java</code> for an example.
@author Ceki Gülcü
@since version 0.8.5
1.49 +40 -53 jakarta-log4j/src/xdocs/download.xml
Index: download.xml
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/xdocs/download.xml,v
retrieving revision 1.48
retrieving revision 1.49
diff -u -r1.48 -r1.49
--- download.xml 6 Mar 2002 13:31:48 -0000 1.48
+++ download.xml 4 Apr 2002 14:46:02 -0000 1.49
@@ -9,86 +9,73 @@
<meta name="keywords" content="java, logging, tracing, component, framework, API,
log4j"/>
<body>
+ <section name="log4j version 1.2 (release candidate 1)">
+ <p>log4j 1.2rc1 is now available in <a
+ href="../jakarta-log4j-1.2rc1.tar.gz"><b>TAR.GZ</b></a> format
+ or in <a href="../jakarta-log4j-1.2rc1.zip"><b>ZIP</b></a>
+ format.
+ </p>
-<!--
-<table CELLSPACING="8" CELLPADDING="4" FGCOLOR="gray"
- BORDER="0" WIDTH="25%" ALIGN="RIGHT" VALIGN="TOP">
- <tr>
- <td valign="center" BGCOLOR="#FFFFCF" ALIGN="center">
- <b><font color="CC0000">This is your last chance to bail out!</font></b>
- </td>
- </tr>
- <tr>
- <td>
- <font color="666666">
- There is <a href="praise.html">mounting evidence</a> showing that
- log4j is highly addictive. In clinical tests, starving programmers
- have consistently preferred logging to pizza.
- <p> Are you absolutely sure you want to use log4j? Because once
- hooked, there is no turning back.</p>
- </font>
- </td>
- </tr>
-</table>
--->
-
-
- <section name="log4j version 1.1.3">
- <p>Download version 1.1.3 including <i>full source code</i>,
- class files and documentation in <a
- href="../jakarta-log4j-1.1.3.tar.gz"><b>TAR.GZ</b></a> format
- or in <a href="../jakarta-log4j-1.1.3.zip"><b>ZIP</b></a>
- format. You may elect to browse log4j <a
- href="documentation.html"><b>documentation</b></a> online. <a
+ <p>In addition to many performance improvements, bug fixes, and
+ other small enhancements, log4j 1.2 adds JMX support, Mapped
+ Diagnostic Contexts, JDBC logging, graphical log viewer
+ (chainsaw), and buffered IO capability. One important change
+ is the replacement of the <code>Category</code> class with
+ <code>Logger</code> class and the <code>Priority</code> class
+ with the <code>Level</code> class in order to facilitate
+ migrating from the JDK 1.4 logging API to log4j. <a
href="http://www.javaworld.com/javaworld/jw-05-2001/jw-0504-finalists.html";><img
src="images/ecaward_finalist_logo.gif" align="right"
- border="0"/></a>Version 1.1.3 is the 21st major public release
- of log4j. It is backward compatible with log4j version
- 1.0.x.</p>
+ border="0"/></a>
+ </p>
+ <p>Version 1.2 is the 22nd major public release of log4j. All
+ changes except the removal of deprecated methods are backward
+ compatible such that log4j 1.2 can be considered a drop in
+ replacement for log4j 1.1.3. The only exception is the
+ renaming of the <code>CategoryFactory</code> class to
+ <code>LoggerFactory</code> class such that subclasses of
+ <code>Category</code> class to be modified and recompiled. By
+ the way, we strongly discourage casual users from subclassing
+ the <code>Category</code> or <code>Logger</code> classes.
+ </p>
<p>We also maintain a list of <a href="earlier.html">earlier
versions</a> of log4j for download, intended for the curious
- paleontologist.</p>
+ paleontologist.
+ </p>
+
</section>
- <section name="log4j version 1.2 beta4">
- <p>log4j 1.2 beta 4 is now available in <a
- href="../jakarta-log4j-1.2beta4.tar.gz"><b>TAR.GZ</b></a>
- format or in <a
- href="../jakarta-log4j-1.2beta4.zip"><b>ZIP</b></a> format.
- </p>
+ <section name="log4j version 1.1.3">
- <p>In addition to many performance improvements, bug fixes, and
- other small enhancements, log4j 1.2 beta4 adds JMX support,
- Mapped Diagnostic Contexts, and buffered IO capability. One
- important change is the replacement of the Category class with
- Logger class and the Priority with the Level in order to
- facilitate migrating from the JDK 1.4 logging API to log4j.
+ <p>Download version 1.1.3 including <i>full source code</i>,
+ class files and documentation in <a
+ href="../jakarta-log4j-1.1.3.tar.gz"><b>TAR.GZ</b></a> format
+ or in <a href="../jakarta-log4j-1.1.3.zip"><b>ZIP</b></a>
+ format.
</p>
-
- <p>All changes except the removal of deprecated methods are backward
- compatible such that log4j 1.2beta4 can be considered a drop in
- replacement for log4j 1.1.3. </p>
</section>
+
<section name="Third-party extensions">
<dl>
<dt><a href="http://logui.sourceforge.net/";><b>Chainsaw</b></a></dt>
- <dd>Chainsaw is a GUI log viewer and filter for the Log4J
- package. It listens for <a
+ <dd>Chainsaw is now integrated with log4j and ships with the
+ official distribution. Chainsaw a GUI log viewer and filter
+ for the Log4J package. It listens for <a
href="http://jakarta.apache.org/log4j/docs/api/org/apache/log4j/spi/LoggingEvent.html";>LoggingEvent</a>
objects sent using the <a
href="http://jakarta.apache.org/log4j/docs/api/org/apache/log4j/net/SocketAppender.html";>SocketAppender</a>
and displays them in a table. Chainsaw also supports loading
- events from files in the XMLLayout format.
+ events from files in the XMLLayout format.
</dd>
<dt><a href="http://qos.ch/";><b>log4j<em>ME</em></b></a></dt>
1.7 +20 -10 jakarta-log4j/src/xdocs/earlier.xml
Index: earlier.xml
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/xdocs/earlier.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- earlier.xml 3 Jul 2001 09:24:39 -0000 1.6
+++ earlier.xml 4 Apr 2002 14:46:02 -0000 1.7
@@ -8,19 +8,29 @@
<body>
-<section name="Older distributions of the log4j package">
+ <section name="Older distributions of the log4j package">
-<hr/> <p><b>BEWARE:</b> For some reason Internet Explorer decides to
-rename ".tar.gz" files as ".tar". You should rename the files back to
-<code>tar.gz</code> after the download completes.</p> <hr/>
+ <hr/>
+
+ <p><b>BEWARE:</b> For some reason Internet Explorer decides to
+ rename ".tar.gz" files as ".tar". You should rename the files back to
+ <code>tar.gz</code> after the download completes.
+ </p>
+ <hr/>
-<dl>
- <dt><b>jakarta-log4j-1.0.4</b></dt>
- <dd>
- Download full package in <a href="../jakarta-log4j-1.0.4.tar.gz">TAR.GZ</a>
format.
- </dd>
+ <dl>
+ <dt><b>jakarta-log4j-1.0.4</b></dt>
+ <dd>
+ Download full package in <a href="../jakarta-log4j-1.0.4.tar.gz">TAR.GZ</a>
+ format.
+ </dd>
-</dl>
+ <dt><b>jakarta-log4j-1.1.3</b></dt>
+ <dd>
+ Download full package in <a href="../jakarta-log4j-1.1.3.tar.gz">TAR.GZ</a>
+ format.
+ </dd>
+ </dl>
</section>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
