[weld-commits] Weld SVN: r4286 - api/trunk/cdi/src/main/java/javax/enterprise/event.
Author: gavin.king(a)jboss.com
Date: 2009-10-25 00:42:05 -0400 (Sun, 25 Oct 2009)
New Revision: 4286
Modified:
api/trunk/cdi/src/main/java/javax/enterprise/event/Reception.java
Log:
better
Modified: api/trunk/cdi/src/main/java/javax/enterprise/event/Reception.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/event/Reception.java 2009-10-25 04:39:28
UTC (rev 4285)
+++ api/trunk/cdi/src/main/java/javax/enterprise/event/Reception.java 2009-10-25 04:42:05
UTC (rev 4286)
@@ -17,10 +17,17 @@
package javax.enterprise.event;
/**
- * An enumeration that is used to declare the condition under which an observer
- * method should be called. The default behavior is to create the bean and
- * invoke the observer method synchronously.
+ * <p>Distinguishes conditional observer methods from observer methods
+ * which are always notified.</p>
*
+ * <p>A conditional observer method is an observer method which is notified
+ * of an event only if an instance of the bean that defines the observer
+ * method already exists in the current context.</p>
+ *
+ * <p>Beans with scope
+ * {@link javax.enterprise.context.Dependent @Dependent} may not
+ * have conditional observer methods.</p>
+ *
* @author Gavin King
* @author Dan Allen
* @author David Allen
@@ -34,7 +41,7 @@
IF_EXISTS,
/**
- * Specifies that an observer method always receives the event notifications.
+ * Specifies that an observer method always receives event notifications.
*/
ALWAYS
}
\ No newline at end of file