Author: shane.bryzak(a)jboss.com
Date: 2008-11-11 22:57:33 -0500 (Tue, 11 Nov 2008)
New Revision: 9557
Modified:
trunk/doc/Seam_Reference_Guide/en-US/Events.xml
Log:
JBSEAM-3558
Modified: trunk/doc/Seam_Reference_Guide/en-US/Events.xml
===================================================================
--- trunk/doc/Seam_Reference_Guide/en-US/Events.xml 2008-11-12 03:00:50 UTC (rev 9556)
+++ trunk/doc/Seam_Reference_Guide/en-US/Events.xml 2008-11-12 03:57:33 UTC (rev 9557)
@@ -1174,7 +1174,21 @@
session expiration if you are inside a conversation.
</para>
</section>
-
- </section>
+ </section>
+
+ <section>
+ <title>conversation-required</title>
+
+ <para>
+ When specified as the attribute of a <literal>page</literal>
element in <literal>pages.xml</literal>,
+ this setting controls whether a page requires an active long-running or nested
conversation before
+ being rendered. If there is not an active long-running or nested conversation
when trying to access
+ the page, you will be redirected to the
<literal>no-conversation-view-id</literal> view (which is specified
+ in the root <literal>pages</literal> element) instead.
+ </para>
+
+ <programlisting><![CDATA[ <page view-id="/foo.xhtml"
conversation-required="true"/>]]></programlisting>
+
+ </section>
</chapter>