1 files changed, 17 insertions, 21 deletions
diff --git a/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Authentication.java b/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Authentication.java
index 03a5a4ac5e..2b18388c8b 100644
--- a/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Authentication.java
+++ b/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Authentication.java
@@ -1,5 +1,5 @@
 /*
- * Copyright(C) OASIS(R) 2005,2009. All Rights Reserved.
+ * Copyright(C) OASIS(R) 2005,2010. All Rights Reserved.
  * OASIS trademark, IPR and other policies apply.
  */
 package org.oasisopen.sca.annotation;
@@ -16,37 +16,33 @@ import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
 /**
- * Annotation denoting the intent that service operations require authentication.
- * <p/>
- * Applied to the injection site (field, method or constructor parameter) for a reference,
- * it indicates that all invocations through that reference require authentication.
- * <p/>
- * Applied to a interface method on a service contract, it indicates that all invocations
- * of that service operation require authentication; applied to the type of a service contract,
- * it indicates that all service operations on that interface require authentication.
- * <p/>
- * Applied to a method on an implementation class, it indicates that all invocations that
- * are dispatched to that implementation method (through any service) require authentication.
- * Applied to a interface implemented by an implementation class, it indicates that all
- * invocations that are dispatched to the implementation method for that interface operation
- * require authentication.
- * <p/>
- * Applied to an implementation class, it indicates that all invocations of that implementation
- * and that all invocations made by that implementation require authentication.
- *
- * @version $Rev$ $Date$
+ * The @Authentication annotation is used to indicate that the
+ * invocation requires authentication.
  */
 @Inherited
 @Target({TYPE, FIELD, METHOD, PARAMETER})
 @Retention(RUNTIME)
 @Intent(Authentication.AUTHENTICATION)
 public @interface Authentication {
+	/**
+	 * The serialized QName of the authentication policy intent,
+	 * for use with the SCA @Requires annotation.
+	 */
     String AUTHENTICATION = SCA_PREFIX + "authentication";
+    /**
+	 * The serialized QName of the authentication.message policy
+	 * intent, for use with the SCA @Requires annotation.
+	 */
     String AUTHENTICATION_MESSAGE = AUTHENTICATION + ".message";
+    /**
+	 * The serialized QName of the authentication.transport policy
+	 * intent, for use with the SCA @Requires annotation.
+	 */
     String AUTHENTICATION_TRANSPORT = AUTHENTICATION + ".transport";
 
     /**
-     * List of authentication qualifiers (such as "message" or "transport").
+     * List of authentication qualifiers (such as "message" 
+     * or "transport").
      *
      * @return authentication qualifiers
      */