Add quick directions for testing the tutorial final tarball.

[catagits/Catalyst-Runtime.git] / lib / Catalyst / Manual / Tutorial / Intro.pod

diff --git a/lib/Catalyst/Manual/Tutorial/Intro.pod b/lib/Catalyst/Manual/Tutorial/Intro.pod
index a03eec7..e409740 100644 (file)
--- 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<Catalyst::Plugin::DefaultEnd|Catalyst::Plugin::DefaultEnd>,
+L<Catalyst::Action::RenderView|Catalyst::Action::RenderView>,
 DBIC, L<Catalyst::Plugin::ConfigLoader|Catalyst::Plugin::ConfigLoader> 
 with C<myapp.yml>, the use of C<lib/MyApp/Controller/Root.pm> 
 vs. C<lib/MyApp.pm>, etc.
@@ -113,12 +122,13 @@ PostgreSQL).
 
 =item * 
 
-The use of HTML::Widget for automated form processing and validation.
+The use of L<HTML::Widget|HTML::Widget> 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<TO_BE_ADDED_TO_FINAL_VERSION>.
+L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/Final_Tarball/MyApp.tgz>.
+
+B<NOTE:> 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<hkclark@gmail.com>
 
-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<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Tutorial/>.
 
 Copyright 2006, Kennedy Clark, under Creative Commons License
 (L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).