= Using robotpkg to build openrobots =

[http://softs.laas.fr/openrobots/robotpkg/README.html Robotpkg] is a set of build and packaging tools, inspired by [http://pkgsrc.se/ pkgsrc], designed to build and install OpenRobots packages. 

== Getting robotpkg ==

 * Decide in which directory you'll install OpenRobots. We'll assume `/usr/local/openrobots` in this document. 

 {{{
mkdir -p /usr/local/openrobots
}}}

 * clone the [http://git.or.cz git] repository for robotpkg to your work space: 

 {{{
cd /usr/local/openrobots
mkdir src
cd src
git clone git://softs.laas.fr/git/robots/robotpkg
}}}

== Bootstrapping ==

 * edit your shell startup file : 

  * set the ROBOTPKG_BASE environment variable to `/usr/local/openrobots`
  * add `/usr/local/openrobots/bin:/usr/local/openrobots/sbin` to your PATH

  * If you're using [t]csh this can be done by adding the following to `${HOME}/.login`: 
  {{{
# OpenRobots
setenv PATH /usr/local/openrobots/bin:/usr/local/openrobots/sbin:$PATH
setenv ROBOTPKG_BASE /usr/local/openrobots
}}}

  * If you're using `bash` or `ksh`, add the following to `${HOME}/.profile`:
  {{{
# OpenRobots
export PATH=/usr/local/openrobots/bin:/usr/local/openrobots/sbin:$PATH
export ROBOTPKG_BASE=/usr/local/openrobots
}}}

 * Run the `bootstrap` script from `/usr/local/openrobots/src/robotpkg/bootstrap/`

 {{{
cd /usr/local/openrobots/src/robotpkg/bootstrap
./bootstrap --prefix=/usr/local/openrobots
}}}


=== Building modules ===

 * Go to the sub-directory of robotpkg corresponding to the package you want and run `make install`. For instance
 {{{
cd /usr/local/openrobots/src/robotpkg/hardware/platine-genom
make install
}}}

 will install the '''platine''' module and all its dependencies (pocolibs, genom, hardlib, etc.)