== Building Decibel from sources ==

=== Prerequisites ===

Qt4.3.x:

  Qt should be prepackaged for all mayor linux distributions. Please see
  http://www.trolltech.com/products/qt for more information and installation
  instructions.

Telepathy:

  Telepathy is primarily a specification. No need to install anything.

  If you want to have Connection Managers either check your distribution
  (ubuntu eg. ships with gabble and more) or check
  http://telepathy.freedesktop.org/wiki/

Telepathy-Qt (>= SVN Revision 2031):

  Qt bindings for Telepathy. Get them from SVN (svn root is:
  https://tapioca-voip.svn.sourceforge.net/svnroot/tapioca-voip/trunk/telepathy-qt)

  To build it do the following after switching into the checkout directory:

    mkdir build && cd build
    cmake ..
    make && make install

Tapioca-Qt (>= SVN Revision 2031):

  Tapioca Qt hides some of the more ugly corners of telepathy from
  the Qt developer. Grab it from SVN (svn root is:
  https://tapioca-voip.svn.sourceforge.net/svnroot/tapioca-voip/trunk/tapioca-qt)

  If you require DTMF support you may want to add the patch tapioca-dtmf.diff
  found in the patches directory of the Decibel sources before building
  Tapioca Qt.

  To build it do the following after switching into the checkout directory:

    mkdir build && cd build
    cmake ..
    make && make install

KDE 4 (>= 4.0alpha2) [ OPTIONAL ]

  The KDE4 integration will only be build if a KDE4 development environment
  is found.

  The optional KDE4 integration of Decibel requires kdelibs and kdebase
  (with all their dependencies).

  See http://techbase.kde.org/Getting_Started/Build/Unstable_Version
  for instructions on how to build and setup a KDE4 environment to work in.


=== Building Decibel ===

Decibel:

 To build it do the following after switching into the checkout directory:

    mkdir build && cd build
    cmake ..
    make && make install

 Please run the testsuite after building and report results back to us:
 One of the tests will bring a jabber account online. If you want to run
 this one, you need to define the environment variables DECIBEL_TS_JABBER_USER
 and DECIBEL_TS_JABBER_PASSWD.

    export DECIBEL_TS_JABBER_USER="user@some.host"
    export DECIBEL_TS_JABBER_PASSWD="password_of_that_user"
    make test


== Current pitfalls ==

Currently there are no known pitfalls.

Please report any pitfalls you encounter to our mailing list at
  decibel@kde.org.

