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
=item *
-The use of L<DBIx::Class> (DBIC) for the model.
+The use of L<DBIx::Class|DBIx::Class> (DBIC) for the model.
=item *
=item *
-Attempts to provide an example showing current (5.70) Catalyst
-practices. For example, the use of L<Catalyst::Plugin::DefaultEnd>,
-DBIC, L<Catalyst::Plugin::ConfigLoader> with C<myapp.yml>, the use of
-C<lib/MyApp/Controller/Root.pm> vs. C<lib/MyApp.pm>, etc.
+Attempts to provide an example showing current (5.7XXX) Catalyst
+practices. For example, the use of
+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.
=item *
The use of Template Toolkit (TT) and the
-L<Catalyst::Helper::View::TTSite> view helper.
+L<Catalyst::Helper::View::TTSite|Catalyst::Helper::View::TTSite>
+view helper.
=item *
=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
=item *
-Catalyst v5.67
+Catalyst v5.6902
=item *
-DBIx::Class v0.06002
+DBIx::Class v0.06003
=item *
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 *
=item *
-Catalyst::Plugin::ConfigLoader -- 0.07
-
-=item *
-
-Catalyst::Plugin::DefaultEnd -- 0.06
+Catalyst::Plugin::ConfigLoader -- 0.13
=item *
=item *
-Catalyst::Plugin::Session -- 0.05
+Catalyst::Plugin::Session -- 0.12
=item *
-Catalyst::Plugin::Session::FastMmap -- 0.12
+Catalyst::Plugin::Session::State::Cookie -- 0.05
=item *
-Catalyst::Plugin::Session::State::Cookie -- 0.02
+Catalyst::Plugin::Session::Store::FastMmap -- 0.02
=item *
-Catalyst::Plugin::Session::Store::FastMmap -- 0.0
-
-=item *
-
-Catalyst::Plugin::StackTrace -- 0.0
+Catalyst::Plugin::StackTrace -- 0.06
=item *
=back
For additional information and recommendations on Catalyst installation,
-please refer to L<Catalyst::Manual::Installation>.
+please refer to
+L<Catalyst::Manual::Installation|Catalyst::Manual::Installation>.
-B<IMPORTANT:> Step-by-step instructions to replicate the environment on
+B<NOTE:> Step-by-step instructions to replicate the environment on
which this tutorial was developed can be found at
-L<Catalyst::Manual::Installation::CentOS4>.
-
+L<Catalyst::Manual::Installation::CentOS4|Catalyst::Manual::Installation::CentOS4>.
Using these instructions, you should be able to build a complete CentOS
4.X server with Catalyst and all the plugins required to run this
tutorial.
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
-TO_BE_ADDED_TO_FINAL_VERSION.
+L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/Final_Tarball/MyApp.tgz>.
+
=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/>).
-Version: .94