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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
