================================================
Installation of the MusicBrainz Client Library
================================================
The instructions in this file should help you to build and install the
MusicBrainz client library from source on your system.
Dependencies
============
Before you start, make sure you have installed following libraries:
* Neon -- HTTP client library
http://www.webdav.org/neon/
Building
========
Once you have installed all dependencies, you can compile the
library:
cmake .
make
And to install the built library run (as root):
make install
Cross Compiling
===============
Cross compiling is a little more involved due to the automatic generation
of the C interface source files. Your cross compilation environment will
need appropriate headers and libraries for any dependencies.
First set up a toolchain file as specified here:
http://www.cmake.org/Wiki/CMake_Cross_Compiling#The_toolchain_file
Then build natively to generate the appropriate make-c-interface file
mkdir build-native
cd build-native
cmake ..
make
Finally, cross compile, telling cmake where to find your toolchain and the
make-c-interface binary:
mkdir build-cross
cd build-cross
cmake -DCMAKE_TOOLCHAIN_FILE=~/powerpc-cross \
-DIMPORT_EXECUTABLES=../build-native/ImportExecutables.cmake ..
make
CMake Options
=============
By default, the library will be installed to /usr/local. You can change this
using the CMAKE_INSTALL_PREFIX option, for example:
cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr .
To disable debug messages, change the build type:
cmake -DCMAKE_BUILD_TYPE=Release .
For overview of all available options use:
cmake -L .
or use a GUI. See http://www.cmake.org/HTML/RunningCMake.html for more details.