From: Enrico Tassi <enrico.tassi@inria.fr>
Date: Tue, 25 Nov 2008 19:10:15 +0000 (+0000)
Subject: more on the livecd in the manual
X-Git-Tag: make_still_working~4509
X-Git-Url: http://matita.cs.unibo.it/gitweb/?a=commitdiff_plain;h=5e298949f797425204d43371d182668e3a056c00;p=helm.git

more on the livecd in the manual
---

diff --git a/helm/software/matita/help/C/figures/vbox1.png b/helm/software/matita/help/C/figures/vbox1.png
new file mode 100644
index 000000000..f35e3ae48
Binary files /dev/null and b/helm/software/matita/help/C/figures/vbox1.png differ
diff --git a/helm/software/matita/help/C/figures/vbox2.png b/helm/software/matita/help/C/figures/vbox2.png
new file mode 100644
index 000000000..daf0c94a5
Binary files /dev/null and b/helm/software/matita/help/C/figures/vbox2.png differ
diff --git a/helm/software/matita/help/C/figures/vbox3.png b/helm/software/matita/help/C/figures/vbox3.png
new file mode 100644
index 000000000..f28ac363d
Binary files /dev/null and b/helm/software/matita/help/C/figures/vbox3.png differ
diff --git a/helm/software/matita/help/C/sec_install.xml b/helm/software/matita/help/C/sec_install.xml
index 7dc37937b..eba9dabd3 100644
--- a/helm/software/matita/help/C/sec_install.xml
+++ b/helm/software/matita/help/C/sec_install.xml
@@ -4,11 +4,106 @@
 <chapter id="sec_install">
   <title>Installation</title>
 
+  <para>
+	  &appname; is a quite complex piece of software, we thus recommend
+	  you to either install al precompiled version or use the LiveCD.
+	  If you are running Debian GNU/Linux (or one of its derivatives
+	  like Ubuntu), you can install matita typing
+	   <programlisting><![CDATA[ aptitude install matita matita-standard-library ]]></programlisting>
+          If you are running MacOSX or Windows, give the LiveCD a try before
+	  trying to compile &appname; from its sources.
+  </para>
+  
+  <sect1 id="inst_livecd">
+    <title>Using the LiveCD</title>
+
+    <para>
+	    In the following, we will assume you have installed 
+	    <ulink type="http" url="http://www.virtualbox.org">virtualbox</ulink>
+	    for your platform and downloaded the .iso image of the LiveCD
+    </para>
+
+    <sect2 id="make_vmachine">
+	    <title>Creating the virtual machine</title>
+    <para>
+	    Click on the New button, a wizard will popup, you should ask to
+	    its questions as follows
+      <orderedlist>
+	      <listitem><para> 
+		The name should be something like &appname;, but can
+		be any meaningful string.
+	      </para></listitem>
+	      <listitem><para> 
+	        The OS type should be Debian
+              </para></listitem>
+	      <listitem><para> 
+	        The base memory size can be 256 mega bytes, but you may
+		want to increase it if you are going to work with huge
+		formalizations.
+	     </para></listitem>
+	  <listitem><para> 
+	 The boot hard disk should be no hard disk. It may complain
+	 that this choice is not common, but it is right, since you
+	 will run a LiveCD you do not need to emulate an hard drive.
+	  </para></listitem>
+      </orderedlist>
+      Now that you are done with the creation of the virtual machine, 
+      you need to insert the LiveCD in the virtual cd reader unit.
+      </para>
+   <figure><title>The brand new virtual machine</title>
+     <mediaobject>
+       <imageobject>
+         <imagedata fileref="figures/vbox1.png" format="PNG" srccredit="Enrico Tassi"/>
+       </imageobject>
+       <textobject><phrase>The breand new virtual machine</phrase></textobject>
+     </mediaobject>
+   </figure>
+   <para>
+      Click on CD/DVD-ROM (that should display something like: Not mouted).
+      Then click on mount CD/DVD drive and select the ISO image
+      option. The combo-box should display no available image, you need to 
+      add the ISO image you downloaded from the &appname; website clicking on
+      the button near the combo-box. 
+      to start the virtual machine. 
+    </para>
+   <figure><title>Mounting an ISO image</title>
+     <mediaobject>
+       <imageobject>
+         <imagedata fileref="figures/vbox2.png" format="PNG" srccredit="Enrico Tassi"/>
+       </imageobject>
+       <textobject><phrase>Mounting an ISO image</phrase></textobject>
+     </mediaobject>
+   </figure>
+   <para>
+      In the newely opened window click 
+      the Add button, choose the file you downloaded
+      (usually matita-version.iso) and select that entry. 
+    </para>
+   <figure><title>Choosing the ISO image</title>
+     <mediaobject>
+       <imageobject>
+         <imagedata fileref="figures/vbox3.png" format="PNG" srccredit="Enrico Tassi"/>
+       </imageobject>
+       <textobject><phrase>Choosing the ISO image</phrase></textobject>
+     </mediaobject>
+   </figure>
+   <para>
+      You are now ready
+      to start the virtual machine. 
+    </para>
+    </sect2>
+    <sect2>
+	    <title>Sharing files with the real PC</title>
+	    TODO
+    </sect2>
+
+  </sect1>
+
   <sect1 id="inst_from_src">
     <title>Installing from sources</title>
 
-    <para>Currently, the only intended way to install &appname; is starting
-      from its source code.  </para>
+    <para>Install &appname; from the sources is hard, you have been warned!
+    </para>
 
     <sect2 id="get_source_code">
       <title>Getting the source code</title>