X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=README.md;h=1629ffbcd1a34c45ec737aa0cebd9f901706f907;hb=71c41df6cd794b670f9a16ca060a9c4ab054200e;hp=f346327267ee41fc3a197b0b13c6115bd71faead;hpb=16db388d019dba0dcae16004c5529d5ee0760b3a;p=apps%2Fagl-service-can-low-level.git

diff --git a/README.md b/README.md
index f3463272..1629ffbc 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,67 @@
-# Low level CAN signaling binder
+# CAN signaling binder
 
-Low level CAN bus binder, based upon OpenXC vi-firmware project.
+CAN bus binder, based upon OpenXC vi-firmware project.
+
+There are 2 separated projects here, one with the CAN-binder that is installed
+on an AGL target and the CAN config generator used to generate a source file for
+the low level binding.
 
 Full document can be found under `docs` directory.
-Note that your can use gitbook to serve documentation:
+
+# Fast build procedure
+
+Just use build.sh script:
+
+```bash
+./build.sh
+```
+
+This will build both projects under build directory for each of them with default configuration.
+
+# Generate documentation
+
+## Prerequisites
+
+You can use gitbook to serve documentation. To do so, please install it using *npm* as well as *calibre* package from your package distribution manager:
+
+```bash
+sudo npm install -g gitbook-cli
+sudo apt-get install calibre
 ```
+
+To generate Doxygen documentation, you'll need doxygen and graphviz:
+
+```bash
+sudo apt-get install doxygen graphviz
+```
+
+Prepare your build environment:
+
+```bash
 mkdir build && cd build
 cmake ..
-make serve-docs
-```
\ No newline at end of file
+```
+
+## Generation
+
+Generate a PDF version :
+
+```bash
+gendocs.sh pdf
+```
+
+Serve an HTML version, this will run a web server that will serve you locally documentation :
+
+```bash
+gendocs.sh serve
+```
+
+Generate doxygen documentation:
+
+```bash
+gendocs.sh doxygen
+```
+or
+```bash
+cd build && make doxygen
+```