Development:QuickStart
Quickstart Guide
A step-by-step document on how to build the whole thing would help new users to get started, help new programmers understand the dependencies, and help experienced developers see places the process could be improved.
Warning
The most of this tutorial is just text,
commands are initiated by a dollar sign ($)
If you copy and paste the commands, let the $ out.
Preparation of the development environment
Make sure you installed needed software! You need:
- cvs
- doxygen
- and the stuff mentioned by the Dependency Matrix.
(look at http://adonthell.berlios.de/doc/index.php/Development:Dependency_Matrix) Debian users will use aptitude or apt-get. SuSE users have YaST.
Prepare a new working directory. Lets assume /home/enrico/vanilla_adonthell to be the working dir in this tutorial. If your username is not enrico, adapt it to your needs.
Obtaining the code
Change to the working directory and execute
$ cvs -z6 -d:pserver:[email protected]:/sources/adonthell co adonthell
(more info at
http://adonthell.berlios.de/doc/index.php/Development:CVS)
Congratulation, now you got the sourcecode. The tricky part begins.
Compilation
assuming you are in
/home/enrico/vanilla_adonthell
$ mkdir adonthell-build && cd adonthell-build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr/local ../adonthell
$ make
(details at http://adonthell.berlios.de/doc/index.php/Development:Compiling)
Installation
make sure you are in
/home/enrico/vanilla_adonthell/adonthell-build
$ sudo make install
or as superuser
$# make install
Test
make sure you are in
/home/enrico/vanilla_adonthell/adonthell-build
$ test/worldtest -g ../adonthell/test/
the previous command should present a small demo
doc
has to be created
change dir to ../adonthell/doc/ and execute
$ doxygen reference.cfg
API-doc is now in /home/enrico/vanilla_adonthell/adonthell/doc/adonthell-api/index.html