Additional doc for uri_for to illustrate passing an action and captures (jhannah)

diff --git a/Changes b/Changes
index 5dafda1..2a10932 100644 (file)
--- a/Changes
+++ b/Changes
@@ -6,6 +6,8 @@
         - Added test for component instances getting $self->{value} from config.
         - Add Catalyst::Response->print() method (ilmari)
         - Optionally aggregate tests using Test::Aggregate (Florian Ragwitz).
+        - Additional docs for uri_for to mention how to use $c->action and 
+          $c->req->captures (jhannah)
 
 5.7XXXXXX XXXX
         - Fix some Win32 test failures

diff --git a/lib/Catalyst.pm b/lib/Catalyst.pm
index bfbf763..a09747a 100644 (file)
--- a/lib/Catalyst.pm
+++ b/lib/Catalyst.pm
@@ -1011,6 +1011,15 @@ C<< $c->dispatcher->uri_for_action >>; if the first element of
 C<@args> is an arrayref it is treated as a list of captures to be passed
 to C<uri_for_action>.
 
+You can maintain the arguments captured by an action (e.g.: Regex, Chained)
+using C<< $c->req->captures >>. 
+
+  # For the current action
+  $c->uri_for($c->action, $c->req->captures);
+  
+  # For the Foo action in the Bar controller
+  $c->uri_for($c->controller->('Bar')->action_for('Foo'), $c->req->captures);
+
 =cut
 
 sub uri_for {