[weld-commits] Weld SVN: r4404 - 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 12:27:25 -0400 (Thu, 29 Oct 2009)
New Revision: 4404

Modified:
   api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Extension.java
   api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/package-info.java
Log:
more on extensions

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Extension.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Extension.java	2009-10-29 16:11:40 UTC (rev 4403)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Extension.java	2009-10-29 16:27:25 UTC (rev 4404)
@@ -18,24 +18,25 @@
 package javax.enterprise.inject.spi;
 
 /**
- * <p>Service interface implemented by service providers that 
- * observe container lifecycle events. Service providers must
- * be declared in <tt>META-INF/services</tt></p>
+ * <p>Service interface implemented by extensions. An extension 
+ * is a service provider declared in <tt>META-INF/services</tt>.</p>
  * 
- * <p>The container instantiates a single instance of each 
- * service provider at the beginning of the application 
- * initialization process and maintains a reference to it until
- * the application shuts down.</p>
- *  
- * <p>Service providers may have observer methods, which may 
- * observe any event, including any container lifecycle event, 
+ * <p>Service providers may have 
+ * {@linkplain javax.enterprise.event.Observes observer methods}, 
+ * which may observe any event, including any 
+ * {@linkplain javax.enterprise.inject.spi container lifecycle event}, 
  * and obtain an injected 
  * {@link javax.enterprise.inject.spi.BeanManager}.<p>
  * 
+ * <p>The container instantiates a single instance of each 
+ * extension at the beginning of the application initialization 
+ * process and maintains a reference to it until the application 
+ * shuts down. The container delivers event notifications to this 
+ * instance by calling its observer methods.</p>
+ *  
  * <p>Service providers are made available for injection as beans
  * with the qualifier {@link javax.context.Default &#064;Default}.</p>
  * 
- * 
  * @author Gavin King
  * @author Pete Muir
  *

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/package-info.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/package-info.java	2009-10-29 16:11:40 UTC (rev 4403)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/package-info.java	2009-10-29 16:27:25 UTC (rev 4404)
@@ -55,11 +55,11 @@
  * <h3>Container lifecycle events</h3>
  * 
  * <p>During the application initialization process, the container fires 
- * a series of events, allowing portable extensions to integrate with the 
- * container initialization process. Observers of these events must be 
- * service providers of the service 
- * {@link javax.enterprise.inject.spi.Extension} declared in 
- * <tt>META-INF/services</tt>.</p>
+ * a series of {@linkplain javax.enterprise.event events}, allowing 
+ * portable extensions to integrate with the container initialization 
+ * process. Observer methods of these events must belong to
+ * {@linkplain javax.enterprise.inject.spi.Extension extensions} declared 
+ * in <tt>META-INF/services</tt>.</p>
  * 
  * @see javax.enterprise.inject
  * @see javax.enterprise.context.spi