[weld-commits] Weld SVN: r4286 - api/trunk/cdi/src/main/java/javax/enterprise/event.

[weld-commits at lists.jboss.org]

Author: gavin.king at 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 &#064;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