X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FTutorial%2FIntro.pod;h=e409740d50de4d7d23b7d9dfffe4bbf384ac75f9;hb=f54e8ddc2a867cfd8285f92d3d297b4e4c919e7f;hp=a03eec78ff27d41af2b411a20a4ac7fac456d674;hpb=a63e6e6726445baeea08771316b3ce44a495a96a;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Manual/Tutorial/Intro.pod b/lib/Catalyst/Manual/Tutorial/Intro.pod index a03eec7..e409740 100644 --- a/lib/Catalyst/Manual/Tutorial/Intro.pod +++ b/lib/Catalyst/Manual/Tutorial/Intro.pod @@ -61,6 +61,15 @@ framework, experienced users may wish to review specific sections (for example, how to use DBIC for their model classes or how to add authentication and authorization to an existing application). +You can obtain the code for all the tutorial examples from the +catalyst subversion repository by issuing the command: + + svn co http://dev.catalyst.perl.org/repos/Catalyst/tags/examples/Tutorial/MyApp/5.7/ CatalystTutorial + +This will download the current code for each tutorial chapter in the +CatalystTutorial directory. Each example application directory has +the same name as the tutorial chapter. + Subjects covered include: =over 4 @@ -88,9 +97,9 @@ Role-based authorization ("authz"). =item * -Attempts to provide an example showing current (5.70) Catalyst +Attempts to provide an example showing current (5.7XXX) Catalyst practices. For example, the use of -L, +L, DBIC, L with C, the use of C vs. C, etc. @@ -113,12 +122,13 @@ PostgreSQL). =item * -The use of HTML::Widget for automated form processing and validation. +The use of L for automated form processing +and validation. =back This tutorial makes the learning process its main priority. For -example, the level of comments in the code found here would like be +example, the level of comments in the code found here would likely be considered excessive in a "normal project". Because of their contextual value, this tutorial will generally favor inline comments over a separate discussion in the text. It also deliberately tries to @@ -166,25 +176,21 @@ Catalyst Plugins The plugins used in this tutorial all have sufficiently stable APIs that you shouldn't need to worry about versions. However, there could be cases where the tutorial is affected by what version of plugins you -use. The plugins used for this tutorial are: +use. This tutorial has been tested against the following set of plugins: =over 4 =item * -Catalyst::Plugin::Authentication -- 0.07 +Catalyst::Plugin::Authentication -- 0.09 =item * -Authentication::Credential::Password -- 0.07 +Catalyst::Plugin::Authentication::Store::DBIC -- 0.07 =item * -Catalyst::Plugin::Authentication::Store::DBIC -- 0.06 - -=item * - -Catalyst::Plugin::Authorization::ACL -- 0.06 +Catalyst::Plugin::Authorization::ACL -- 0.08 =item * @@ -192,11 +198,7 @@ Catalyst::Plugin::Authorization::Roles -- 0.04 =item * -Catalyst::Plugin::ConfigLoader -- 0.07 - -=item * - -Catalyst::Plugin::DefaultEnd -- 0.06 +Catalyst::Plugin::ConfigLoader -- 0.13 =item * @@ -204,15 +206,11 @@ Catalyst::Plugin::HTML::Widget -- 1.1 =item * -Catalyst::Plugin::Session -- 0.05 +Catalyst::Plugin::Session -- 0.12 =item * -Catalyst::Plugin::Session::FastMmap -- 0.12 - -=item * - -Catalyst::Plugin::Session::State::Cookie -- 0.02 +Catalyst::Plugin::Session::State::Cookie -- 0.05 =item * @@ -220,7 +218,7 @@ Catalyst::Plugin::Session::Store::FastMmap -- 0.02 =item * -Catalyst::Plugin::StackTrace -- 0.04 +Catalyst::Plugin::StackTrace -- 0.06 =item * @@ -319,14 +317,24 @@ Each part of the tutorial has complete code available in the main Catalyst Subversion repository (see the note at the beginning of each part for the appropriate svn command to use). Additionally, the final code is available as a ready-to-run tarball at -I. +L. + +B You can run the test cases for the final code with the following +commands: + + wget http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/Final_Tarball/MyApp.tgz + tar zxvf MyApp.tgz + cd MyApp + CATALYST_DEBUG=0 prove --lib lib t =head1 AUTHOR Kennedy Clark, C -Please report any errors, issues or suggestions to the author. +Please report any errors, issues or suggestions to the author. The +most recent version of the Catalyst Tutorial can be found at +L. Copyright 2006, Kennedy Clark, under Creative Commons License (L).