[weld-commits] Weld SVN: r5062 - doc/trunk/reference/en-US.

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-11-15 18:52:05 -0500 (Sun, 15 Nov 2009)
New Revision: 5062

Modified:
   doc/trunk/reference/en-US/producermethods.xml
Log:
helpful note

Modified: doc/trunk/reference/en-US/producermethods.xml
===================================================================
--- doc/trunk/reference/en-US/producermethods.xml	2009-11-15 16:55:53 UTC (rev 5061)
+++ doc/trunk/reference/en-US/producermethods.xml	2009-11-15 23:52:05 UTC (rev 5062)
@@ -92,6 +92,16 @@
             same producer method. Thus, there could be multiple instances of the <literal>PaymentStrategy</literal>
             object for each user session.
          </para>
+         
+         <note>
+            <para>
+               The producer method does <emphasis>not</emphasis> inherit the scope of the bean that declares the 
+               method. There are two different beans here: the producer method, and the bean which declares it. The 
+               scope of the producer method determines how often the method will be called, and the lifecycle of the 
+               objects returned by the method. The scope of the bean that declares the producer method determines the
+               lifecycle of the object upon which the producer method is invoked.
+            </para>
+         </note>
 
          <para>
             To change this behavior, we can add a <literal>@SessionScoped</literal> annotation to the method.