Author: kkolinko
Date: Wed Sep 22 14:48:53 2010
New Revision: 1000003
URL: http://svn.apache.org/viewvc?rev=1000003&view=rev
Log:
Improving the documentation for logging configuration in Apache Tomcat
Modified:
tomcat/trunk/webapps/docs/logging.xml
Modified: tomcat/trunk/webapps/docs/logging.xml
URL:
http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/logging.xml?rev=1000003&r1=1000002&r2=1000003&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/logging.xml (original)
+++ tomcat/trunk/webapps/docs/logging.xml Wed Sep 22 14:48:53 2010
@@ -37,22 +37,19 @@
<section name="Introduction">
<p>
Tomcat uses
- <a href="http://commons.apache.org/logging";>Commons Logging</a>
- throughout its internal code allowing the
- developer to choose a logging configuration that suits their needs, e.g
- java.util.logging or
- <a href="http://logging.apache.org/log4j";>Log4J</a>.
+ <a href="http://commons.apache.org/logging";>Apache Commons Logging</a>
+ throughout its internal code.
Commons Logging provides Tomcat with the ability to log
hierarchically across various log levels without needing to rely on a
- particular logging implementation.
+ particular logging implementation.
</p>
<p>
By default, only java.util.logging is available for the logs generated by
the Tomcat internal loggers, as Tomcat uses a package renamed commons
logging implementation which is hardcoded to use java.util.logging. Use
of
- alternative logging frameworks requires building or downloading the
- <a href="extras.html">extras</a> components which include a full
+ alternative logging frameworks requires building or downloading an
+ <a href="extras.html">extras</a> component which include a full
commons-logging implementation. Instructions for configuring the extras
components to enable log4j to be used for Tomcat's internal logging may
be
found below.
@@ -62,12 +59,12 @@
Tomcat no longer uses <code>localhost_log</code> as the runtime
exception/stack trace log. These types of error are usually thrown by
uncaught exceptions, but are still valuable to the developer. They can
now
- be found in the <code>stdout</code> log.
+ be found in the <code>stdout</code> log file (<code>catalina.out</code>).
</p>
</section>
- <section name="java.util.logging">
+ <section name="Using java.util.logging (default)">
<p>
The default implementation of java.util.logging provided in the JDK is too
@@ -225,7 +222,7 @@ java.util.logging.ConsoleHandler.formatt
</section>
- <section name="log4j">
+ <section name="Using Log4j">
<p>
This section explains how to configure Tomcat to use log4j rather than
java.util.logging for all Tomcat's internal logging. The following steps
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
