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

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-10-26 10:03:12 -0400 (Mon, 26 Oct 2009)
New Revision: 4324

Modified:
   api/trunk/cdi/src/main/java/javax/enterprise/context/NormalScope.java
Log:
def passivating scope

Modified: api/trunk/cdi/src/main/java/javax/enterprise/context/NormalScope.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/context/NormalScope.java	2009-10-26 09:46:00 UTC (rev 4323)
+++ api/trunk/cdi/src/main/java/javax/enterprise/context/NormalScope.java	2009-10-26 14:03:12 UTC (rev 4324)
@@ -29,8 +29,9 @@
  * 
  * @author Gavin King
  * @author Pete Muir
+ * 
+ * @see javax.inject.Scope @Scope is used to declare pseudo-scopes.
  */
-
 @Target(ANNOTATION_TYPE)
 @Retention(RUNTIME)
 @Documented
@@ -38,8 +39,14 @@
 {
    
    /**
-    * @return true if this is a passivating scope type (if beans with 
-    * this scope type must be serializable)
+    * <p>Determines whether the normal scope type is a passivating scope.</p>
+    * 
+    * <p>A bean is called passivation capable if the container is able to 
+    * temporarily transfer the state of any idle instance to secondary 
+    * storage. A passivating scope requires that beans with the scope are 
+    * passivation capable.</p>
+    * 
+    * @return <tt>true</tt> if the scope type is a passivating scope type
     */
    boolean passivating() default false;