X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FTutorial%2F01_Intro.pod;h=c109aeaa6aae02d8de25d22bb31644f6009a586b;hb=9be506a8265b61431a261afb4d4d229656ed9c45;hp=b0079eea81b986f837394158dd805b9e960e45d7;hpb=014065cb1682cef16ac7fa0ca516884e81669e16;p=catagits%2FCatalyst-Manual.git diff --git a/lib/Catalyst/Manual/Tutorial/01_Intro.pod b/lib/Catalyst/Manual/Tutorial/01_Intro.pod index b0079ee..c109aea 100644 --- a/lib/Catalyst/Manual/Tutorial/01_Intro.pod +++ b/lib/Catalyst/Manual/Tutorial/01_Intro.pod @@ -83,16 +83,16 @@ following command (note: will probably be switching to git soon): This will download the most recent code for each chapter of the tutorial into the CatalystTutorial directory on your machine. -B +errors, or accidentally skipped part of the tutorial. B It should make little or no difference to Catalyst's operation, B that you can download and use to work through the full tutorial step by step. B to avoid issues that may crop up if you are working with a different configuration. We @@ -193,15 +193,11 @@ Virtual Machine. This document uses the term "host machine" to refer to the physical machine where you will run the virtualization software and boot up the VM. The terms "guest machine" or just "VM" refer to the virtual machine itself -- the thing where you actually do the tutorial -and that you boot up on the "host machine". - -Also, to reduce download size, the Tutorial VM just includes a minimal -command-line environment. In general, it is expected that people will -boot up the Tutorial VM on their main desktop (the "host machine" using -the terminology above) and then use that main desktop machine to SSH and -web browse into the "guest VM" as they work through the tutorial. If -you wish to install X-Windows (or any other packages), just use the -C (or C) Debian commands. +(and that you boot up on the "host machine"). +B Throughout the tutorial, we will shows the UNIX shell prompt +as "C<$>". If you are using Tutorial VM, the prompt will really be +"C", but we will keep it short (and also use "C<$>" in +lieu of "C<#>", since "C<#>" looks too much like a Perl comment). =over 4 @@ -211,14 +207,14 @@ C (or C) Debian commands. Download a Tutorial Virtual Machine image from L -B +B +B<(and everything else they do for the Perl community)!> =item 2 -Uncompress the image: +Uncompress the image on the "host machine": - tar zxvf CatalystTutorial.tgz + MAINCOMPUTER:~$ tar zxvf CatalystTutorial.tgz =item 3 @@ -252,7 +248,7 @@ The image it design to automatically use a DHCP-assigned address. Try to ping this IP address from your "host machine" (main desktop): - MainComputer:~$ ping 192.168.0.12 + MAINCOMPUTER:~$ ping 192.168.0.12 PING 192.168.0.12 (192.168.0.12) 56(84) bytes of data. 64 bytes from 192.168.0.12: icmp_req=1 ttl=255 time=4.97 ms 64 bytes from 192.168.0.12: icmp_req=2 ttl=255 time=3.43 ms @@ -270,7 +266,7 @@ could be a few network-related issues you might need to sort out. See the section below L for additional information and troubleshooting advice. -L Remember this IP address... you will be using it throughout the +B Remember this IP address... you will be using it throughout the tutorial. @@ -338,6 +334,13 @@ modules across development, staging, and production servers. (The B Perl itself from your home directory [or any other directory you chose]). +B: Please provide feedback on how the Virtual Machine approach for +the tutorial works for you. If you have suggestions or comments, you +can reach the author through the email address at the bottom of this +page or via an RT ticket at +L. + + =head2 Sorting Out Virtual Machine Network-Related Issues @@ -393,15 +396,15 @@ help: =item * -L +L =item * -L +L =item * -L +L =back @@ -478,13 +481,14 @@ C. Note that the development server defaults to port 3000 (you can change with with the "-p" option on the command line. -B Depending on the web browser you are using, you might need -to hit C or C to pull a fresh page when +B Depending on the web browser you are using, you might +need to hit C or C to pull a fresh page when testing your application at various points (see -L for a comprehensive -list of options for each browser). Also, the C<-k> keepalive option to -the development server can be necessary with some browsers (especially -Internet Explorer). +L for a +comprehensive list of options for each browser). + +Also, the C<-k> B to the development server can be +necessary with some browsers (B). =back @@ -510,10 +514,10 @@ L Kennedy Clark, C -Please report any errors, issues or suggestions to the author. The -most recent version of the Catalyst Tutorial can be found at -L. +Feel free to contact the author for any errors or suggestions, but the +best way to report issues is via the CPAN RT Bug system at +L. -Copyright 2006-2010, Kennedy Clark, under the +Copyright 2006-2011, Kennedy Clark, under the Creative Commons Attribution Share-Alike License Version 3.0 (L).