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 |
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.
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
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.
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
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.
