Mihini/Mihini Generate Documentation

From Eclipsepedia

< Mihini
Revision as of 11:16, 17 April 2013 by Lbarthelemy.sierrawireless.com (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

1. Get the source


Mihini Git repository


2. Install prerequisites


Install pandoc and doxygen on your dev machine: usually it is as simple as using the package manager of your operating system. Example:

sudo apt-get install pandoc doxygen

More details on:

3. Build the documentation


Building the documentation is linked to Mihini build system, that is explained in Mihini Linux build instructions

build.sh
cd build.default
make mdoc doxygen_gen luaExecEnv

There are 3 targets:

  • mdoc: Markdown documentation with agent internal documentation, specifications,etc
  • luaExecEnv: Lua APIs documentation in a "doxygen-like" form, it also generates a Lua Execution Environment file for Koneki IDE
  • doxygen_gen: C APIs documentation


4. Doc Artifacts


Everything is generated as html in:

build.default/doc/md
build.default/doc/ldoc
build.default/doc/doxygen