Switch to svn for sample tutorial code
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial / 01_Intro.pod
index 5a9950e..5084cb1 100644 (file)
@@ -72,8 +72,8 @@ catalyst subversion repository by issuing the command:
 
     svn co http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/ CatalystTutorial
 
-This will download the most recent tarball for each chapter of the 
-tutorial into the CatalystTutorial directory on your machine. 
+This will download the most recent code for each chapter of the
+tutorial into the CatalystTutorial directory on your machine.
 
 B<These reference implementations are provided so that when you follow
 the tutorial, you can use the code from the subversion repository to
@@ -189,7 +189,9 @@ L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/>.
 
 This tutorial was built using the following resources. Please note that
 you may need to make adjustments for different environments and
-versions:
+versions (note that trailing zeros in version numbers are not 
+significant and may get dropped with techniques for viewing them;
+for example, Catalyst v5.80020 might show up as 5.8002):
 
 =over 4
 
@@ -199,15 +201,15 @@ Debian 5 (Lenny)
 
 =item * 
 
-Catalyst v5.80013
+Catalyst v5.80020 (note: may show up as '5.8002' without the trailing zero)
 
 =item *
 
-Catalyst::Devel v1.21
+Catalyst::Devel v1.26
 
 =item * 
 
-DBIx::Class v0.08112
+DBIx::Class v0.08115
 
 =item *
 
@@ -226,11 +228,11 @@ use. This tutorial has been tested against the following set of plugins:
 
 =item * 
 
-Catalyst::Plugin::Authentication -- v0.10015
+Catalyst::Plugin::Authentication -- v0.10016
 
 =item *
 
-Catalyst::Plugin::Authorization::Roles -- v0.07
+Catalyst::Plugin::Authorization::Roles -- v0.08
 
 =item *
 
@@ -254,7 +256,7 @@ Catalyst::Plugin::StackTrace -- v0.11
 
 =item *
 
-Catalyst::Plugin::Static::Simple -- v0.25
+Catalyst::Plugin::Static::Simple -- v0.28
 
 =back
 
@@ -325,7 +327,8 @@ hard to guarantee this.>
 =item * 
 
 Download one of the ISO files from 
-L<http://cdimage.debian.org/cdimage/release/current-live/i386/iso-cd/>. 
+L<http://cdimage.debian.org/cdimage/release/current-live/i386/iso-cd/>
+(the current version at the time this was written was 5.0.3). 
 You can pick any one of the live CD variations will work, but 
 you may wish to consider the following points:
 
@@ -333,7 +336,7 @@ you may wish to consider the following points:
 
 =item *
 
-"C<debian-live-500-i386-rescue.iso>" is probably the best all-around 
+"C<debian-live-503-i386-rescue.iso>" is probably the best all-around 
 option for most people because it includes many extra tools such as 
 the GCC compiler, therefore saving RAM (every package you need to 
 install when running from live CD consumes memory because RAM disk is 
@@ -344,7 +347,7 @@ should be able to safely ignore these.
 
 =item *
 
-"C<debian-live-500-i386-standard.iso>" is a great option because of 
+"C<debian-live-503-i386-standard.iso>" is a great option because of 
 its compact size, but you will probably need approximately 1 GB of RAM 
 in the computer where you will run the tutorial.  Because the 
 "standard" live CD comes with with a minimal set of tools, we will 
@@ -377,9 +380,15 @@ Select "C<Live>" from the initial boot menu.
 
 =item *
 
-Once the system has booted to a "C<user@debian:~$>" prompt, enter the 
-following command to add the more current "unstable" package 
-repository:
+Once the system has booted to a "C<user@debian:~$>" prompt, first
+install the Subversion client in case you want to check out the
+completed chapter example code:
+
+       sudo aptitude -y install subversion
+
+Then enter the following command to add the more current "unstable" 
+package repository so we get the latest versions of Catalyst and
+related packages:
 
     sudo vi /etc/apt/sources.list
 
@@ -401,9 +410,8 @@ Install Catalyst:
     sudo aptitude update
     sudo aptitude -y install sqlite3 libdbd-sqlite3-perl libcatalyst-perl \
         libcatalyst-modules-perl libdbix-class-timestamp-perl \
-        libdbix-class-encodedcolumn-perl libperl6-junction-perl \
         libdatetime-format-sqlite-perl libconfig-general-perl \
-        libhtml-formfu-model-dbic-perl
+        libhtml-formfu-model-dbic-perl libterm-readline-perl-perl
 
 Let it install (normally about a 30 to 90-second operaton) and you are 
 done. (Note the '\' above.  Depending on your environment, you might 
@@ -617,19 +625,17 @@ of each part for the appropriate svn command to use).
 B<NOTE:> You can run the test cases for the final code through Chapter 8 
 with the following commands:
 
-    wget http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/MyApp_Chapter8.tgz
-    tar zxvf MyApp_Chapter8.tgz
-    cd MyApp
-    CATALYST_DEBUG=0 prove --lib lib t
+       svn co http://dev.catalystframework.org/repos/Catalyst/trunk/examples/Tutorial/MyApp_Chapter8
+       cd MyApp_Chapter8/MyApp
+    CATALYST_DEBUG=0 prove -wl t
 
-If you wish to include the L<HTML::FormFu|HTML::FormFu> section in 
-your tests, substitute C<MyApp_Chapter9_FormFu.tgz> for 
-C<MyApp_Chapter8.tgz> in the URL above.
+If you wish to include the L<HTML::FormFu|HTML::FormFu> section in your tests,
+substitute C<MyApp_Chapter9_FormFu> for C<MyApp_Chapter8> in the URL
+above (don't forget to "cd" out of the Ch8 directory if you ran the code above).
 
-    wget http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/MyApp_Chapter9_FormFu.tgz
-    tar zxvf MyApp_Chapter8.tgz
-    cd MyApp
-    CATALYST_DEBUG=0 prove --lib lib t
+       svn co http://dev.catalystframework.org/repos/Catalyst/trunk/examples/Tutorial/MyApp_Chapter9_FormFu
+       cd MyApp_Chapter9_FormFu/MyApp
+    CATALYST_DEBUG=0 prove -wl t
 
 You can also fire up the application under the development server that is conveniently
 built in to Catalyst.  Just issue this command from the C<MyApp> directory where you