X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Manual.git;a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FCookbook.pod;h=a550208b3b65c9b434fbc0eefa1a7f0e44224ae8;hp=7e8bcf97a91807d1429af9423c96047a9b9725cd;hb=429d1caf111575afa4c25287cc48d7ed712af327;hpb=5abded07e91219302e0536d98c9a0d5e5fd58e13 diff --git a/lib/Catalyst/Manual/Cookbook.pod b/lib/Catalyst/Manual/Cookbook.pod index 7e8bcf9..a550208 100644 --- a/lib/Catalyst/Manual/Cookbook.pod +++ b/lib/Catalyst/Manual/Cookbook.pod @@ -1,3 +1,5 @@ +=encoding utf8 + =head1 NAME Catalyst::Manual::Cookbook - Cooking with Catalyst @@ -68,7 +70,7 @@ Normally you enable the debugging info by adding the C<-Debug> flag to your C statement . However, you can also enable it using environment variable, so you can (for example) get debug info without modifying your application scripts. Just set C or -CMYAPPE_DEBUG> to a true value. +C<< _DEBUG >> to a true value. =head2 Sessions @@ -110,7 +112,7 @@ retrieve the user data for you. =head3 Using a session Once the session modules are loaded, the session is available as C<< -$c->session >>, and can be writen to and read from as a simple hash +$c->session >>, and can be written to and read from as a simple hash reference. =head3 EXAMPLE @@ -215,6 +217,10 @@ This is equivalent to: # configure email sending __PACKAGE__->config( email => [qw/SMTP localhost/] ); +L explains precedence of multiple sources for configuration +values, how to access the values in your components, and many 'base' +config variables used internally. + See also L. =head1 Skipping your VCS's directories @@ -845,7 +851,7 @@ organization provided makes it much easier to standardize pages and make changes when they are (inevitably) needed. The template files that you will create for your application will go -into root/src, and you don't need to worry about putting the the +into root/src, and you don't need to worry about putting the or sections; just put in the content. The WRAPPER will the rest of the page around your template for you. @@ -1419,13 +1425,13 @@ And in the controller: $c->stash->{template} = 'file_upload.html'; } -Creq->upload)> loops automatically over all file +C<< for my $field ($c->req->upload) >> loops automatically over all file input fields and gets input names. After that is basic file saving code, just like in single file upload. Notice: Cing might not be what you want to do, when an error occurs, but it works as an example. A better idea would be to store -error C<$!> in $c->stash->{error} and show a custom error template +error C<$!> in C<< $c->stash->{error} >> and show a custom error template displaying this message. For more information about uploads and usable methods look at @@ -1619,7 +1625,7 @@ static content to the view, perhaps like this: This code will only forward to the view if a template has been previously defined by a controller and if there is not already data in -C<$c-Eres-Ebody>. +C<< $c->res->body >>. Next, create a controller to handle requests for the /static path. Use the Helper to save time. This command will create a stub controller as