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 (file)
index 0000000..f35e3ae
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 (file)
index 0000000..daf0c94
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 (file)
index 0000000..f28ac36
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 7dc37937b7525a8e0df725a5a32eb16b337858bd..eba9dabd3bc73645a48023ff5cc34eb7fb36f04b 100644 (file)
--- 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>