diff --git a/src/java/org/apache/commons/logging/package.html b/src/java/org/apache/commons/logging/package.html index 003b0b8..59d218d 100644 --- a/src/java/org/apache/commons/logging/package.html +++ b/src/java/org/apache/commons/logging/package.html @@ -124,7 +124,7 @@ implementation uses the following rules:
org.apache.commons.logging.Log (for backwards
compatibility to pre-1.0 versions of this API, an attribute
- org.apache.commons.logging.log is also consulted)..org.apache.commons.logging.log is also consulted).
org.apache.commons.logging.Log (for backwards
compatibility to pre-1.0 versions of this API, a system property
diff --git a/usersguide.html b/usersguide.html
index 3808323..346490d 100644
--- a/usersguide.html
+++ b/usersguide.html
@@ -23,6 +23,7 @@ Users Guide : Jakarta Commons Logging
+As far as possible, Commons-Logging tries to be as unobtrusive as possible.
+In most cases, including the (full) commons-logging.jar in the classpath
+should result in Commons-Logging configuring itself in a reasonable manner.
+There's a good chance that it'll guess your preferred logging system and you won't
+need to do any configuration at all!
+
+There are two base abstractions used by Commons-Logging: Log
+(the basic logger) and LogFactory (which knows how to create Log
+instances). Using LogFactory implementations other than the default is a
+subject for advanced users only, so let's concentrate on configuring the default
+implementation.
+
+The default LogFactory implementation uses the following discovery process
+to determine what type of Log implementation it should use
+(the process terminates when the first positive match - in order - is found):
+
+
org.apache.commons.logging.Log (for backwards
+ compatibility to pre-1.0 versions of this API, an attribute
+ org.apache.commons.logging.log is also consulted).org.apache.commons.logging.Log (for backwards
+ compatibility to pre-1.0 versions of this API, a system property
+ org.apache.commons.logging.log is also consulted).Log
+implementations that ship with the component. (The discovery process is also covered in more
+detail there.)
+
+