[slf4j-dev] svn commit: r230 - slf4j/trunk/src/filtered-java/org/slf4j/impl

[ceki]

Author: ceki
Date: Sun Aug 28 18:01:09 2005
New Revision: 230

Modified:
   slf4j/trunk/src/filtered-java/org/slf4j/impl/StaticBinder.java
Log:
javadoc improvements

Modified: slf4j/trunk/src/filtered-java/org/slf4j/impl/StaticBinder.java
==============================================================================
--- slf4j/trunk/src/filtered-java/org/slf4j/impl/StaticBinder.java      
(original)
+++ slf4j/trunk/src/filtered-java/org/slf4j/impl/StaticBinder.java      Sun Aug 
28 18:01:09 2005
@@ -33,28 +33,36 @@
 
 package org.slf4j.impl;
 
+import org.slf4j.LoggerFactory;
+import org.slf4j.MarkerFactory;
 import org.slf4j.ILoggerFactory;
 import org.slf4j.IMarkerFactory;
 import org.slf4j.spi.LoggerFactoryBinder;
 import org.slf4j.spi.MarkerFactoryBinder;
 
-//WARNING
-//WARNING Modifications MUST be made to the original file found at
-//WARNING $SLF4J_HOME/src/filtered-java/org/slf4j/StaticBinder.java
-//WARNING
-
+/**
+ * 
+ * The binding of [EMAIL PROTECTED] LoggerFactory} class with an actual 
instance of 
+ * [EMAIL PROTECTED] ILoggerFactory} is performed using information returned 
by this class. 
+ * 
+ * This class also contains the information for binding [EMAIL PROTECTED] 
MarkerFactory}
+ * with the appropriate [EMAIL PROTECTED] IMarkerFactory} instance.
+ * 
+ * @author <a href="http://www.qos.ch/log4j/";>Ceki G&uuml;lc&uuml;</a>
+ */
 public class StaticBinder implements LoggerFactoryBinder, MarkerFactoryBinder {
 
+  /**
+   * The unique instance of this class.
+   */
+  public static final StaticBinder SINGLETON = new StaticBinder();
   
-  // 
-  // WARNING Do not modify copies, instead modify the original in 
-  //         $SLF4J_HOME/src/filtered-java/org/slf4j/
-  //  
+  private StaticBinder() {
+  }
   
   // Note: @IMPL@ gets substituted at build time by an appropriate Ant task
-  String loggerFactoryClassStr ="[EMAIL PROTECTED]@LoggerFactory";
+  static final String loggerFactoryClassStr ="[EMAIL PROTECTED]@LoggerFactory";
   
-  // package private
   public ILoggerFactory getLoggerFactory() {
     // Note: @IMPL@ gets substituted at build time by an appropriate Ant task
     return new [EMAIL PROTECTED]@LoggerFactory();
@@ -64,10 +72,18 @@
     return loggerFactoryClassStr;
   }   
   
+  /**
+   * Currently this method always returns an instance of 
+   * [EMAIL PROTECTED] BasicMarkerFactory}.
+   */
   public IMarkerFactory getMarkerFactory() {
     return new BasicMarkerFactory();
   }
   
+  /**
+   * Currrently, this method returns the class name of
+   * [EMAIL PROTECTED] BasicMarkerFactory}.
+   */
   public String getMarkerFactoryClassStr() {
     return BasicMarkerFactory.class.getName();
   }
_______________________________________________
dev mailing list
dev@slf4j.org
http://slf4j.org/mailman/listinfo/dev