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

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-10-28 19:14:16 -0400 (Wed, 28 Oct 2009)
New Revision: 4365

Modified:
   api/trunk/cdi/src/main/java/javax/enterprise/event/package-info.java
Log:
add a bit

Modified: api/trunk/cdi/src/main/java/javax/enterprise/event/package-info.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/event/package-info.java	2009-10-28 22:55:36 UTC (rev 4364)
+++ api/trunk/cdi/src/main/java/javax/enterprise/event/package-info.java	2009-10-28 23:14:16 UTC (rev 4365)
@@ -55,6 +55,13 @@
  * <li>the observer method has all the event qualifiers of the event.</li>
  * </ul>
  * 
+ * <p>If the observer method is a 
+ * {@linkplain javax.enterprise.event.TransactionPhase transactional 
+ * observer method} and there is a JTA transaction in progress when the
+ * event is fired, the observer method is notified during the appropriate 
+ * transaction completion phase. Otherwise, the observer is notified when 
+ * the event is fired.</p>
+ * 
  * <p>The order in which observer methods are called is not defined, and 
  * so portable applications should not rely upon the order in which 
  * observers are called.</p>