commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rdon...@apache.org
Subject svn commit: r371403 - in /jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging: LogFactory.java impl/Jdk13LumberjackLogger.java impl/LogFactoryImpl.java impl/ServletContextCleaner.java impl/WeakHashtable.java
Date Sun, 22 Jan 2006 22:07:36 GMT
Author: rdonkin
Date: Sun Jan 22 14:07:31 2006
New Revision: 371403

URL: http://svn.apache.org/viewcvs?rev=371403&view=rev
Log:
Added @since tags as recommended in the release best practices document.

Modified:
    jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/LogFactory.java
    jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/Jdk13LumberjackLogger.java
    jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/LogFactoryImpl.java
    jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/ServletContextCleaner.java
    jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/WeakHashtable.java

Modified: jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/LogFactory.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/LogFactory.java?rev=371403&r1=371402&r2=371403&view=diff
==============================================================================
--- jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/LogFactory.java
(original)
+++ jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/LogFactory.java
Sun Jan 22 14:07:31 2006
@@ -685,6 +685,7 @@
      * just disable all commons-logging? Not high priority though - as stated
      * above, security policies that prevent classloader access aren't common.
      * 
+     * @since 1.1
      */
     protected static ClassLoader getClassLoader(Class clazz) {
         try {
@@ -746,6 +747,7 @@
      * @exception SecurityException if the java security policy forbids
      * access to the context classloader from one of the classes in the
      * current call stack. 
+     * @since 1.1
      */
     protected static ClassLoader directGetContextClassLoader()
         throws LogConfigurationException
@@ -910,6 +912,7 @@
      *
      * @exception LogConfigurationException if a suitable instance
      *  cannot be created
+     * @since 1.1
      */
     protected static LogFactory newFactory(final String factoryClass,
                                            final ClassLoader classLoader,
@@ -965,6 +968,7 @@
      * @param classLoader
      * 
      * @return either a LogFactory object or a LogConfigurationException object.
+     * @since 1.1
      */
     protected static Object createFactory(String factoryClass, ClassLoader classLoader) {
 
@@ -1270,6 +1274,7 @@
      * areDiagnosticsEnabled just isn't java beans style.
      * 
      * @return true if calls to logDiagnostic will have any effect.
+     * @since 1.1
      */
     protected static boolean isDiagnosticsEnabled() {
         return diagnosticsStream != null;
@@ -1305,6 +1310,7 @@
      * Write the specified message to the internal logging destination.
      * 
      * @param msg is the diagnostic message to be output.
+     * @since 1.1
      */
     protected static final void logRawDiagnostic(String msg) {
         if (diagnosticsStream != null) {
@@ -1395,6 +1401,7 @@
      * 
      * @param o may be null.
      * @return a string of form classname@hashcode, or "null" if param o is null.
+     * @since 1.1
      */
     public static String objectId(Object o) {
         if (o == null) {

Modified: jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/Jdk13LumberjackLogger.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/Jdk13LumberjackLogger.java?rev=371403&r1=371402&r2=371403&view=diff
==============================================================================
--- jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/Jdk13LumberjackLogger.java
(original)
+++ jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/Jdk13LumberjackLogger.java
Sun Jan 22 14:07:31 2006
@@ -39,6 +39,7 @@
  * @author <a href="mailto:donaldp@apache.org">Peter Donald</a>
  * @author <a href="mailto:vince256@comcast.net">Vince Eagen</a>
  * @version $Revision$ $Date$
+ * @since 1.1
  */
 
 public class Jdk13LumberjackLogger implements Log, Serializable {

Modified: jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/LogFactoryImpl.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/LogFactoryImpl.java?rev=371403&r1=371402&r2=371403&view=diff
==============================================================================
--- jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/LogFactoryImpl.java
(original)
+++ jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/LogFactoryImpl.java
Sun Jan 22 14:07:31 2006
@@ -397,6 +397,7 @@
     /**
      * Gets the context classloader.
      * This method is a workaround for a java 1.2 compiler bug.
+     * @since 1.1
      */
     protected static ClassLoader getContextClassLoader() throws LogConfigurationException
{
         return LogFactory.getContextClassLoader();
@@ -415,6 +416,7 @@
     /**
      * Workaround for bug in Java1.2; in theory this method is not needed.
      * See LogFactory.getClassLoader.
+     * @since 1.1
      */
     protected static ClassLoader getClassLoader(Class clazz) {
         return LogFactory.getClassLoader(clazz);
@@ -453,7 +455,8 @@
      * Output a diagnostic message to a user-specified destination (if the
      * user has enabled diagnostic logging).
      * 
-     * @param msg
+     * @param msg diagnostic message
+     * @since 1.1
      */
     protected void logDiagnostic(String msg) {
         if (isDiagnosticsEnabled()) {

Modified: jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/ServletContextCleaner.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/ServletContextCleaner.java?rev=371403&r1=371402&r2=371403&view=diff
==============================================================================
--- jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/ServletContextCleaner.java
(original)
+++ jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/ServletContextCleaner.java
Sun Jan 22 14:07:31 2006
@@ -48,6 +48,8 @@
  * this class on webapp undeploy; the contextDestroyed method will tell
  * LogFactory that the entry in its map for the current webapp's context
  * classloader should be cleared.
+ * 
+ * @since 1.1
  */
 
 public class ServletContextCleaner implements ServletContextListener {

Modified: jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/WeakHashtable.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/WeakHashtable.java?rev=371403&r1=371402&r2=371403&view=diff
==============================================================================
--- jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/WeakHashtable.java
(original)
+++ jakarta/commons/proper/logging/trunk/src/java/org/apache/commons/logging/impl/WeakHashtable.java
Sun Jan 22 14:07:31 2006
@@ -116,6 +116,8 @@
  *
  *
  * @author Brian Stansberry
+ * 
+ * @since 1.1
  */
 public final class WeakHashtable extends Hashtable {
 



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message