X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=README.md;h=bcf998191629f9d6919d4a7e4328a15d96ead72d;hb=c5d4383f38e610b997e2565a49da350f63558f88;hp=ee33a7e4c5049f05b8956a874d78df8470e954ee;hpb=0c9926d385f357e4a0a8bb2932da0aa6e2503b9b;p=apps%2Fagl-service-can-low-level.git diff --git a/README.md b/README.md index ee33a7e4..bcf99819 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,49 @@ # Low level CAN signaling binder -Low level CAN bus binder. Based upon OpenXC vi-firmware project. +Low level CAN bus binder, based upon OpenXC vi-firmware project. -# Getting started +Full document can be found under `docs` directory. -This repo make use of git submodule, make sure to execute the following commands : +# Generate documentation - ~/CAN_Signaling$ git submodule init - ~/CAN_Signaling$ git submodule update +## Prerequisites -# Prerequirements +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 doxygen graphviz +``` + +Prepare your build environment: + +```bash +mkdir build && cd build +cmake .. +``` + +## Generation + +Generate a PDF version : + +```bash +make pdf +``` + +Serve an HTML version, this will run a web server that will serve you locally documentation : + +```bash +make serve +``` + +Generate doxygen documentation: + +```bash +make doxygen +``` \ No newline at end of file