Author: gavin.king(a)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 *