[jboss-cvs] jboss-seam/doc/reference/en/modules ...

[Peter Muir]

  User: pmuir   
  Date: 07/12/26 16:18:38

  Modified:    doc/reference/en/modules  annotations.xml
  Log:
  Add @PerNestedConversation
  
  Revision  Changes    Path
  1.74      +14 -0     jboss-seam/doc/reference/en/modules/annotations.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: annotations.xml
  ===================================================================
  RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/annotations.xml,v
  retrieving revision 1.73
  retrieving revision 1.74
  diff -u -b -r1.73 -r1.74
  --- annotations.xml	16 Oct 2007 14:53:54 -0000	1.73
  +++ annotations.xml	26 Dec 2007 21:18:38 -0000	1.74
  @@ -104,6 +104,20 @@
                           the component may be called unless a long-running conversation is active. </para>
                   </listitem>
               </varlistentry>
  +            <varlistentry id="pernestedconversation-annotation">
  +                <term>
  +                    <literal>@PerNestedConversation</literal>
  +                </term>
  +                <listitem>
  +                    <programlisting><![CDATA[@PerNestedConversation]]></programlisting>
  +                    <para>Limits the scope of a CONVERSATION-scoped component to just the parent conversation in which 
  +                        it was instantiated. The component instance will not be visible to nested child conversations, 
  +                        which will get their own instance.</para>
  +                    <para>Warning: this is ill-defined, since it implies that a component will be visible for some 
  +                        part of a request cycle, and invisible after that. It is not recommended that applications
  +                        use this feature!</para>
  +                </listitem>
  +            </varlistentry>
               <varlistentry id="startup-annotation">
                   <term>
                       <literal>@Startup</literal>