Author: gavin.king(a)jboss.com Date: 2009-10-29 01:35:10 -0400 (Thu, 29 Oct 2009) New Revision: 4384 Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/InjectionTarget.java api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Producer.java Log: minor improvs Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/InjectionTarget.java =================================================================== --- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/InjectionTarget.java 2009-10-29 05:23:29 UTC (rev 4383) +++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/InjectionTarget.java 2009-10-29 05:35:10 UTC (rev 4384) @@ -33,13 +33,12 @@ /** * <p> - * Performs dependency injection upon the given object. First, the container - * performs Java EE component environment injection according to the - * semantics required by the Java EE platform specification. Next, it sets - * the value of all injected fields, and then calls all initializer methods. + * Performs dependency injection upon the given object. Performs Java EE + * component environment injection, sets the value of all injected fields, + * and calls all initializer methods. * </p> * - * @param instance The instance upon which to perform injections + * @param instance The instance upon which to perform injection * @param ctx The {@link javax.enterprise.context.spi.CreationalContext} to * use for creating new instances */ Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Producer.java =================================================================== --- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Producer.java 2009-10-29 05:23:29 UTC (rev 4383) +++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Producer.java 2009-10-29 05:35:10 UTC (rev 4384) @@ -39,9 +39,9 @@ * <p> * If the {@code Producer} represents a class, this will invoke the * constructor annotated {@link javax.inject.Inject} if it exists, or the - * constructor with no parameters. If the class has interceptors, produce() - * is responsible for building the interceptors and decorators of the - * instance. + * constructor with no parameters otherwise. If the class has interceptors, + * <tt>produce()</tt> is responsible for building the interceptors and + * decorators of the instance. * </p> * <p> * If the {@code Producer} represents a producer field or method, this will @@ -51,7 +51,7 @@ * * @param ctx The {@link javax.enterprise.context.spi.CreationalContext} to * use for the produced object - * @return an instance of the produced object + * @return the instance produced */ public T produce(CreationalContext<T> ctx); @@ -61,11 +61,14 @@ * </p> * <p> * If the {@code Producer} represents a class, then this operation does - * nothing. Otherwise, this calls the disposer method, if any, on a - * contextual instance of the bean that declares the disposer method or - * performs any additional required cleanup, if any, to destroy state - * associated with a resource. + * nothing. * </p> + * <p> + * If the {@code Producer} represents a producer field or method, this + * calls the disposer method, if any, on a contextual instance of the + * bean that declares the disposer method or performs any additional + * required cleanup, if any, to destroy state associated with a resource. + * </p> * * @param instance The instance to dispose */ @@ -73,7 +76,7 @@ /** * <p> - * Returns the set of all {@code InjectionPoints} for the producer. If the + * Returns the set of all {@code InjectionPoints}. If the * {@code Producer} represents a class, then this returns returns the set of * {@code InjectionPoint} objects representing all injected fields, bean * constructor parameters and initializer method parameters. For a producer