[weld-commits] Weld SVN: r4233 - api/trunk/cdi/src/main/java/javax/decorator.

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-10-23 01:58:36 -0400 (Fri, 23 Oct 2009)
New Revision: 4233

Modified:
   api/trunk/cdi/src/main/java/javax/decorator/Decorator.java
   api/trunk/cdi/src/main/java/javax/decorator/package-info.java
Log:
javadoc the decorator package

Modified: api/trunk/cdi/src/main/java/javax/decorator/Decorator.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/decorator/Decorator.java	2009-10-23 05:52:26 UTC (rev 4232)
+++ api/trunk/cdi/src/main/java/javax/decorator/Decorator.java	2009-10-23 05:58:36 UTC (rev 4233)
@@ -51,10 +51,10 @@
  * for instance passivation and conversational state defined by the 
  * EJB specification.</p>
  * 
- * A decorator may be an abstract Java class, and is not required 
- * to implement every method of every decorated type.
+ * <p>A decorator may be an abstract class, and is not required to 
+ * implement every method of every decorated type.</p>
  *  
- * The decorator intercepts every method: 
+ * <p>A decorator intercepts every method:</p>
  * <ul>
  * <li>declared by a decorated type of the decorator</li>
  * <li>that is implemented by the bean class of the decorator.</li>

Modified: api/trunk/cdi/src/main/java/javax/decorator/package-info.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/decorator/package-info.java	2009-10-23 05:52:26 UTC (rev 4232)
+++ api/trunk/cdi/src/main/java/javax/decorator/package-info.java	2009-10-23 05:58:36 UTC (rev 4233)
@@ -7,6 +7,16 @@
  * conversely, unable to implement the cross-cutting concerns 
  * for which interceptors are optimized.</p>
  * 
+ * <p>By default, a bean deployment archive has no enabled 
+ * decorators. A decorator must be explicitly enabled by listing 
+ * its bean class under the <tt>&lt;decorators&gt;</tt> element 
+ * of the <tt>beans.xml</tt> file of the bean deployment archive. 
+ * The order of the decorator declarations determines the decorator 
+ * ordering. Decorators which occur earlier in the list are called 
+ * first.</p>
+ * 
+ * <p>Decorators are called after interceptors.</p>
+ * 
  */
 package javax.decorator;