]> matita.cs.unibo.it Git - helm.git/commitdiff
completed installation instructions
authorStefano Zacchiroli <zack@upsilon.cc>
Thu, 9 Feb 2006 00:19:56 +0000 (00:19 +0000)
committerStefano Zacchiroli <zack@upsilon.cc>
Thu, 9 Feb 2006 00:19:56 +0000 (00:19 +0000)
helm/software/matita/dist/INSTALL
helm/software/matita/help/C/matita.xml
helm/software/matita/help/C/sec_install.xml
helm/www/matita/download.shtml
helm/www/matita/install.html [new file with mode: 0644]

index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..ddc50467e2211f9cb5d9cf1b5e9205dee90fb34e 100644 (file)
@@ -0,0 +1,180 @@
+Chapter 2. Installation
+
+Table of Contents
+
+Installing from sources
+
+    Getting the source code
+    Requirements
+    Database setup
+    Compiling and installing
+
+Installing from sources
+
+Currently, the only intended way to install Matita is starting from its source
+code.
+
+Getting the source code
+
+You can get the Matita source code in two ways:
+
+ 1. go to the download page and get the latest released source tarball;
+
+ 2. get the development sources from our SVN repository. You will need the
+    components/ and matita/ directories from the trunk/helm/software/
+    directory, plus the configure and Makefile* stuff from the same directory.
+
+    In this case you will need to run autoconf before proceding with the
+    building instructions below.
+
+Requirements
+
+In order to build Matita from sources you will need some tools and libraries.
+They are listed below.
+
+Note for Debian users
+
+If you are running a Debian GNU/Linux distribution you can have APT install all
+the required tools and libraries by adding the following repository to your /
+etc/apt/sources.list:
+
+              deb http://people.debian.org/~zack unstable helm
+
+
+and installing the helm-matita-deps package.
+
+Required tools and libraries
+
+OCaml
+
+    the Objective Caml compiler, version 3.09 or above
+
+Findlib
+
+    OCaml package manager, version 1.1.1 or above
+
+OCaml Expat
+
+    OCaml bindings for the expat library
+
+GMetaDOM
+
+    OCaml bindings for the Gdome 2 library
+
+OCaml HTTP
+
+    OCaml library to write HTTP daemons (and clients)
+
+LablGTK
+
+    OCaml bindings for the GTK+ library , version 2.6.0 or above
+
+GtkMathView , LablGtkMathView
+
+    GTK+ widget to render MathML documents and its OCaml bindings
+
+GtkSourceView , LablGtkSourceView
+
+    extension for the GTK+ text widget (adding the typical features of source
+    code editors) and its OCaml bindings
+
+MySQL , OCaml MySQL
+
+    SQL database and OCaml bindings for its client-side library
+
+    The SQL database itself is not strictly needed to run Matita, but we
+    stronly encourage its use since a lot of features are disabled without it.
+    Still, the OCaml bindings of the library are needed at compile time.
+
+Ocamlnet
+
+    collection of OCaml libraries to deal with application-level Internet
+    protocols and conventions
+
+ulex
+
+    Unicode lexer generator for OCaml
+
+CamlZip
+
+    OCaml library to access .gz files
+
+Database setup
+
+To fully exploit Matita indexing and search capabilities you will need a
+working MySQL database. Detalied instructions on how to do it can be found in
+the MySQL documentation. Here you can find a quick howto.
+
+In order to create a database you need administrator permissions on your MySQL
+installation, usually the root account has them. Once you have the permissions,
+a new database can be created executing mysqladmin create matita (matita is the
+default database name, you can change it using the db.user key of the
+configuration file).
+
+Then you need to grant the necessary access permissions to the database user of
+Matita, typing echo "grant all privileges on matita.* to helm;" | mysql matita
+should do the trick (helm is the default user name used by Matita to access the
+database, you can change it using the db.user key of the configuration file).
+
+Note
+
+This way you create a database named matita on which anyone claiming to be the
+helm user can do everything (like adding dummy data or destroying the contained
+one). It is strongly suggested to apply more fine grained permissions, how to
+do it is out of the scope of this manual.
+
+Compiling and installing
+
+Once you get the source code the installations steps should be quite familiar.
+
+First of all you need to configure the build process executing ./configure.
+This will check that all needed tools and library are installed and prepare the
+sources for compilation and installation.
+
+Quite a few (optional) arguments may be passed to the configure command line to
+change build time parameters. They are listed in the table below, together with
+their default values.
+
+Table 2.1.  configure command line arguments
+
+┌──────────────────┬─────────┬────────────────────────────────────────────────┐
+│     Argument     │ Default │                  Description                   │
+├──────────────────┼─────────┼────────────────────────────────────────────────┤
+│--with-runtime-dir│/usr/    │Runtime base directory where all Matita stuff   │
+│=dir              │local/   │(executables, configuration files, standard     │
+│                  │matita/  │library, ...) will be installed                 │
+├──────────────────┼─────────┼────────────────────────────────────────────────┤
+│                  │         │Default SQL server hostname. Will be used while │
+│                  │         │building the standard library during the        │
+│--with-dbhost=host│localhost│installation and to create the default Matita   │
+│                  │         │configuration. May be changed later in          │
+│                  │         │configuration file.                             │
+├──────────────────┼─────────┼────────────────────────────────────────────────┤
+│--enable-debug    │disabled │Enable debugging code. Not for the casual user. │
+└──────────────────┴─────────┴────────────────────────────────────────────────┘
+
+Then you will manage the build and install process using make as usual. Below
+are reported the targets you have to invoke in sequence to build and install.
+
+make targets
+
+world
+
+    builds components needed by Matita and Matita itself (in bytecode only or
+    in both bytecode and native code depending on the availability of the OCaml
+    native code compiler)
+
+library
+
+    uses the (just built) matitac compiler to build the Matita standard
+    library.
+
+    For this step you will need a working SQL database (for indexing the
+    standard library while you are compiling it). See Database setup for
+    instructions on how to set it up.
+
+install
+
+    installs Matita related tools, standard library and the needed runtime
+    stuff in the proper places on the filesystem
+
index 0b27e59fb21e7847324666e4e84103f4c79f13b5..05e0a82123a4a7dd9c172aea723591878d8bdece 100644 (file)
@@ -15,6 +15,8 @@
   <!ENTITY appversion SYSTEM "version.txt">
 
   <!ENTITY TODO "<emphasis>TODO</emphasis>">
+  <!ENTITY MYSQL "<application> <ulink type='http'
+      url='http://www.mysql.com'>MySQL</ulink> </application>">
 ]>
 
 <?yelp:chunk-depth 3?>
index 6b135e81e13e11f5723049118a3f8684ff55f56b..70bd903ccaa85edade8f6ac561f02a5e6977f15d 100644 (file)
@@ -5,7 +5,7 @@
   <title>Installation</title>
 
   <sect1 id="inst_from_src">
-    <title>Installing &appname; from sources</title>
+    <title>Installing from sources</title>
 
     <para>Currently, the only intended way to install &appname; is starting
       from its source code.  </para>
          </varlistentry>
 
          <varlistentry>
-           <term>
-             <application> <ulink type="http"
-                 url="http://www.mysql.com">MySQL</ulink> </application>
-           </term>
+           <term> &MYSQL; </term>
            <term>
              <application> <ulink type="http"
                  url="http://raevnos.pennmush.org/code/ocaml-mysql/">OCaml
 
     </sect2>
 
+    <sect2 id="database_setup">
+      <title>Database setup</title>
+
+      <para> To fully exploit &appname; indexing and search capabilities you
+       will need a working &MYSQL; database. Detalied instructions on how to do
+       it can be found in the <ulink type="http"
+         url="http://dev.mysql.com/doc/">MySQL documentation</ulink>. Here you
+       can find a quick howto. </para>
+
+      <para> In order to create a database you need administrator permissions on
+       your MySQL installation, usually the root account has them. Once you
+       have the permissions, a new database can be created executing
+       <userinput>mysqladmin create matita</userinput>
+       (<emphasis>matita</emphasis> is the default database name, you can
+       change it using the <parameter>db.user</parameter> key of the
+       configuration file). </para>
+
+      <para> Then you need to grant the necessary access permissions to the
+       database user of &appname;, typing <userinput>echo "grant all privileges
+         on matita.* to helm;" | mysql matita</userinput> should do the trick
+       (<emphasis>helm</emphasis> is the default user name used by &appname; to
+       access the database, you can change it using the
+       <parameter>db.user</parameter> key of the configuration file).
+      </para>
+
+      <note>
+       <para> This way you create a database named <emphasis>matita</emphasis>
+         on which anyone claiming to be the <emphasis>helm</emphasis> user can
+         do everything (like adding dummy data or destroying the contained
+         one). It is strongly suggested to apply more fine grained permissions,
+         how to do it is out of the scope of this manual.</para>
+      </note>
+      
+    </sect2>
+
     <sect2 id="build_instructions">
-      <title>Instructions</title>
+      <title>Compiling and installing</title>
 
       <para> Once you get the source code the installations steps should be
        quite familiar.</para>
 
       <para> First of all you need to configure the build process executing
        <userinput>./configure</userinput>. This will check that all needed
-       tools and library are installed. You may need to pass on the command
-       line some of the parameters riported below:
-
-       <variablelist>
-         <title><application>configure</application> parameters</title>
-
-         <varlistentry>
-           <term>&TODO;</term>
-           <listitem><para>&TODO;</para></listitem>
-         </varlistentry>
-
-       </variablelist>
+       tools and library are installed and prepare the sources for compilation
+       and installation. </para>
+       
+      <para> Quite a few (optional) arguments may be passed to the
+       <application>configure</application> command line to change build time
+       parameters. They are listed in the table below, together with their
+       default values.
+
+       <table frame="all">
+         <title> <application>configure</application> command line
+           arguments</title>
+         <tgroup cols="3" align="left" colsep="1" rowsep="1">
+           <thead>
+             <row>
+               <entry align="center">Argument</entry>
+               <entry align="center">Default</entry>
+               <entry align="center">Description</entry>
+             </row>
+           </thead>
+           <tbody>
+             <row>
+               <entry>
+                 <userinput>--with-runtime-dir=<replaceable>dir</replaceable></userinput>
+               </entry>
+               <entry> <filename>/usr/local/matita/</filename> </entry>
+               <entry> <para> Runtime base directory where all &appname; stuff
+                   (executables, configuration files, standard
+                   library,&nbsp;...) will be installed </para> </entry>
+             </row>
+             <row>
+               <entry>
+                 <userinput>--with-dbhost=<replaceable>host</replaceable></userinput>
+               </entry>
+               <entry> localhost </entry>
+               <entry> <para>Default SQL server hostname. Will be used while
+                   building the standard library during the installation and to
+                   create the default &appname; configuration. May be changed
+                   later in configuration file.</para></entry>
+             </row>
+             <row>
+               <entry> <userinput>--enable-debug</userinput></entry>
+               <entry> disabled </entry>
+               <entry> <para> Enable debugging code. Not for the casual user.
+                 </para> </entry>
+             </row>
+           </tbody>
+         </tgroup>
+       </table>
 
       </para>
 
-      <para> Then you will manage the build process using <application><ulink
-           type="http"
+      <para> Then you will manage the build and install process using
+       <application><ulink type="http"
            url="http://www.gnu.org/software/make/">make</ulink></application>
        as usual. Below are reported the targets you have to invoke in sequence
        to build and install.
                compiler to build the &appname; standard library. </para>
              <para>For this step you will need a working SQL database (for
                indexing the standard library while you are compiling it). See
-               &TODO; for instructions on how to set it up.</para>
+               <ulink type="http" url="#database_setup">Database setup</ulink>
+               for instructions on how to set it up.</para>
            </listitem>
          </varlistentry>
 
index 30b26f672471952a05495ed720f14a1707386592..9bf1fa948c1d728a3a603ed17ee10cbb6822b4da 100644 (file)
     <a href="http://helm.cs.unibo.it/websvn/listing.php?repname=helm&amp;path=%2Ftrunk%2Fhelm%2Fsoftware%2Fmatita%2F&amp;rev=0&amp;sc=0"><kbd>matita/</kbd></a>
     itself.
     </p>
+    <p>
+    Once you got the sources, have a look at the
+    <a href="install.html">installation instructions</a> on how to build and
+    install Matita from sources.
+    </p>
     <!--#include virtual="bottombar.shtml" -->
   </body>
 </html>
diff --git a/helm/www/matita/install.html b/helm/www/matita/install.html
new file mode 100644 (file)
index 0000000..903066a
--- /dev/null
@@ -0,0 +1,454 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>Matita V0.1.0
+ Manual (rev. 0) - Chapter 2. Installation</title>
+  </head>
+  <body>
+    <div class="chapter" lang="en" xml:lang="en">
+      <div class="titlepage">
+        <div>
+          <div>
+            <h2 class="title"><a id="sec_install"></a>Chapter 2. Installation</h2>
+          </div>
+        </div>
+      </div>
+      <div class="toc">
+        <p>
+          <b>Table of Contents</b>
+        </p>
+        <dl>
+          <dt>
+            <span class="sect1">
+              <a href="#inst_from_src">Installing from sources</a>
+            </span>
+          </dt>
+          <dd>
+            <dl>
+              <dt>
+                <span class="sect2">
+                  <a href="#get_source_code">Getting the source code</a>
+                </span>
+              </dt>
+              <dt>
+                <span class="sect2">
+                  <a href="#build_requirements">Requirements</a>
+                </span>
+              </dt>
+              <dt>
+                <span class="sect2">
+                  <a href="#database_setup">Database setup</a>
+                </span>
+              </dt>
+              <dt>
+                <span class="sect2">
+                  <a href="#build_instructions">Compiling and installing</a>
+                </span>
+              </dt>
+            </dl>
+          </dd>
+        </dl>
+      </div>
+      <div class="sect1" lang="en" xml:lang="en">
+        <div class="titlepage">
+          <div>
+            <div>
+              <h2 class="title" style="clear: both"><a id="inst_from_src"></a>Installing from sources</h2>
+            </div>
+          </div>
+        </div>
+        <p>Currently, the only intended way to install Matita is starting
+      from its source code.  </p>
+        <div class="sect2" lang="en" xml:lang="en">
+          <div class="titlepage">
+            <div>
+              <div>
+                <h3 class="title"><a id="get_source_code"></a>Getting the source code</h3>
+              </div>
+            </div>
+          </div>
+          <p>You can get the Matita source code in two ways:
+       </p>
+          <div class="orderedlist">
+            <ol type="1">
+              <li>
+                <p> go to the <a href="http://matita.cs.unibo.it/download.shtml" target="_top">download
+               page</a> and get the <a href="http://matita.cs.unibo.it/sources/matita-latest.tar.gz" target="_top">latest released source tarball</a>;</p>
+              </li>
+              <li>
+                <p> get the development sources from <a href="http://helm.cs.unibo.it/websvn/listing.php?repname=helm&amp;path=%2F&amp;sc=0" target="_top">our
+               SVN repository</a>. You will need the
+             <span class="application">components/</span> and
+             <span class="application">matita/</span> directories from the
+             <code class="filename">trunk/helm/software/</code> directory, plus the
+             <code class="filename">configure</code> and <code class="filename">Makefile*</code>
+             stuff from the same directory.  </p>
+                <p>In this case you will need to run
+               <span><strong class="command">autoconf</strong></span> before proceding with the building
+               instructions below.</p>
+              </li>
+            </ol>
+          </div>
+          <p>
+      </p>
+        </div>
+        <div class="sect2" lang="en" xml:lang="en">
+          <div class="titlepage">
+            <div>
+              <div>
+                <h3 class="title"><a id="build_requirements"></a>Requirements</h3>
+              </div>
+            </div>
+          </div>
+          <p>In order to build Matita from sources you will need some
+       tools and libraries. They are listed below.
+
+       </p>
+          <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+            <h3 class="title">Note for Debian users</h3>
+            <p>If you are running a <a href="http://www.debian.org" target="_top">Debian GNU/Linux</a> distribution
+           you can have APT install all the required tools and libraries by
+           adding the following repository to your
+           <code class="filename">/etc/apt/sources.list</code>: </p>
+            <pre class="programlisting">
+             deb <a href="http://people.debian.org/~zack" target="_top">http://people.debian.org/~zack</a> unstable helm
+         </pre>
+            <p> and installing the
+         <span class="application">helm-matita-deps</span> package.</p>
+          </div>
+          <p>
+
+       </p>
+          <div class="variablelist">
+            <p class="title">
+              <b>Required tools and libraries</b>
+            </p>
+            <dl>
+              <dt>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://caml.inria.fr" target="_top">OCaml</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p> the Objective Caml compiler, version 3.09 or above </p>
+              </dd>
+              <dt>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://www.ocaml-programming.de/packages/" target="_top">Findlib</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p> OCaml package manager, version 1.1.1 or above</p>
+              </dd>
+              <dt>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://www.xs4all.nl/~mmzeeman/ocaml/" target="_top">OCaml
+                 Expat</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p>OCaml bindings for the <span class="application"><a href="http://expat.sourceforge.net/" target="_top">expat</a>
+                 library</span> </p>
+              </dd>
+              <dt>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://gmetadom.sourceforge.net/" target="_top">GMetaDOM</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p>OCaml bindings for the <span class="application"><a href="http://gdome2.cs.unibo.it/" target="_top">Gdome 2</a>
+                 library</span></p>
+              </dd>
+              <dt>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://www.bononia.it/~zack/ocaml-http.en.html" target="_top">OCaml
+                 HTTP</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p> OCaml library to write HTTP daemons (and clients) </p>
+              </dd>
+              <dt>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://wwwfun.kurims.kyoto-u.ac.jp/soft/lsl/lablgtk.html" target="_top">LablGTK</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p> OCaml bindings for the <span class="application"><a href="http://www.gtk.org" target="_top"> GTK+</a> library
+             </span>, version 2.6.0 or above </p>
+              </dd>
+              <dt>
+                <span class="term"><span class="application"><a href="http://helm.cs.unibo.it/mml-widget/" target="_top">GtkMathView</a></span>
+           , </span>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://helm.cs.unibo.it/mml-widget/" target="_top">LablGtkMathView</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p> GTK+ widget to render <a href="http://www.w3.org/Math/" target="_top">MathML</a> documents and its
+               OCaml bindings </p>
+              </dd>
+              <dt>
+                <span class="term"><span class="application"><a href="http://gtksourceview.sourceforge.net/" target="_top">GtkSourceView</a></span>
+           , </span>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://helm.cs.unibo.it/software/lablgtksourceview/" target="_top">LablGtkSourceView</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p> extension for the GTK+ text widget (adding the typical
+               features of source code editors) and its OCaml bindings </p>
+              </dd>
+              <dt>
+                <span class="term"><span class="application"><a href="http://www.mysql.com" target="_top">MySQL</a></span> , </span>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://raevnos.pennmush.org/code/ocaml-mysql/" target="_top">OCaml
+                 MySQL</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p> SQL database and OCaml bindings for its client-side library
+             </p>
+                <p> The SQL database itself is not strictly needed to run
+               Matita, but we stronly encourage its use since a lot of
+               features are disabled without it. Still, the OCaml bindings of
+               the library are needed at compile time.</p>
+              </dd>
+              <dt>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://ocamlnet.sourceforge.net/" target="_top">Ocamlnet</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p> collection of OCaml libraries to deal with
+               application-level Internet protocols and conventions </p>
+              </dd>
+              <dt>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://www.cduce.org/download.html#side" target="_top">ulex</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p> Unicode lexer generator for OCaml </p>
+              </dd>
+              <dt>
+                <span class="term">
+                  <span class="application">
+                    <a href="http://cristal.inria.fr/~xleroy/software.html#camlzip" target="_top">CamlZip</a>
+                  </span>
+                </span>
+              </dt>
+              <dd>
+                <p> OCaml library to access <code class="filename">.gz</code> files
+             </p>
+              </dd>
+            </dl>
+          </div>
+          <p> </p>
+        </div>
+        <div class="sect2" lang="en" xml:lang="en">
+          <div class="titlepage">
+            <div>
+              <div>
+                <h3 class="title"><a id="database_setup"></a>Database setup</h3>
+              </div>
+            </div>
+          </div>
+          <p> To fully exploit Matita indexing and search capabilities you
+       will need a working <span class="application"><a href="http://www.mysql.com" target="_top">MySQL</a></span> database. Detalied instructions on how to do
+       it can be found in the <a href="http://dev.mysql.com/doc/" target="_top">MySQL documentation</a>. Here you
+       can find a quick howto. </p>
+          <p> In order to create a database you need administrator permissions on
+       your MySQL installation, usually the root account has them. Once you
+       have the permissions, a new database can be created executing
+       <strong class="userinput"><code>mysqladmin create matita</code></strong>
+       (<span class="emphasis"><em>matita</em></span> is the default database name, you can
+       change it using the <em class="parameter"><code>db.user</code></em> key of the
+       configuration file). </p>
+          <p> Then you need to grant the necessary access permissions to the
+       database user of Matita, typing <strong class="userinput"><code>echo "grant all privileges
+         on matita.* to helm;" | mysql matita</code></strong> should do the trick
+       (<span class="emphasis"><em>helm</em></span> is the default user name used by Matita to
+       access the database, you can change it using the
+       <em class="parameter"><code>db.user</code></em> key of the configuration file).
+      </p>
+          <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+            <h3 class="title">Note</h3>
+            <p> This way you create a database named <span class="emphasis"><em>matita</em></span>
+         on which anyone claiming to be the <span class="emphasis"><em>helm</em></span> user can
+         do everything (like adding dummy data or destroying the contained
+         one). It is strongly suggested to apply more fine grained permissions,
+         how to do it is out of the scope of this manual.</p>
+          </div>
+        </div>
+        <div class="sect2" lang="en" xml:lang="en">
+          <div class="titlepage">
+            <div>
+              <div>
+                <h3 class="title"><a id="build_instructions"></a>Compiling and installing</h3>
+              </div>
+            </div>
+          </div>
+          <p> Once you get the source code the installations steps should be
+       quite familiar.</p>
+          <p> First of all you need to configure the build process executing
+       <strong class="userinput"><code>./configure</code></strong>. This will check that all needed
+       tools and library are installed and prepare the sources for compilation
+       and installation. </p>
+          <p> Quite a few (optional) arguments may be passed to the
+       <span class="application">configure</span> command line to change build time
+       parameters. They are listed in the table below, together with their
+       default values.
+
+       </p>
+          <div class="table">
+            <a id="id2497494"></a>
+            <p class="title">
+              <b>Table 2.1.  <span class="application">configure</span> command line
+           arguments</b>
+            </p>
+            <table border="1" summary=" configure command line      arguments">
+              <colgroup>
+                <col />
+                <col />
+                <col />
+              </colgroup>
+              <thead>
+                <tr>
+                  <th align="center">Argument</th>
+                  <th align="center">Default</th>
+                  <th align="center">Description</th>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <td align="left">
+                    <strong class="userinput">
+                      <code>--with-runtime-dir=<em class="replaceable"><code>dir</code></em></code>
+                    </strong>
+                  </td>
+                  <td align="left">
+                    <code class="filename">/usr/local/matita/</code>
+                  </td>
+                  <td align="left">
+                    <p> Runtime base directory where all Matita stuff
+                   (executables, configuration files, standard
+                   library, ...) will be installed </p>
+                  </td>
+                </tr>
+                <tr>
+                  <td align="left">
+                    <strong class="userinput">
+                      <code>--with-dbhost=<em class="replaceable"><code>host</code></em></code>
+                    </strong>
+                  </td>
+                  <td align="left"> localhost </td>
+                  <td align="left">
+                    <p>Default SQL server hostname. Will be used while
+                   building the standard library during the installation and to
+                   create the default Matita configuration. May be changed
+                   later in configuration file.</p>
+                  </td>
+                </tr>
+                <tr>
+                  <td align="left">
+                    <strong class="userinput">
+                      <code>--enable-debug</code>
+                    </strong>
+                  </td>
+                  <td align="left"> disabled </td>
+                  <td align="left">
+                    <p> Enable debugging code. Not for the casual user.
+                 </p>
+                  </td>
+                </tr>
+              </tbody>
+            </table>
+          </div>
+          <p>
+
+      </p>
+          <p> Then you will manage the build and install process using
+       <span class="application"><a href="http://www.gnu.org/software/make/" target="_top">make</a></span>
+       as usual. Below are reported the targets you have to invoke in sequence
+       to build and install.
+
+       </p>
+          <div class="variablelist">
+            <p class="title">
+              <b><span class="application">make</span> targets</b>
+            </p>
+            <dl>
+              <dt>
+                <span class="term">
+                  <strong class="userinput">
+                    <code>world</code>
+                  </strong>
+                </span>
+              </dt>
+              <dd>
+                <p>builds components needed by Matita and Matita itself
+               (in bytecode only or in both bytecode and native code depending
+               on the availability of the OCaml native code compiler) </p>
+              </dd>
+              <dt>
+                <span class="term">
+                  <strong class="userinput">
+                    <code>library</code>
+                  </strong>
+                </span>
+              </dt>
+              <dd>
+                <p>uses the (just built) <span class="application">matitac</span>
+               compiler to build the Matita standard library. </p>
+                <p>For this step you will need a working SQL database (for
+               indexing the standard library while you are compiling it). See
+               <a href="#database_setup" target="_top">Database setup</a>
+               for instructions on how to set it up.</p>
+              </dd>
+              <dt>
+                <span class="term">
+                  <strong class="userinput">
+                    <code>install</code>
+                  </strong>
+                </span>
+              </dt>
+              <dd>
+                <p>installs Matita related tools, standard library and the
+               needed runtime stuff in the proper places on the filesystem
+             </p>
+              </dd>
+            </dl>
+          </div>
+          <p>
+
+      </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>