For brief building instructions, see INSTALL.

Developers environment
======================

You need the following software:

* CMake
    Debian: "cmake"
    http://packages.debian.org/sid/cmake

* pkg-config
    Debian: "pkg-config"
    http://packages.debian.org/sid/pkg-config

* msgfmt
    Debian: "gettext"    
    http://packages.debian.org/sid/gettext    

* Qt4 libraries
    Debian: "libqt4-dev"
    http://packages.debian.org/sid/libqt4-dev

* KDE4 SDK and libraries
    Debian: "kdesdk", "kdelibs5-dev"
    http://packages.debian.org/sid/kdesdk
    http://packages.debian.org/sid/kdelibs5-dev

* ALSA library
    Debian package: "libasound2-dev"
    http://packages.debian.org/sid/libasound2-dev

* Drumstick libraries
    http://drumstick.sourceforge.net

Getting the development sources
===============================

Compiling and hacking the SVN sources is a bit different compared to the
distribution tarball. You can get the latest sources either using a sourceforge
user account, or the anonymous user (with read only rights). The SVN client  
documentation for SourceForge users is available at
http://sourceforge.net/apps/trac/sourceforge/wiki/Subversion#Access

1. Check out the module drumstick from the SVN repository.
        Host: drumstick.svn.sourceforge.net
        Path: /svnroot/drumstick/trunk
        Module: drumstick

example:
$ svn co https://drumstick.svn.sourceforge.net/svnroot/drumstick/trunk drumstick 

2. Check out the module kmetronome from the SVN repository.
        Host: kmetronome.svn.sourceforge.net
        Path: /svnroot/kmetronome/trunk
        Module: kmetronome

example:
$ svn co https://kmetronome.svn.sourceforge.net/svnroot/kmetronome/trunk kmetronome 

3. Create the links for 'drumstick' in the kmetronome directory.
$ cd kmetronome
$ ./link-drumstick

The module 'drumstick' is also used by other projects in a similar way. It may 
also be used as an independent shared dynamic library.

4. Configure and compile

$ mkdir build
$ cd build
$ cmake .. -DCMAKE_BUILD_TYPE=debug \
           -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` \
           -DSTATIC_DRUMSTICK=YES

$ make VERBOSE=1

5. Hack and enjoy!
