[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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: