logging-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ggreg...@apache.org
Subject svn commit: r1404445 - /logging/log4j/log4j2/trunk/core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationFactory.java
Date Thu, 01 Nov 2012 01:50:00 GMT
Author: ggregory
Date: Thu Nov  1 01:50:00 2012
New Revision: 1404445

URL: http://svn.apache.org/viewvc?rev=1404445&view=rev
Log:
Pretty up the Javadoc.

Modified:
    logging/log4j/log4j2/trunk/core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationFactory.java

Modified: logging/log4j/log4j2/trunk/core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationFactory.java
URL: http://svn.apache.org/viewvc/logging/log4j/log4j2/trunk/core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationFactory.java?rev=1404445&r1=1404444&r2=1404445&view=diff
==============================================================================
--- logging/log4j/log4j2/trunk/core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationFactory.java
(original)
+++ logging/log4j/log4j2/trunk/core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationFactory.java
Thu Nov  1 01:50:00 2012
@@ -40,19 +40,26 @@ import java.util.Set;
 import java.util.TreeSet;
 
 /**
- * ConfigurationFactory allows the configuration implementation to be dynamically chosen
in 1
- * of 3 ways:
- * 1. A system property named "log4j.configurationFactory" can be set with the name of the
- * ConfigurationFactory to be used.
- * 2. setConfigurationFactory can be called with the instance of the ConfigurationFactory
to
- * be used. This must be called before any other calls to Log4j.
- * 3. A ConfigurationFactory implementation can be added to the classpath and configured
as a
- * plugin. The Order annotation should be used to configure the factory to be the first one
- * inspected. See XMLConfigurationFactory for an example.
- *
- * If the ConfigurationFactory that was added returns null on a call to getConfiguration
the
- * any other ConfigurationFactories found as plugins will be called in their respective order.
- * DefaultConfiguration is always called last if no configuration has been returned.
+ * ConfigurationFactory allows the configuration implementation to be
+ * dynamically chosen in 1 of 3 ways:
+ * <ol>
+ * <li>A system property named "log4j.configurationFactory" can be set with the
+ * name of the ConfigurationFactory to be used.</li>
+ * <li>
+ * {@linkplain #setConfigurationFactory(ConfigurationFactory)} can be called
+ * with the instance of the ConfigurationFactory to be used. This must be called
+ * before any other calls to Log4j.</li>
+ * <li>
+ * A ConfigurationFactory implementation can be added to the classpath and
+ * configured as a plugin. The Order annotation should be used to configure the
+ * factory to be the first one inspected. See
+ * {@linkplain XMLConfigurationFactory} for an example.</li>
+ * </ol>
+ * 
+ * If the ConfigurationFactory that was added returns null on a call to
+ * getConfiguration the any other ConfigurationFactories found as plugins will
+ * be called in their respective order. DefaultConfiguration is always called
+ * last if no configuration has been returned.
  */
 public abstract class ConfigurationFactory {
     /**



Mime
View raw message