X-Git-Url: http://matita.cs.unibo.it/gitweb/?a=blobdiff_plain;f=helm%2Fsoftware%2Fmatita%2Fhelp%2FC%2Fsec_install.xml;h=92e9d62cc178812ca621194e31b49dd40b8e2903;hb=e880d6eab5e1700f4a625ddcd7d0fa8f0cce2dcc;hp=7dc37937b7525a8e0df725a5a32eb16b337858bd;hpb=2f857ddcadb88445744b1490cb510023b7192930;p=helm.git

diff --git a/helm/software/matita/help/C/sec_install.xml b/helm/software/matita/help/C/sec_install.xml
index 7dc37937b..92e9d62cc 100644
--- a/helm/software/matita/help/C/sec_install.xml
+++ b/helm/software/matita/help/C/sec_install.xml
@@ -4,11 +4,194 @@
 <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
+    </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>
+      A new windows will pop-up: choose the file you downloaded
+      (usually matita-version.iso) and click open.
+    </para>
+   <figure><title>Choosing the ISO image</title>
+     <mediaobject>
+       <imageobject>
+         <imagedata fileref="figures/vbox35.png" format="PNG" srccredit="Enrico Tassi"/>
+       </imageobject>
+       <textobject><phrase>Choosing the ISO image</phrase></textobject>
+     </mediaobject>
+   </figure>
+   <para>
+	   Now select the new entry you just added as the CD image
+	   you want to insert in the virtual CD drive.
+	   You are now ready to start the virtual machine. 
+    </para>
+    </sect2>
+    <sect2>
+       <title>Sharing files with the real PC</title>
+	  <para>
+		  The virtual machine &appname; will run on, has its own file 
+		  system, that is completely separated from the one of your 
+		  real PC (thus your files are not available in the
+		  emulated environment) and moreover it is a non-presistent
+		  file system (thus you data is lost every time you
+		  turn off the virtual machine).
+          </para>
+          <para>
+		  Virtualbox allows you to share a real folder (beloging
+		  to your real PC) with the emulated computer. Since this 
+		  folder is persistent, you are encouraged to put
+		  your work there, so that it is not lost when the virtual 
+		  machine is powered off.
+          </para>
+	  <para>
+		  The first step to set up a shared folder is to click
+		  on the shared folder configuration entry
+		  of the virtual machine.
+	  </para>
+          <figure><title>Set up a shared folder</title>
+            <mediaobject>
+              <imageobject>
+		      <imagedata fileref="figures/vbox4.png" 
+			      format="PNG" srccredit="Enrico Tassi"/>
+              </imageobject>
+              <textobject><phrase>Shared folder</phrase></textobject>
+            </mediaobject>
+          </figure>
+	  <para>
+		  Then you shuld add a shared folder clicking on the 
+		  plus icon on the right
+	  </para>
+          <figure><title>Choosing the folder to share</title>
+            <mediaobject>
+              <imageobject>
+		      <imagedata fileref="figures/vbox5.png" 
+			      format="PNG" srccredit="Enrico Tassi"/>
+              </imageobject>
+              <textobject><phrase>Shared folder</phrase></textobject>
+            </mediaobject>
+          </figure>
+	  <para>
+		  Then you have to specify the real PC folder you want to share
+		  and name it. A reasonable folder to share is /home on 
+		  a standard Unix system, while /Users on MaxOSX.
+		  The name you give to the share is important, you should
+		  remember it.
+	  </para>
+          <figure><title>Naming the shared folder</title>
+            <mediaobject>
+              <imageobject>
+		      <imagedata fileref="figures/vbox6.png" 
+			      format="PNG" srccredit="Enrico Tassi"/>
+              </imageobject>
+              <textobject><phrase>Shared folder</phrase></textobject>
+            </mediaobject>
+          </figure>
+	  <para>
+		  Once your virtual machine is up and running, you can
+		  mount (that meand have access to) the shared folder 
+		  by clicking on the Mount VirtualBox share icon, and typing
+		  the name of the share.
+	  </para>
+          <figure><title>Using it from the virtual machine</title>
+            <mediaobject>
+              <imageobject>
+		      <imagedata fileref="figures/vbox7.png" 
+			      format="PNG" srccredit="Enrico Tassi"/>
+              </imageobject>
+              <textobject><phrase>Shared folder at work</phrase></textobject>
+            </mediaobject>
+          </figure>
+	  <para>
+		  A window will then pop-up, and its content will be the
+		  the content of the real PC folder.
+	  </para>
+    </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>