fixed some typos

[helm.git] / helm / software / matita / help / C / sec_install.xml

diff --git a/helm/software/matita/help/C/sec_install.xml b/helm/software/matita/help/C/sec_install.xml
index eba9dabd3bc73645a48023ff5cc34eb7fb36f04b..92e9d62cc178812ca621194e31b49dd40b8e2903 100644 (file)
--- a/helm/software/matita/help/C/sec_install.xml
+++ b/helm/software/matita/help/C/sec_install.xml
@@ -76,8 +76,7 @@
    </figure>
    <para>
       In the newely opened window click 
-      the Add button, choose the file you downloaded
-      (usually matita-version.iso) and select that entry. 
+      the Add button
     </para>
    <figure><title>Choosing the ISO image</title>
      <mediaobject>
@@ -88,13 +87,102 @@
      </mediaobject>
    </figure>
    <para>
-      You are now ready
-      to start the virtual machine. 
+      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>
-           TODO
+       <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>