pkg-kde-tools for Debian
------------------------

Using with Debhelper Command Sequencer `dh`
------------------------------------------

pkg-kde-tools provides a couple of additions to dh(1) and its toolset.

* Debhelper build system 'kde'. It is based on the debhelper build system
  'cmake'. The only difference is that in addition it passes KDE 4 specific
  flags to cmake by default. In order to use it, pass --buildsystem=kde when
  running dh_auto_*. Debhelper 7.3.0 or later is required to use this build
  system.
* dh sequence addon 'kde'. It will tweak default dh sequences to be best
  suitable for building KDE applications. For example, that includes passing of
  --buildsystem=kde to all dh_auto_* commands by default and other
  enhancements. Debhelper 7.3.16 or later is required to use this addon.

In order to build a simple KDE package, all you need to do is to pass `--with
kde` option to dh(1). More advanced usage (e.g. to pass additional flags to
cmake) may require overriding of some debhelper commands (e.g.
dh_auto_configure). See examples below for more details.

In order to kde dh sequence addon, you must depend on debhelper (>= 7.3.16) and
pkg-kde-tools (>= 0.5). What's more, pkg-kde-tools (>= 0.6.2) has more
interesting changes like dh_movelibkdeinit and docbook exclusion from
dh_compress.

Examples
--------

* A very simple KDE package using dh.

-------> debian/rules <-------
#!/usr/bin/make -f

%:
	dh $@ --with kde
------------------------------

* A more complicated KDE package using dh. Additional -DSOME_FLAG is passed to
  cmake and quilt addon is used for managing patches.

-------> debian/rules <-------
#!/usr/bin/make -f

override_dh_auto_configure:
	dh_auto_configure --buildsystem=kde -- -DSOME_FLAG=some_value

%:
	dh $@ --with quilt,kde
------------------------------
