Policy: on upgrades, recommend removing obsolete unchanged conf. files.

Wording: Paul Wise <pabs@debian.org>
Seconded: Jonathan Nieder <jrnieder@gmail.com>
Seconded: Charles Plessy <plessy@debian.org>
Closes: #707077

diff --git a/debian/changelog b/debian/changelog
index 103f90a191a2b50a02db9089cb3db36c504ecb28..0ef998e9b1dfbf989ad8adc9a1c6b3a4be0537ee 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -49,6 +49,11 @@ debian-policy (3.9.5.0) UNRELEASED; urgency=low
     Seconded: Steve Langasek <vorlon@debian.org>
     Seconded: Julien Cristau <jcristau@debian.org>
     Closes: #707183
+  * Policy: on upgrades, recommend removing obsolete unchanged conf. files.
+    Wording: Paul Wise <pabs@debian.org>
+    Seconded: Jonathan Nieder <jrnieder@gmail.com>
+    Seconded: Charles Plessy <plessy@debian.org>
+    Closes: #707077
   * debconf_spec: Document the 'escape' capability.
     Wording: Jonathan Nieder <jrnieder@gmail.com>
     Seconded: Charles Plessy <plessy@debian.org>

diff --git a/policy.sgml b/policy.sgml
index 113429b0f7f5ea1e261524d27e8cfd19ff742acf..138d320cd266b2dcab9ab3c99c17ef3e014bfdf2 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -9009,8 +9009,10 @@ ln -fs ../sbin/sendmail debian/tmp/usr/bin/runq
                  package is purged.
              </item>
            </list>
-           Obsolete configuration files without local changes may be
-           removed by the package during upgrade.
+           Obsolete configuration files without local changes should be
+           removed by the package during upgrade.<footnote>
+             The <prgn>dpkg-maintscript-helper</prgn> tool, available from the
+             <package>dpkg</package> package, can help for this task.</footnote>
          </p>
 
          <p>

diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index a77413db604e2114b7c248217465b97410cb8fdf..a167bcb12fd8b875ef86be0d67dd0adfc24dd445 100644 (file)
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -62,6 +62,12 @@ Unreleased.
 <tag>9.1.1.8</tag>
   <item>The exception to the FHS for the <file>/selinux</file> was removed.
   </item>
+<tag>10.7.3</tag>
+  <item>Packages should remove all obsolete configuration files without
+  local changes during upgrades.  The <prgn>dpkg-maintscript-helper</prgn>
+  tool, available from the <package>dpkg</package> package since
+  <em>Wheezy</em>, can help with this.
+  </item>
 <tag>10.10</tag>
   <item>The name of the files and directories installed by binary packages
   must be encoded in UTF-8 and should be restricted to ASCII when possible.