Update README.md [skip ci]

README.md

@@ -4,12 +4,13 @@ dynamic-graph
 [![Build Status](https://travis-ci.org/stack-of-tasks/dynamic-graph.png)](https://travis-ci.org/stack-of-tasks/dynamic-graph)
 [![Coverage Status](https://coveralls.io/repos/stack-of-tasks/dynamic-graph/badge.png?branch=master)](https://coveralls.io/r/stack-of-tasks/dynamic-graph?branch=master)
 
+![LGPL-3](https://www.gnu.org/graphics/lgplv3-88x31.png)
 
 This software provides an efficient way to modelize a C++ data-flow.
 
 A dynamic graph data-flow is composed of:
- - entities (graph nodes)
- - signals (input/output of a graph action)
+ * entities (graph nodes)
+ * signals (input/output of a graph action)
 
 Output signals can then be plugged into input signals to data
 transmission.
@@ -17,17 +18,150 @@ transmission.
 An efficient caching mechanism avoid useless data recomputation and a
 simple built-in language can be used to control the graph actions.
 
+It is released under the [LGPL-3](COPYING.LESSER) license.
 
-Setup
------
 
-To compile this package, it is recommended to create a separate build
-directory:
+**Warning:** this repository contains [Git
+submodules][git-submodules]. Please clone this repository using the
+`git clone --recursive` command. If you already have cloned the
+repository, you can run `git submodule init && git submodule update`
+to retrieve the submodules.
 
-    mkdir _build
-    cd _build
-    cmake [OPTIONS] ..
-    make install
 
-Please note that CMake produces a `CMakeCache.txt` file which should
-be deleted to reconfigure a package from scratch.
+Documentation
+-------------
+
+To get started with this library, please read the [online Doxygen
+documentation][doxygen-documentation].
+
+It can also be generated locally by running the `make doc`
+command. After the package is installed, the documentation will be
+located in the `$prefix/share/doc/dynamic-graph` directoy where
+`$prefix` is your installation prefix (`/usr/local` by default).
+
+
+Getting Help
+------------
+
+Support is provided through:
+ * the HPP mailing-list: hpp@laas.fr
+ * the following HipChat room: http://www.hipchat.com/gh4wQrZeV
+
+
+How can I install dynamic-graph?
+--------------------------------
+
+### Installing dependencies
+
+The matrix abstract layer depends on several packages which
+have to be available on your machine.
+
+ - Libraries:
+   - [Boost][] (>= 1.40)
+     Its detection is controled by the `BOOST_ROOT` variable, see next section
+     for more information.
+   - [Lapack][] library
+     Use the generic purpose `CMAKE_CXX_FLAGS` and `CMAKE_EXE_LINKER_FLAGS`
+     to insert the flags required for the compiler to find your Lapack library
+     if it is installed in a non-standard directory.
+   - [jrl-mal][] library
+ - System tools:
+   - [CMake][] (>=2.6)
+   - [pkg-config][]
+   - usual compilation tools (GCC/G++, make, etc.)
+     If you are using Ubuntu, these tools are gathered in the `build-essential` package.
+
+
+
+### Compiling and installing the package
+
+The manual compilation requires two steps:
+
+ 1. configuration of the build and generation of the build files
+ 2. compilation of the sources and installation of the package
+
+dynamic-graph uses [CMake][] to generate build files. It is
+recommended to create a separate build directory:
+
+```sh
+mkdir _build         # (1) Create a build directory
+cd _build            # (2) Go to the newly created build directory
+cmake [options] ..   # (3) Generate the build files
+```
+
+Options which can be passed to CMake are detailed in the next section.
+
+```sh
+make                 # (4) Compile the package
+make test            # (5) Execute the package tests
+make install         # (6) Install the package into the prefix (see step 3)
+```
+
+
+### Options
+
+Additional options can be set on the command line through the
+following command: `-D<option>=<value>`.
+
+For instance: `cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo ..` will set
+the `CMAKE_BUILD_TYPE` option to the value `RelWithDebInfo`.
+
+
+Available options are:
+
+- `CMAKE_BUILD_TYPE` set the build profile that should be used (debug,
+  release, etc.). We recommend `RelWithDebInfo` as it will provide
+  performances while keeping debugging symbols enabled.
+- `CMAKE_INSTALL_PREFIX` set the installation prefix (the directory
+  where the software will be copied to after it has been compiled).
+
+
+### Running the test suite
+
+The test suite can be run from your build directory by running:
+
+```sh
+   make test
+```
+
+Please open a ticket if some tests are failing on your computer, it
+should not be the case.
+
+
+Contributing
+------------
+
+If you want to contribute, please refer to the
+[CONTRIBUTING.md](CONTRIBUTING.md) file
+
+Credits
+-------
+
+This package authors are credited in the [AUTHORS](AUTHORS) file.
+
+
+
+Available Packages
+------------------
+
+ * RobotPkg (Release 2.5.3r1):
+   http://robotpkg.openrobots.org/robotpkg/motion/dynamic-graph/index.html
+
+
+[doxygen-documentation]: http://stack-of-tasks.github.io/dynamic-graph/doxygen/HEAD/
+
+[jrl-mathtools]: https://github.com/jrl-umi3218/jrl-mathtools
+[jrl-mal]: https://github.com/jrl-umi3218/jrl-mal
+
+[git-submodules]: http://git-scm.com/book/en/Git-Tools-Submodules
+
+[Boost]: http://www.boost.org/
+[CMake]: htttp://www.cmake.org/
+[Doxygen]: http://www.stack.nl/~dimitri/doxygen/
+[Eigen]: http://eigen.tuxfamily.org/
+[Git]: http://git-scm.com/
+[Lapack]: http://www.netlib.org/lapack/
+[Libtool]: https://www.gnu.org/software/libtool/
+[RobotPkg]: http://robotpkg.openrobots.org/
+[log4cxx]: https://logging.apache.org/log4cxx/
+[pkg-config]: http://www.freedesktop.org/wiki/Software/pkg-config/