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=f31b41c2f368b451fc7d6f2f4c79bad68141913c;hp=5e279f02854cc7e46419903ae933202e25d6984b;hb=7dae18130c043bcdc2116dde364e545c89963368;hpb=19a5b486abf8b8b24c7b5f42b52b52e079081df1 diff --git a/lib/Catalyst/Manual/Cookbook.pod b/lib/Catalyst/Manual/Cookbook.pod index 5e279f0..f31b41c 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 @@ -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. @@ -1425,7 +1431,7 @@ 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 @@ -1748,7 +1754,7 @@ allows old entries to be automatically expired when they are no longer needed. =head3 Page Caching Another method of caching is to cache the entire HTML page. While this is -traditionally handled by a front-end proxy server like Squid, the Catalyst +traditionally handled by a frontend proxy server like Squid, the Catalyst PageCache plugin makes it trivial to cache the entire output from frequently-used or slow actions. @@ -1786,7 +1792,7 @@ Note that the page cache is keyed on the page URI plus all parameters, so requests for / and /?foo=bar will result in different cache items. Also, only GET requests will be cached by the plugin. -You can even get that front-end Squid proxy to help out by enabling HTTP +You can even get that frontend Squid proxy to help out by enabling HTTP headers for the cached page. MyApp->config(