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