ceki 01/05/25 12:39:14
Modified: docs FAQ.html
src/java/org/apache/log4j/test shallow
src/java/org/apache/log4j/xml/examples sample4.xml
Log:
I CHECKED THE LOG4J MODULE FOR POSSIBLE MALICIOUS MODIFICATION. I COULD FINE NONE.
Added a new FAQ entry about configuration options.
Corrected a typo in sampl4.xml.
Revision Changes Path
1.9 +61 -29 jakarta-log4j/docs/FAQ.html
Index: FAQ.html
===================================================================
RCS file: /home/cvs/jakarta-log4j/docs/FAQ.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- FAQ.html 2001/05/18 09:58:19 1.8
+++ FAQ.html 2001/05/25 19:39:02 1.9
@@ -11,40 +11,52 @@
<ul>
-<li><p><a href=#whatIs>What is log4j?</a> <br>
-<li><p><a href=#reliable>Is log4j a reliable logging system?</a>
-<li><p><a href=#prerequisites>What are the prerequisites for log4j?</a>
-<li><p><a href=#javadoc>Is there javadoc documentation for log4j?</a>
-<li><p><a href=#alternatives>What other logging packages are there?</a>
-<li><p><a HREF=#usageExample>Is there example code for using log4j?</a>
-<li><p><a href=#features>What are the features of log4j?</a>
-<li><p><a href=#thread-safety>Is log4j thread-safe?</a>
-<li><p><a href=#sample>What does log output look like?</a>
-<li><p><a href=#category>What are <em>Categories</em>?</a>
-<li><p><a href=#behavior>How can I change log behavior at runtime?</a>
+<li><p><a href=#whatIs>What is log4j?</a></p>
+
+<li><p><a href=#reliable>Is log4j a reliable logging system?</a></p>
+<li><p><a href=#prerequisites>What are the prerequisites for log4j?</a></p>
+<li><p><a href=#javadoc>Is there javadoc documentation for log4j?</a></p>
+<li><p><a href=#alternatives>What other logging packages are there?</a></p>
+<li><p><a HREF=#usageExample>Is there example code for using log4j?</a></p>
+<li><p><a href=#features>What are the features of log4j?</a></p>
+<li><p><a href=#thread-safety>Is log4j thread-safe?</a></p>
+<li><p><a href=#sample>What does log output look like?</a></p>
+<li><p><a href=#category>What are <em>Categories</em>?</a></p>
+<li><p><a href=#behavior>How can I change log behavior at runtime?</a></p>
<li><p><a HREF=#reduce>How can I reduce the computational cost of
-debug and info statements?</a>
-<li><p><a HREF=#fastLogging>What is the fastest way of (not) logging?</a>
+debug and info statements?</a></p>
+<li><p><a HREF=#fastLogging>What is the fastest way of (not) logging?</a></p>
<li><p><a HREF=#arrayDebug>What is the use of the <code>debug</code> method
-expecting a <code>String</code> array as one of its parameters?</a>
-<li><p><a href=#introCat>Why was the Category class introduced and how do
-I migrate from the previous String based implementation?</a>
+expecting a <code>String</code> array as one of its parameters?</a></p>
+
+<li><p><a href=#introCat>Why was the Category class introduced and how
+do I migrate from the previous String based implementation?</a></p>
+
<li><p><a href=#namingCategories>Are there any suggested ways for naming
-categories?</a></br>
+categories?</a></p>
+
<li><p><a href=#className>How do I get the fully-qualified name of a class in
-a static block?</a>
+a static block?</a></p>
+
<li><p><a href=#customLayouts>Can the log output format be
-customized?</a>
+customized?</a></p>
+
+<li><p><a href="#options">What are the configurable options for
+<code>ForBarAppender</code>?</a></p>
+
+
<li><p><a href=#NDC>Can the outputs of multiple client request go to
-different log files?</a>
+different log files?</a></p>
+
+
<li><p><a href=#rm>Category instances seem to be create only. Why isn't
-there a method to remove category instances?</a>
+there a method to remove category instances?</a></p>
<li><p><a href=#filterByPriority>Is it possible to direct log output
-to different appenders by priority?</a>
+to different appenders by priority?</a></p>
<li><p><a href=#many21>How do I get multiple processes to log to the
-same file?</a>
+same file?</a></p>
<li><p><a href=#timestamp>If I have many process across multiple hosts
(possibly across multiple timezones) logging to the same file using the
@@ -52,16 +64,16 @@
<li><p><a href=#tax>Why should I donate my log4j extensions back to the
-project?</a>
-<li><p><a href=#help>What should I keep in mind when contributing code?</a>
+project?</a></p>
+<li><p><a href=#help>What should I keep in mind when contributing code?</a></p>
-<li><p><a href=#bugCorrection>How fast do bugs in log4j get fixed?</a>
+<li><p><a href=#bugCorrection>How fast do bugs in log4j get fixed?</a></p>
-<li><p><a href=#history>What is the history of log4j?</a>
+<li><p><a href=#history>What is the history of log4j?</a></p>
-<li><p><a href=#bugs>How do I report bugs?</a>
+<li><p><a href=#bugs>How do I report bugs?</a></p>
-<li><p><a href=#download>Where can I find the latest distribution of log4j?</a>
+<li><p><a href=#download>Where can I find the latest distribution of log4j?</a></p>
</ul>
@@ -497,6 +509,26 @@
multiple hierarchy trees. Thus, it is possible to log to different
targets from the same category depending on the current context.
+<p><a name="#options"><h4>What are the configurable options for
+FooBarAppender?</h4>
+
+Log4j uses JavaBeans style configuration.
+
+<p>Thus, any setter method in <code>FooBarAppender</code> corresponds
+to a configurable option. For example, in <a
+href="api\org\apache\log4j\RollingFileAppender.html">RollingFileAppender</a>
+the <a
+href="api/org/apache/log4j/RollingFileAppender.html#setMaxBackupIndex(int)">setMaxBackupIndex(int
+maxBackups)</a> method corresponds to the <code>maxBackupIndex</code>
+option. The first letter of the option can be upper case, i.e.
+<code>MaxBackupIndex</code> and <code>maxBackupIndex</code> are
+equivalent but not <code>MAXBACKUPIndex</code> nor
+<code>mAXBackupIndex</code>.
+
+<p>Layouts options are also defined by their setter methods. Same goes
+for most other log4j components.
+
+<!-- ------------------------------------------------------------------ -->
<p><a name=rm><h4>Category instances seem to be create only. Why isn't
there a method to remove category instances?</h4>
1.7 +2 -2 jakarta-log4j/src/java/org/apache/log4j/test/shallow
Index: shallow
===================================================================
RCS file: /home/cvs/jakarta-log4j/src/java/org/apache/log4j/test/shallow,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- shallow 2001/04/17 17:14:12 1.6
+++ shallow 2001/05/25 19:39:07 1.7
@@ -46,7 +46,7 @@
echo "$A1_PREFIX.layout.DateFormat=$dateFormat" >> $LCF
echo "$A2_PREFIX=org.apache.log4j.FileAppender" >> $LCF
- echo "$A2_PREFIX.Append=false" >> $LCF
+ echo "$A2_PREFIX.append=false" >> $LCF
echo "$A2_PREFIX.layout=$layoutClass" >> $LCF
echo "$A2_PREFIX.layout.DateFormat=$dateFormat" >> $LCF
@@ -147,7 +147,7 @@
echo "log4j.category.org.apache.log4j.test.ShortSocketServer=WARN">> socket.lcf
echo "log4j.category.org.apache.log4j.net.SocketNode=WARN">> socket.lcf
echo "log4j.appender.A=org.apache.log4j.FileAppender">> socket.lcf
- echo "log4j.appender.A.File= $TEMP" >> socket.lcf
+ echo "log4j.appender.A.file= $TEMP" >> socket.lcf
echo "log4j.appender.A.Append=false" >> socket.lcf
echo "log4j.appender.A.layout=org.apache.log4j.PatternLayout" >> socket.lcf
echo "log4j.appender.A.layout.ConversionPattern=%5p %x [%t] %c %m%n" >> socket.lcf
1.5 +1 -1 jakarta-log4j/src/java/org/apache/log4j/xml/examples/sample4.xml
Index: sample4.xml
===================================================================
RCS file:
/home/cvs/jakarta-log4j/src/java/org/apache/log4j/xml/examples/sample4.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- sample4.xml 2001/03/20 16:06:08 1.4
+++ sample4.xml 2001/05/25 19:39:11 1.5
@@ -9,7 +9,7 @@
<appender name="TEMP" class="org.apache.log4j.FileAppender">
<param name="File" value="temp"/>
- <layout class="org.apache.log4j.2PatternLayout">
+ <layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="%d %-5p [%t] %C{2} (%F:%L) - %m%n"/>
</layout>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
