[SCM] kdoctools packaging branch, master, updated. debian/5.22.0-1-4-gcfcabfc

[Harald Sitter]

Gitweb-URL: http://git.debian.org/?p=pkg-kde/frameworks/kdoctools.git;a=commitdiff;h=cfcabfc

The following commit has been merged in the master branch:
commit cfcabfce87cdfbd16c3585714abda0efbba6a461
Author: Harald Sitter <sitter at kde.org>
Date:   Fri Jul 8 12:25:25 2016 +0200

    change dev package name to cmake package name
    
    as discussed at munich sprint.
    
    rationale:
    The majority of KF5 libraries are one library with a matching cmake package
    name (e.g. kconfig = libkf5config = cmake/kf5config). To a user this
    paints a picture where this equality is always true so that if
    cmake complains about missing KF5Wayland they want to install
    libkf5wayland-dev to meet that requirement. This will however fail because
    of the general naming rule we employ (i.e. single lib => libname-dev;
    multilib => sourcename-dev) as kwayland produces two libraries its dev
    package is called kwayland-dev rather than libkf5wayland-dev. This is
    not obvious to users and causes to them unreasonable inconsistency.
    Additionally it increases the entry barrier to packaging as a whole as
    one needs to be aware of the -dev naming rule or else multilib sources
    will seem equally out of line with the rest of frameworks. To that extend
    even knowing this a packager would have to remember the frameworks that
    are multilib or have to look up the correct names each time when writing
    a new control file or expanding it with new build depends.
    To increase overall consistency all frameworks are now to reflect their
    cmake package name in the -dev package name. This is because cmake is
    expected to be the primary method of consumption for frameworks and even
    when using qmake the metadata is split per-library anyway, so they have
    no common naming consistency underlying them.
    
    This change updates the -dev name to align with expectation and introduces
    a transitional dummy package to help with the transition.
---
 debian/changelog                                             |  8 ++++++++
 debian/control                                               | 10 ++++++++++
 debian/{kdoctools-dev.install => libkf5doctools-dev.install} |  0
 3 files changed, 18 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index b870a34..69b9e83 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,11 @@
+kdoctools (5.23.0-2) UNRELEASED; urgency=medium
+
+  * Rename -dev package to align with the cmake package name for
+    greater discoverability and consistency across frameworks.
+    Add a transitional package to help with the name transition.
+
+ -- Harald Sitter <sitter at kde.org>  Tue, 14 Jun 2016 12:53:52 +0200
+
 kdoctools (5.23.0-1) unstable; urgency=medium
 
   [ Automatic packaging ]
diff --git a/debian/control b/debian/control
index c1611ec..83e47dc 100644
--- a/debian/control
+++ b/debian/control
@@ -22,12 +22,22 @@ Vcs-Browser: https://anonscm.debian.org/git/pkg-kde/frameworks/kdoctools.git
 Vcs-Git: https://anonscm.debian.org/git/pkg-kde/frameworks/kdoctools.git
 
 Package: kdoctools-dev
+Depends: libkf5doctools-dev, ${misc:Depends}
+Architecture: all
+Priority: extra
+Section: oldlibs
+Description: transitional dummy package
+ This is a transitional dummy package. It can safely be removed.
+
+Package: libkf5doctools-dev
 Section: libdevel
 Architecture: any
 Depends: kdoctools5 (= ${binary:Version}),
          libkf5archive-dev (>= 5.23.0~),
          qtbase5-dev (>= 5.4.0~),
          ${misc:Depends}
+Breaks: kdoctools-dev (<< 5.23.0-2~)
+Replaces: kdoctools-dev (<< 5.23.0-2~)
 Description: Development files for kdoctools5
  KDocTools is a set of tools to generate documentation in various formats from
  DocBook files.
diff --git a/debian/kdoctools-dev.install b/debian/libkf5doctools-dev.install
similarity index 100%
rename from debian/kdoctools-dev.install
rename to debian/libkf5doctools-dev.install

-- 
kdoctools packaging