== Building Telepathy-Qt from sources ==

=== Prerequisites ===

Qt4.3.x or later:

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

  KDE's qt-copy should work just as well.

=== Building Telepathy-Qt ===

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

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

== Current pitfalls ==

Currently there are no known pitfalls.

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

== Generating the sources ==

All source files in Telepathy-Qt are generated directly from the telepathy-spec
XML files.

To (re-)generate the source, header and buildsystem files you need to do this:

1. update the telepathy spec XML files found in the spec directory.
2. change into the scripts directory.
3. run ./generate_everything.sh there.
4. Follow the normal build instructions and do a test build. Fix
   any breakage you encounter (and you will encounter some as qdbusxml2cpp
   just can not generate some D-Bus constructs).
5. Remove files no longer needed.

