debian: Wrap and document dependency relationships

debian/changelog

@@ -3,6 +3,7 @@ dpkg (1.18.11) UNRELEASED; urgency=medium
   [ Guillem Jover ]
   * Packaging:
     - Add liblocale-gettext-perl to libdpkg-perl Recommends.
+    - Wrap and document dependency relationships.
   * Documentation:
     - Update custom changelog parser API support status in README.api.
     - Fix typos in docs and man pages. Thanks to Jakub Wilk <jwilk@debian.org>

debian/control

@@ -9,22 +9,33 @@ Homepage: https://wiki.debian.org/Teams/Dpkg
 Vcs-Browser: https://anonscm.debian.org/cgit/dpkg/dpkg.git
 Vcs-Git: https://anonscm.debian.org/git/dpkg/dpkg.git
 Standards-Version: 3.9.8
-Build-Depends: dpkg-dev (>= 1.17.14), debhelper (>= 9.20141010),
+Build-Depends:
+# Needed for build profile usage below.
+ dpkg-dev (>= 1.17.14),
+ debhelper (>= 9.20141010),
  pkg-config,
+# Needed for --add-location.
  gettext (>= 0.19),
 # Needed for --porefs.
  po4a (>= 0.43),
- zlib1g-dev, libbz2-dev, liblzma-dev,
+ zlib1g-dev,
+ libbz2-dev,
+ liblzma-dev,
+# Needed for proper pkg-config file.
  libselinux1-dev (>= 1.28-4) [linux-any],
  libncursesw5-dev,
- libio-string-perl <!nocheck>
+ libio-string-perl <!nocheck>,
 
 Package: libdpkg-dev
 Section: libdevel
 Priority: optional
 Architecture: any
 Multi-Arch: same
-Depends: zlib1g-dev, liblzma-dev, libbz2-dev, ${misc:Depends}
+Depends:
+ ${misc:Depends},
+ zlib1g-dev,
+ liblzma-dev,
+ libbz2-dev,
 Description: Debian package management static library
  This package provides the header files and static library necessary to
  develop software using libdpkg, the same library used internally by dpkg.
@@ -36,11 +47,19 @@ Package: dpkg
 Architecture: any
 Multi-Arch: foreign
 Essential: yes
-Pre-Depends: ${shlibs:Depends}, tar (>= 1.23)
-Depends: ${misc:Depends}, tar (>= 1.28-1)
+Pre-Depends:
+ ${shlibs:Depends},
+# Needed for --warning=no-timestamp in dpkg-deb -x.
+ tar (>= 1.23),
+Depends:
+ ${misc:Depends},
+# Needed for --clamp-mtime in dpkg-deb -b.
+ tar (>= 1.28-1),
+Suggests:
+ apt,
 Breaks: dpkg-dev (<< 1.15.8), libdpkg-perl (<< 1.15.8)
-Suggests: apt
-Replaces: manpages-it (<< 2.80-4)
+Replaces:
+ manpages-it (<< 2.80-4),
 Description: Debian package management system
  This package provides the low-level infrastructure for handling the
  installation and removal of Debian software packages.
@@ -53,17 +72,34 @@ Priority: optional
 Architecture: all
 Multi-Arch: foreign
 Depends:
+ ${misc:Depends},
  libdpkg-perl (= ${source:Version}),
 # Needed for --clamp-mtime.
  tar (>= 1.28-1),
  bzip2,
  xz-utils,
- patch (>= 2.7), make, binutils, base-files (>= 5.0.0), ${misc:Depends}
-Recommends: gcc | c-compiler, build-essential, fakeroot,
- gnupg | gnupg2, gpgv | gpgv2, libalgorithm-merge-perl
-Suggests: debian-keyring
-Breaks: dpkg-cross (<< 2.0.0), devscripts (<< 2.14.10)
-Replaces: manpages-it (<< 2.80-4)
+# Needed for git-style diff support.
+ patch (>= 2.7),
+ make,
+ binutils,
+# Needed for /etc/dpkg/origins/default.
+ base-files (>= 5.0.0),
+Recommends:
+ build-essential,
+ gcc | c-compiler,
+ fakeroot,
+ gnupg | gnupg2,
+ gpgv | gpgv2,
+# Used by dpkg-mergechangelogs.
+ libalgorithm-merge-perl,
+Suggests:
+ debian-keyring,
+Breaks:
+ dpkg-cross (<< 2.0.0),
+# Due to new dpkg-architecture 1.17.17 strictness.
+ devscripts (<< 2.14.10),
+Replaces:
+ manpages-it (<< 2.80-4),
 Description: Debian package development tools
  This package provides the development tools (including dpkg-source)
  required to unpack, build and upload Debian source packages.
@@ -76,15 +112,29 @@ Section: perl
 Priority: optional
 Architecture: all
 Multi-Arch: foreign
-Depends: dpkg (>= 1.16.3), perl, ${misc:Depends}
+Depends:
+ ${misc:Depends},
+# Needed for abitable.
+ dpkg (>= 1.16.3),
+ perl,
 Recommends:
+# Used by Dpkg::File.
  libfile-fcntllock-perl,
+# Used by Dpkg::Gettext.
  liblocale-gettext-perl,
  bzip2,
  xz-utils,
-Suggests: debian-keyring, gnupg | gnupg2, gpgv | gpgv2,
- gcc | c-compiler, binutils, patch
-Breaks: dpkg-dev (<< 1.15.6), patch (<< 2.7)
+Suggests:
+ debian-keyring,
+ gnupg | gnupg2,
+ gpgv | gpgv2,
+ gcc | c-compiler,
+ binutils,
+ patch,
+Breaks:
+ dpkg-dev (<< 1.15.6),
+# Needed for git-style diffs.
+ patch (<< 2.7),
 Replaces: dpkg (<< 1.15.8), dpkg-dev (<< 1.15.6)
 Description: Dpkg perl modules
  This package provides the perl modules used by the scripts
@@ -130,10 +180,17 @@ Package: dselect
 Priority: optional
 Architecture: any
 Multi-Arch: foreign
-Depends: ${shlibs:Depends}, dpkg (>= 1.13.1), ${misc:Depends}
-Suggests: perl
+Depends:
+ ${shlibs:Depends},
+ ${misc:Depends},
+ dpkg (>= 1.13.1),
+Suggests:
+ perl,
 Conflicts: dpkg-ftp, dpkg-multicd
-Replaces: dpkg-ftp, dpkg-multicd, manpages-it (<< 2.80-4)
+Replaces:
+ dpkg-ftp,
+ dpkg-multicd,
+ manpages-it (<< 2.80-4),
 Description: Debian package management front-end
  dselect is a high-level interface for managing the installation and
  removal of Debian software packages.