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

[weld-commits at lists.jboss.org]

Author: gavin.king at 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