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/05/25 21:39:15 UTC

cvs commit: jakarta-log4j/src/java/org/apache/log4j/xml/examples sample4.xml

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: log4j-cvs-unsubscribe@jakarta.apache.org
For additional commands, e-mail: log4j-cvs-help@jakarta.apache.org