Index: NEMO/trunk/INSTALL.rst
===================================================================
--- NEMO/trunk/INSTALL.rst	(revision 10201)
+++ NEMO/trunk/INSTALL.rst	(revision 10279)
@@ -1,9 +1,7 @@
-=====================
+*********************
 Install the framework
-=====================
+*********************
 
-.. include:: .global.rst
-
-.. contents:: \
+.. contents::
 	:local:
       
@@ -24,5 +22,6 @@
 =======================
 
-Download the source code 
+Download the source code
+------------------------
 
 .. code:: console
@@ -31,31 +30,32 @@
 
 Description of directory tree
-=============================
+-----------------------------
 
-+-----------+---------------------------------------------------------------+
-| Folder    | Purpose                                                       |
-+===========+===============================================================+
-| ``arch``  | Settings (per architecture-compiler pair)                     |
-+-----------+---------------------------------------------------------------+
-| ``cfgs``  | Reference configurations                                      |
-+-----------+---------------------------------------------------------------+
-| ``doc``   | - ``latex``: reference manuals for NEMO, SI\ :sup:`3`\  & TOP |
-|           | - ``rst``:   quick start guide                                |
-+-----------+---------------------------------------------------------------+
-| ``ext``   | Dependencies included (AGRIF, FCM & IOIPSL)                   |
-+-----------+---------------------------------------------------------------+
-| ``mk``    | Building  routines                                            |
-+-----------+---------------------------------------------------------------+
-| ``src``   | Modelling routines                                            |
-|           |                                                               |
-|           | - ``ICE``: SI\ :sup:`3`\ for sea ice                          |
-|           | - ``NST``: AGRIF         for embedded zooms                   |
-|           | - ``OCE``: OPA           for ocean dynamics                   |
-|           | - ``MBG``: TOP           for tracers                          |
-+-----------+---------------------------------------------------------------+
-| ``tests`` | Test cases                                                    |
-+-----------+---------------------------------------------------------------+
-| ``tools`` | Utilities to [pre|post]process data                           |
-+-----------+---------------------------------------------------------------+
++-----------+------------------------------------------------------------+
+| Folder    | Purpose                                                    |
++===========+============================================================+
+| ``arch``  | Settings (per architecture-compiler pair)                  |
++-----------+------------------------------------------------------------+
+| ``cfgs``  | :doc:`Reference configurations <configurations>`           |
++-----------+------------------------------------------------------------+
+| ``doc``   | - ``latex``: reference manuals for |OPA|, |SI3| & |TOP|    |
+|           | - ``namelists``: k start guide                             |
+|           | - ``rst``:   quick start guide                             |
++-----------+------------------------------------------------------------+
+| ``ext``   | Dependencies included (AGRIF, FCM & IOIPSL)                |
++-----------+------------------------------------------------------------+
+| ``mk``    | Building  routines                                         |
++-----------+------------------------------------------------------------+
+| ``src``   | Modelling routines                                         |
+|           |                                                            |
+|           | - ``ICE``: |SI3| for sea ice                               |
+|           | - ``NST``: AGRIF for embedded zooms                        |
+|           | - ``OCE``: |OPA| for ocean dynamics                        |
+|           | - ``MBG``: |TOP| for tracers                               |
++-----------+------------------------------------------------------------+
+| ``tests`` | :doc:`Test cases <test_cases>` (unsupported)               |
++-----------+------------------------------------------------------------+
+| ``tools`` | :doc:`Utilities <tools>` to [pre|post]process data         |
++-----------+------------------------------------------------------------+
 
 Extract and install XIOS
@@ -121,5 +121,4 @@
 	.. literalinclude::
 
------------------
 Default behaviour
 -----------------
@@ -128,5 +127,4 @@
     If –n option is not specified, ORCA2_LIM is the default configuration used. 
 
------------------------------
 Tools used during the process
 -----------------------------
@@ -136,5 +134,4 @@
     bld.cfg : FCM rules to compile 
 
---------
 Examples
 --------
@@ -163,7 +160,6 @@
         echo "./makenemo -n MY_CONFIG -j0 add_key \"key_iomput key_mpp_mpi\" del_key \"key_agrif\" ";
 
------------------
 Running the model
------------------
+=================
 
 Once makenemo has run successfully, the opa executable is available in ``CONFIG/MY_CONFIG/EXP00``
@@ -173,7 +169,6 @@
    mpirun -n $NPROCS ./opa    # $NPROCS is the number of processes ; mpirun is your MPI wrapper
 
---------------------------------------------
 Viewing and changing list of active CPP keys
---------------------------------------------
+============================================
 
 For a given configuration (here called MY_CONFIG), the list of active CPP keys can be found in::
