This file is indexed.

/usr/share/doc/pkg-kde-tools/README.Debian is in pkg-kde-tools 0.15.28ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
pkg-kde-tools for Debian
------------------------

 These snippets (/usr/share/pkg-kde-tools/makefiles/1) should be universally
 usable:
  - If your package uses CDBS, you should be able to just include the
    cdbs/kde.mk file.
  - If you use other tools, include the variables.mk file and run cmake with
    $(DEB_CMAKE_KDE4_FLAGS) to get the kde4 default variables.
  - If you want to use Debhelper dh(1) command sequencer, you will find section
    "Using with Debhelper Command Sequencer `dh`" below interesting. Please
    note that /usr/share/pkg-kde-tools/makefiles/1/debhelper/kde.mk has been
    dropped in pkg-kde-tools 0.7.0.

 In order to link with --as-needed (disabled by default), you could set
 DEB_KDE_LINK_WITH_AS_NEEDED to 'yes' before the include. However, please note
 that enabling DEB_KDE_LINK_WITH_AS_NEEDED implicitly links with --no-undefined
 as well unless DEB_KDE_LINK_WITH_NO_UNDEFINED is set to `no`.

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 CDBS using package.

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

include /usr/share/pkg-kde-tools/makefiles/1/cdbs/kde.mk
include /usr/share/cdbs/1/rules/debhelper.mk
------------------------------

* A non CDBS using package could start with something like the following
  and end up like any other cmake using package.

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

include /usr/share/pkg-kde-tools/makefiles/1/variables.mk

builddir/Makefile:
	dh_testdir

	mkdir -p builddir
	cd builddir && cmake .. \
		-DCMAKE_INSTALL_PREFIX=/usr \
		-DCMAKE_C_FLAGS="$(CPPFLAGS) $(CFLAGS)" \
		-DCMAKE_LD_FLAGS="$(LDFLAGS) -Wl,-z,defs" \
		-DCMAKE_CXX_FLAGS="$(CPPFLAGS) $(CXXFLAGS)" \
		-DCMAKE_SKIP_RPATH=ON \
		-DCMAKE_VERBOSE_MAKEFILE=ON \
		$(DEB_CMAKE_KDE4_FLAGS)

build: build-stamp
build-stamp: builddir/Makefile
	dh_testdir

	$(MAKE) -C builddir

	touch $@
------------------------------

* 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
------------------------------