Add some docs about installing X Windows
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial / 01_Intro.pod
index c109aea..b84c4c4 100644 (file)
@@ -313,14 +313,41 @@ back and carefully check each of the steps above.
 
 =item 9
 
-B<Optional:> The VI/VIM editor is already installed on the Tutorial
-Virtual Machine.  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, :-) Debian fortunately make it very easy to
-install Emacs:
-
+B<Optional:> Also, to reduce download size, the Tutorial VM just
+includes a minimal command-line environment.  You are free to use
+Debian's very capable C<apt> package manager to install other packages.
+You will first want to pull the apt cache files with C<aptitude update>
+(or C<apt-get update> if you prefer apt-get).
+
+The VI/VIM editor is already installed on the Tutorial Virtual Machine.
+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
 
+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.  For example, to install
+X Windows with the Gnome desktop manager, you can do:
+
+    $ aptitude update
+    $ aptitude install gnome iceweasel
+
+Or, if you prefer KDE:
+
+    $ aptitude update
+    $ aptitude install kde iceweasel
+
+You can then start X Windows with:
+
+    $ startx
+
+
 =back