Compile
From Elektra Initiative
When you download the .tar.gz or checkout from svn you have to compile Elektra. Elektra consists of some libraries, executeables, extra-dist and header files. Because of that reason it is not a trivial task to make it install on your system correctly. If you want to help the elektra initiative, just read on.
Please report any bug on our Bug Database
Contents |
autotools
We are using autotools to make it compile and installable on a great variety of platforms. If you don't have the configure script (because you checked it out from svn) or you want to test it with another automake/libtool version make sure you have installed autoconf 2.61 and automake 1.9.6 or later and you need gettext-devel installed (Previous versions may have the mkdir_p bug and just run
./boostrap.sh
It cleans up the source tree, runs libtoolize, aclocal, autoheader, automake and in the end autoconf to generate the ./configure. There is also libltdl available within elektra. This software is used on systems where libtool does not support the linking system. It is bootstraped too anyway.
./configure
Now you can proceed like described in the README. To make it compileable under Debian you need:
--with-docbook="/usr/share/xml/docbook/stylesheet/nwalsh
make sure you specified your favourite prefix, assuming /usr/local as default
--prefix=/home/markus
and to have the experimental stuff and the debug symbols you need
--enable-debug --enable-experimental
Compile
Now just run
make
to get everything compiled. Please report any warning and errors (!) to the Bug Database. You help us a lot with that.
Test
Thus we produce a library and testing with some applications (like hello world and the kdb utility) does not lead to a mature library we have a large testing framework. Every incompatible change in the library, should make at least one test case fail. Otherwise consider it as a bug.
To run the tests, change to the tests directory and type
make check
Documentation
A comprehensive and detailled documentation is available in-source. If you prefer reading in another format use doxygen to produce the documentation. In
src/Doxyfile
you can specify the output formats. Just mark the appropriate GENERATE_ tags with YES. Change directory to doc/ and run make there.
