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

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-10-26 13:34:51 -0400 (Mon, 26 Oct 2009)
New Revision: 4337

Modified:
   api/trunk/cdi/src/main/java/javax/enterprise/inject/Specializes.java
Log:
improve

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/Specializes.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/Specializes.java	2009-10-26 17:27:40 UTC (rev 4336)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/Specializes.java	2009-10-26 17:34:51 UTC (rev 4337)
@@ -30,9 +30,15 @@
  * May be applied to a bean class or producer method.</p>
  * 
  * <p>If a bean directly specializes a second bean, it
- * inherits all qualifiers of the second bean, and has the
- * same name as the second bean. If the second bean has
- * a name, the bean may not declare a name using
+ * inherits:</p>
+ * 
+ * <ul>
+ * <li>all qualifiers of the second bean, and</li>
+ * <li>the name, if any, of the second bean.</li>
+ * </ul>
+ * 
+ * <p>If the second bean has a name, the bean may not 
+ * declare a name using
  * {@link javax.inject.Named &#064;Named}. Furthermore, 
  * the bean must have all the bean types of the second
  * bean.</p>
@@ -57,6 +63,9 @@
  * producer method.</li>
  * </ul>
  * 
+ * <p>If a bean is specialized by any enabled bean, the
+ * first bean is disabled.</p>
+ * 
  * @author Gavin King
  * @author Pete Muir
  */