Make MAINCOMPUTER prompt more prominent
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial / 01_Intro.pod
index c26213f..c109aea 100644 (file)
@@ -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<aptitude> (or C<apt-get>) Debian commands.
+(and that you boot up on the "host machine").
+B<Note:> Throughout the tutorial, we will shows the UNIX shell prompt
+as "C<$>".  If you are using Tutorial VM, the prompt will really be
+"C<root@catalyst:~#>", 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
@@ -216,9 +212,9 @@ 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
@@ -338,6 +334,13 @@ modules across development, staging, and production servers.  (The
 B<and> Perl itself from your home directory [or any other directory you
 chose]).
 
+B<Note>: 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<https://rt.cpan.org/Public/Dist/Display.html?Name=Catalyst-Manual>.
+
+
 
 =head2 Sorting Out Virtual Machine Network-Related Issues