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=c4460146a4ede6fd7aa9cd3bf16adb4029c9a78b;hpb=e178a66a280ae154d84488ddce8aa85599a32ac2;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Manual/Intro.pod b/lib/Catalyst/Manual/Intro.pod index c446014..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? @@ -143,7 +144,7 @@ running, using the helper scripts described above. =head3 Install - $ perl -MCPAN -e 'install Bundle::Catalyst' + $ perl -MCPAN -e 'install Task::Catalyst' =head3 Setup @@ -448,7 +449,7 @@ controller it's in. C is much like C except that it takes no arguments and it is weighted slightly higher in the matching process. It is useful as a static entry point to a controller, e.g. to have a static -welcome page. +welcome page. Note that it's also weighted higher than Path. =item * B @@ -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.