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/12/20 19:53:01 UTC
cvs commit: jakarta-log4j/src/docbook intro.xml manual.xml
ceki 01/12/20 10:53:01
Modified: src/docbook intro.xml manual.xml
Log:
Revision Changes Path
1.14 +24 -45 jakarta-log4j/src/docbook/intro.xml
Index: intro.xml
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/docbook/intro.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- intro.xml 2001/12/19 21:43:56 1.13
+++ intro.xml 2001/12/20 18:53:01 1.14
@@ -93,57 +93,24 @@
<para>The quality of the project benefited tremendously from a
less known Jakarta project called <ulink
url="http://jakarta.apache.org/gump/">gump</ulink>. When the
- logger class was first introduced it was a super-class of
+ Logger class was first introduced it was a super-class of
Category. This caused a rather subtle incompatibility bug which
- was detected by gump in about a day. A far more reliable migration
- strategy was later suggested by Nicholas Wolff. Without gump, it
- would have taken us weeks and even months to detect the
- incompatibility problem, at which time it would have been far to
- late to remedy it. Without gump, log4j could not possibly offer
- the same degree of backward compatibility guarantees. Life is like
- a box of chocolates - you never know what you are going to get!
+ was detected by gump after about a day. A far more reliable
+ migration strategy was later suggested by Nicholas Wolff. Without
+ gump, it would have taken us weeks and even months to detect the
+ problem, at which time it would have been too late to fix
+ it. Without gump, log4j could not possibly offer the same degree
+ of backward compatibility guarantees. Life is like a box of
+ chocolates - you never know what you are going to get!
</para>
<para>Log4j is the result of a collective effort. My special
thanks go to all the authors who have contributed to the
project. Without exception, the best features in the package
- have all originated in the user community. </para>
- </sect1>
-
- <!-- Section =============================================================== -->
-
- <sect1>
- <title>Copyright</title>
- <para>
- Copyright 2000-2001 Ceki Gülcü. All rights reserved.
- </para>
-
- <para>
- You are free to copy and distribute this document in electronic
- form but not in printed form. Translations or modifications of
- this document require prior written permission.
- </para>
-
- <para>THIS PUBLICATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
- KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
- THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL CEKI
- GÜLCÜ OR ANY OTHER CONTRIBUTOR BE LIABLE FOR ANY
- CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
- CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
- CONNECTION WITH THE DOCUMENT OR THE USE OR OTHER DEALINGS IN THE
- DOCUMENT.
- </para>
-
- <para>THIS PUBLICATION COULD INCLUDE TECHNICAL INACCURACIES OR
- TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE
- INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW
- EDITIONS OF THE PUBLICATION. THE AUTHORS MAY MAKE IMPROVEMENTS
- AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED
- IN THIS PUBLICATION AT ANY TIME.
+ have all originated in the user community.
</para>
</sect1>
-
+
<!-- Section ========================================================== -->
<sect1>
<title>Installing</title>
@@ -270,8 +237,20 @@
retrieve a Logger object by invoking the
<function>Logger.getLogger</function> method and passing it
a string, commonly the fully qualified name of the
- containing class. The logger object is usually declared as a
- <varname>static final</varname>.
+ containing class. This logger object is usually declared as
+ a <varname>static final</varname>.
+
+ <note>
+ <para>There is a variant of the
+ <function>Logger.getLogger</function> method which takes
+ a Class object as argument instead of a String. It is
+ intended as a syntactic sugar. The following two expressions are equivalent:
+ <programlisting>
+ Logger.getInstance(X.class.getName()); // the String variant
+ Logger.getInstance(X.class); // the Class variant
+ </programlisting>
+ </para>
+ </note>
</para>
</step>
1.19 +42 -2 jakarta-log4j/src/docbook/manual.xml
Index: manual.xml
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/docbook/manual.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- manual.xml 2001/12/19 21:43:56 1.18
+++ manual.xml 2001/12/20 18:53:01 1.19
@@ -1,4 +1,4 @@
-<?xml version='1.0'?>
+<?xml version='1.0' encoding="ISO-8859-1" ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "docbkx412/docbookx.dtd" [
<!ENTITY intro SYSTEM "intro.xml">
<!ENTITY architecture SYSTEM "architecture.xml">
@@ -21,7 +21,47 @@
<firstname>Ceki</firstname>
<surname>Gülcü</surname>
</author>
-
+
+ <edition>log4j 1.2 alpha 6</edition>
+ <releaseinfo>This manual applies to log4j version 1.2 and later.</releaseinfo>
+ <pubdate>20 December 2001</pubdate>
+
+ <copyright>
+ <year>2000</year>
+ <year>2001</year>
+ </copyright>
+
+ <legalnotice>
+ <para>Permission to use, copy, and distribute this document in
+ electronic form but not in printed form for any purpose and
+ without fee is hereby granted in perpetuity, provided that the
+ above copyright notice and this paragraph appear in all
+ copies. Translations or modifications of this document require
+ prior written permission.
+ </para>
+ </legalnotice>
+
+ <legalnotice>
+ <para>THIS PUBLICATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
+ ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
+ LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS
+ FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT
+ SHALL CEKI GÜLC� OR ANY OTHER CONTRIBUTOR BE LIABLE FOR ANY
+ CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+ CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ CONNECTION WITH THE DOCUMENT OR THE USE OR OTHER DEALINGS IN
+ THE DOCUMENT.</para>
+ </legalnotice>
+
+ <legalnotice>
+ <para>THIS PUBLICATION COULD INCLUDE TECHNICAL INACCURACIES OR
+ TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE
+ INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW
+ EDITIONS OF THE PUBLICATION. THE AUTHORS MAY MAKE IMPROVEMENTS
+ AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED
+ IN THIS PUBLICATION AT ANY TIME.</para>
+ </legalnotice>
+
<abstract>
<para>
This document describes the log4j API, its features and design
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>