X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FIntro.pod;h=774712258902ba4f161407f11805444abefe265f;hb=670b3d7854bd1650782942636bc133da91e92ab6;hp=e8b1c8671815ae12b0f04338269505a05fefb963;hpb=61a9002d77ce79bc038b3ec6212e275015801594;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Manual/Intro.pod b/lib/Catalyst/Manual/Intro.pod index e8b1c86..7747122 100644 --- a/lib/Catalyst/Manual/Intro.pod +++ b/lib/Catalyst/Manual/Intro.pod @@ -4,9 +4,10 @@ Catalyst::Manual::Intro - Introduction to Catalyst =head1 DESCRIPTION -This is a brief overview of why and how to use Catalyst. It explains how -Catalyst works and shows how to get a simple application up and running -quickly. +This is a brief introduction to Catalyst. It explains the most important +features of how Catalyst works and shows how to get a simple application +up and running quickly. For an introduction (without code) to Catalyst +itself, and why you should be using it, see L. =head2 What is Catalyst? @@ -538,11 +539,10 @@ stage, without processing further actions. =head4 URL Path Handling -You can pass variable arguments as part of the URL path. In this case, -you must use regex action keys with '^' and '$' anchors, and the -arguments must be separated with forward slashes (/) in the URL. For -example, suppose you want to handle C, where C<$bar> and -C<$baz> may vary: +You can pass variable arguments as part of the URL path, separated with +forward slashes (/). If the action is a Regex or LocalRegex, the '$' anchor +must be used. For example, suppose you want to handle C, +where C<$bar> and C<$baz> may vary: sub foo : Regex('^foo$') { my ($self, $context, $bar, $baz) = @_; } @@ -560,6 +560,10 @@ Catalyst matches actions in most specific to least specific order: So Catalyst would never mistakenly dispatch the first two URLs to the '^foo$' action. +If a Regex or LocalRegex action doesn't use the '$' anchor, the action will +still match a URL containing arguments, however the arguments won't be +available via C<@_>. + =head4 Parameter Processing Parameters passed in the URL query string are handled with methods in @@ -915,5 +919,5 @@ Danijel Milicevic, C =head1 COPYRIGHT -This program is free software, you can redistribute it and/or modify it under -the same terms as Perl itself. +This program is free software, you can redistribute it and/or modify it +under the same terms as Perl itself.