Bug#683222: debian-policy: Policy section 4.4 is imprecise with respect to section 12.7
Package: debian-policy
Severity: normal
Policy section 4.4 states (emphasize mine):
Changes in the Debian version of the package _should_ be briefly explained in the
Debian changelog file debian/changelog.[15] [..]
This implies, use of debian/changelog is optional with respect to the normative
meaning of "should" in the policy manual. However, reading section 12.7 this is not
true:
Packages that are not Debian-native must contain a compressed copy of the
debian/changelog file from the Debian source tree in /usr/share/doc/package with
the name changelog.Debian.gz.
I realize, section 4.4 refers to the source package, whereas 12.7 refers to binary
packages. Having that said, that's hardly a difference for most packages anyway
and even section 12.7 refers to the source package as origin for that file ("must
contain a compressed copy of the debian/changelog file from the Debian source
tree").
Please add a sentence for clarification to section 4.4, or replace the "should" in
4.4 by "must" for consistency.
-- System Information:
Debian Release: wheezy/sid
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)
Kernel: Linux 3.3.0-trunk-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Reply to: