Documented auto/forward/detach behaviour for chains in Intro

r10133@cain (orig r4426):  phaylon | 2006-06-20 20:28:25 +0000

diff --git a/lib/Catalyst/Manual/Intro.pod b/lib/Catalyst/Manual/Intro.pod
index 91fc76e..fe9ac8d 100644 (file)
--- a/lib/Catalyst/Manual/Intro.pod
+++ b/lib/Catalyst/Manual/Intro.pod
@@ -651,6 +651,15 @@ C<$c-E<gt>request-E<gt>arguments>.
 
 =back
 
+Note that the list of C<auto> actions called depends on the private path
+of the endpoint of the chain, not on the chained actions way. The C<auto>
+actions will be run before the chain dispatching begins. In every other
+aspect, C<auto> actions behave as documented.
+
+The C<forward>ing to other actions does just what you would expect. But if
+you C<detach> out of a chain, the rest of the chain will not get called
+after the C<detach> returned.
+
 =item * B<Top-level> (B<Global>)
 
     package MyApp::Controller::Foo;