[Catalyst-commits] r9908 - Catalyst-Manual/5.70/trunk/lib/Catalyst/Manual

[ijw at dev.catalyst.perl.org]

Author: ijw
Date: 2009-04-28 10:12:29 +0100 (Tue, 28 Apr 2009)
New Revision: 9908

Modified:
   Catalyst-Manual/5.70/trunk/lib/Catalyst/Manual/Intro.pod
Log:
More Intro cleanup, specifically adding a comment on what missing out :Args means

Modified: Catalyst-Manual/5.70/trunk/lib/Catalyst/Manual/Intro.pod
===================================================================
--- Catalyst-Manual/5.70/trunk/lib/Catalyst/Manual/Intro.pod	2009-04-28 08:53:13 UTC (rev 9907)
+++ Catalyst-Manual/5.70/trunk/lib/Catalyst/Manual/Intro.pod	2009-04-28 09:12:29 UTC (rev 9908)
@@ -870,7 +870,7 @@
 
 Use whichever makes the most sense for your application.
 
-=item * Changing handler behaviour: adding arguments (C<:Args>)
+=item * Changing handler behaviour: eating arguments (C<:Args>)
 
 Args is not an action type per se, but an action modifier - it adds a
 match restriction to any action it's provided to, additionally
@@ -886,6 +886,16 @@
 to only match URLs starting /foo/bar/* - with one additional path
 element required after 'bar'.
 
+NOTE that adding C<:Args(0)> and missing out :Args completely are B<not> 
+the same thing.
+
+C<:Args(0)> means that no arguments are taken.  Thus, the URL and path must 
+match precisely.
+
+No :Args at all means that B<any number> of arguments are taken.  Thus, any 
+URL that B<starts with> the controller's path will match.
+
+
 =item * Literal match (C<:Path>)
 
 C<Path> actions match things starting with a precise specified path,