[weld-commits] Weld SVN: r4367 - api/trunk/cdi/src/main/java/javax/enterprise/inject.

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-10-28 22:15:21 -0400 (Wed, 28 Oct 2009)
New Revision: 4367

Modified:
   api/trunk/cdi/src/main/java/javax/enterprise/inject/AnnotationLiteral.java
   api/trunk/cdi/src/main/java/javax/enterprise/inject/Nonbinding.java
   api/trunk/cdi/src/main/java/javax/enterprise/inject/TypeLiteral.java
Log:
generalize the documentation

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/AnnotationLiteral.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/AnnotationLiteral.java	2009-10-29 01:52:15 UTC (rev 4366)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/AnnotationLiteral.java	2009-10-29 02:15:21 UTC (rev 4367)
@@ -41,9 +41,6 @@
  * PayBy payby = new PayByQualifier() { public value() { return CHEQUE; } };
  * </pre>
  * 
- * <p>Annotation values are often passed to APIs that perform typesafe 
- * resolution.</p>
- * 
  * @author Pete Muir
  * @author Gavin King
  * 

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/Nonbinding.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/Nonbinding.java	2009-10-29 01:52:15 UTC (rev 4366)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/Nonbinding.java	2009-10-29 02:15:21 UTC (rev 4367)
@@ -24,8 +24,11 @@
 import java.lang.annotation.Target;
 
 /**
- * <p>Excludes a member of a qualifier type or interceptor binding type 
- * from consideration by the resolution algorithms.</p>
+ * <p>Excludes a member of an annotation type (such as a 
+ * {@linkplain javax.inject.Qualifier qualifier type} or
+ * {@linkplain javax.interceptor interceptor binding type})
+ * from consideration when the container compares two
+ * annotation instances.</p>
  * 
  * <pre>
  * &#064;Qualifier
@@ -37,11 +40,11 @@
  * }
  * </pre>
  * 
- * <p>Array-valued or annotation-valued members of a qualifier type should be 
- * annotated <tt>&#064;Nonbinding</tt> in a portable application.</p>
- * 
  * @author Gavin King
  * 
+ * @see javax.inject.Qualifier &#064;Qualifier
+ * @see javax.interceptor.InterceptorBinding &#064;InterceptorBinding
+ * 
  */
 @Retention(RUNTIME)
 @Target(METHOD)

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/TypeLiteral.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/TypeLiteral.java	2009-10-29 01:52:15 UTC (rev 4366)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/TypeLiteral.java	2009-10-29 02:15:21 UTC (rev 4367)
@@ -26,14 +26,12 @@
  * with actual type parameters.</p>
  * 
  * <p>An object that represents any parameterized type may be obtained by 
- * subclassing <tt>TypeLiteral</tt>.
+ * subclassing <tt>TypeLiteral</tt>.</p>
  * 
  * <pre>
  * TypeLiteral&lt;List&lt;String&gt;&gt; type = new TypeLiteral&lt;List&lt;String&gt;&gt;() {};
  * </pre>
  * 
- * <p>This object may be passed to APIs that perform typesafe resolution.</p>
- * 
  * @author Gavin King
  * @author Pete Muir
  *