tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From yo...@apache.org
Subject svn commit: r409450 - in /tomcat/container/tc5.5.x/webapps/docs: changelog.xml logging.xml
Date Thu, 25 May 2006 20:02:33 GMT
Author: yoavs
Date: Thu May 25 13:02:32 2006
New Revision: 409450

URL: http://svn.apache.org/viewvc?rev=409450&view=rev
Log:
Bugzilla 39661: http://issues.apache.org/bugzilla/show_bug.cgi?id=39661

Modified:
    tomcat/container/tc5.5.x/webapps/docs/changelog.xml
    tomcat/container/tc5.5.x/webapps/docs/logging.xml

Modified: tomcat/container/tc5.5.x/webapps/docs/changelog.xml
URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/changelog.xml?rev=409450&r1=409449&r2=409450&view=diff
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/changelog.xml (original)
+++ tomcat/container/tc5.5.x/webapps/docs/changelog.xml Thu May 25 13:02:32 2006
@@ -33,6 +33,9 @@
         <bug>39406</bug>: Fix that StandardSession#getLastAccessedTime() uses
correct exception message,
         suggested by Takayoshi Kimura. (pero)
       </fix>
+      <add>
+        <bug>39661</bug>: Add documentation on JULI FileHandler properties. (yoavs)
+      </add>
   </changelog>
   </subsection> 
   <subsection name="Webapps">

Modified: tomcat/container/tc5.5.x/webapps/docs/logging.xml
URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/logging.xml?rev=409450&r1=409449&r2=409450&view=diff
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/logging.xml (original)
+++ tomcat/container/tc5.5.x/webapps/docs/logging.xml Thu May 25 13:02:32 2006
@@ -130,7 +130,7 @@
 
   <p>
     In order to configure JDK logging you should have JDK 1.4+. Tomcat 5.5 is intended for
-    JDK 5.0, but can be run on JDK 1.4 using a compatibility package.
+    JDK 5.0 or later, but can be run on JDK 1.4 using a compatibility package.
   </p>
   <p>
     The default implemenatation of java.util.logging provided in the JDK is too limited to
be 
@@ -266,6 +266,70 @@
       </source>
     </p>
 
+  </section>
+
+  <section name="Handler Properties">
+    <p>
+      Tomcat's JULI implementation is not intended to be a fully-featured logging libary,
only
+      a simple bridge to those libraries.  However, JULI does provide several properties
+      for configuring the its handlers.  These are listed below.
+    </p>
+    
+    <subsection name="FileHandler">
+      <attributes>
+        <attribute name="directory" required="false">
+          <p>
+            The directory where the log file will be written.  The Tomcat server account
+            should have write permissions to this directory.  The default value of this
+            property is <em>logs</em>.
+          </p>
+        </attribute>
+
+        <attribute name="prefix" required="false">
+          <p>
+            The log file name prefix.  This is the portion of the log file name before the
date.  
+            The default value of this property is <em>juli.</em>.
+          </p>
+        </attribute>
+
+        <attribute name="suffix" required="false">
+          <p>
+            The log file name suffix.  This is the portion of the log file name after the
date.
+            The default value of this property is <em>.log</em>.
+          </p>
+        </attribute>
+
+        <attribute name="level" required="false">
+          <p>
+            The threshold level for this handler.  It must be one of the levels in the 
+            <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html">java.util.logging.Level</a>
class.
+            The default value of this property is <em>ALL</em>.  Messages whose
level is below
+            the specified level will not be written to the file.
+          </p>
+        </attribute>
+
+        <attribute name="filter" required="false">
+          <p>
+            The fully-qualified class name of a class that implements the 
+            <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Filter.html">java.util.logging.Filter</a>

+            interface.  JULI will load this class and associate it with this handler to filter
its messages.
+            By default, there is no Filter associated with the handler.            
+          </p>
+        </attribute>
+
+        <attribute name="formatter" required="false">
+          <p>
+            The fully-qualified class name of a class that implements the
+            <a href="http://java.suncom/j2se/1.4.2/docs/api/java/util/logging/Formatter.html">java.util.logging.Formatter</a>
+            interface.  JULI will load this class and associate it with this handler to format
its messages.
+            By default, there is no Formatter associated with the handler.
+          </p>
+        </attribute>
+
+      </attributes>
+
+    </subsection>    
+  
   </section>
 
 </body>



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message