From: Ian Wells <ijw@cack.org.uk>
Date: Tue, 28 Apr 2009 09:12:29 +0000 (+0000)
Subject: More Intro cleanup, specifically adding a comment on what missing out :Args means
X-Git-Tag: v5.8005~167
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Manual.git;a=commitdiff_plain;h=845ef40515e6cfbdfb8c6b53a5872fb216225feb

More Intro cleanup, specifically adding a comment on what missing out :Args means
---

diff --git a/lib/Catalyst/Manual/Intro.pod b/lib/Catalyst/Manual/Intro.pod
index 3538185..a15f7d1 100644
--- a/lib/Catalyst/Manual/Intro.pod
+++ b/lib/Catalyst/Manual/Intro.pod
@@ -870,7 +870,7 @@ the namespace.
 
 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 @@ would match any URL starting /foo/bar. To restrict this you can do
 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,