X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Manual.git;a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FTutorial%2F01_Intro.pod;h=00c7c0c0160df58bc2d451ade3d77d382682ff82;hp=b84c4c4657a3870143de51050975668e046c0a6a;hb=d1598ab8aef2d8506e8e82baa0d9c22867b81f8e;hpb=46b6662a1a8b9018b9495b75a6d5d1bfe1a7f342 diff --git a/lib/Catalyst/Manual/Tutorial/01_Intro.pod b/lib/Catalyst/Manual/Tutorial/01_Intro.pod index b84c4c4..00c7c0c 100644 --- a/lib/Catalyst/Manual/Tutorial/01_Intro.pod +++ b/lib/Catalyst/Manual/Tutorial/01_Intro.pod @@ -194,10 +194,11 @@ 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"). -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). + +B Throughout the tutorial, we will shows the UNIX shell prompt as +"C<$>". If you are using the Tutorial VM, the prompt will really be +"C" (where "C<~"> will change to show your +current directory), but we will keep it short and just use "C<$>". =over 4 @@ -224,13 +225,14 @@ L. =item 4 -Once you get a login prompt, enter the username B and a password -for C. You should now be at a prompt that looks like: +Once you get a login prompt, enter the username B and a +password for C. You should now be at a prompt that looks +like: - catalyst login: root + catalyst login: catalyst Password: catalyst ... - root@catalyst:~# + catalyst@catalyst:~$ =item 5 @@ -275,13 +277,13 @@ tutorial. B, open an SSH client and connect to the IP address found in the previous step. You should get a login prompt (accept the SSH key if you get a warning message about that). Login -with the same username and password as we used in Step 4: B / +with the same username and password as we used in Step 4: B / B - catalyst login: root + catalyst login: catalyst Password: catalyst ... - root@catalyst:~# + catalyst@catalyst:~$ =item 7 @@ -324,8 +326,8 @@ In order to reduce the size of the download, Emacs is not pre-installed. Since people obviously have very strong opinions about which editor is best, :-) fortunately it's very easy to install Emacs: - $ aptitude update - $ aptitude install emacs + $ sudo aptitude update + $ sudo aptitude install emacs In general, it is expected that people will boot up the Tutorial VM on their main desktop (the "host machine" using @@ -335,13 +337,13 @@ you wish to install X Windows (or any other packages), just use the C (or C) Debian commands. For example, to install X Windows with the Gnome desktop manager, you can do: - $ aptitude update - $ aptitude install gnome iceweasel + $ sudo aptitude update + $ sudo ptitude install gnome iceweasel Or, if you prefer KDE: - $ aptitude update - $ aptitude install kde iceweasel + $ sudo aptitude update + $ sudo aptitude install kde iceweasel You can then start X Windows with: @@ -352,14 +354,14 @@ You can then start X Windows with: You may note that the Tutorial Virtual Machine uses L so -that the Perl modules are run from ~/perl5 (in this case, /root/perl5) -vs. the usual location of your "system Perl". We recommend that you -also consider using this very handy module. It can greatly ease the -process of maintaining and testing different combinations or Perl -modules across development, staging, and production servers. (The -"relocatable Perl" feature can also be used to to run both the modules -B Perl itself from your home directory [or any other directory you -chose]). +that the Perl modules are run from ~/perl5 (in this case, +/home/catalyst/perl5) vs. the usual location of your "system Perl". We +recommend that you also consider using this very handy module. It can +greatly ease the process of maintaining and testing different +combinations or Perl modules across development, staging, and production +servers. (The "relocatable Perl" feature can also be used to to run +both the modules 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