Changelog and upgrading-checklist for #509933

diff --git a/debian/changelog b/debian/changelog
index 1d972b24078fdf9e10fcf921c5ea3bd771365175..383b6076f0d57ed9b9e846c4657ca7c58abc29c2 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -58,6 +58,11 @@ debian-policy (3.9.1.0) UNRELEASED; urgency=low
     Seconded: Jakub Wilk <jwilk@debian.org>
     Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
     Closes: #184064
+  * Policy: More explicit requirements around library SONAMEs
+    Wording: Russ Allbery <rra@debian.org>
+    Seconded: Raphaël Hertzog <hertzog@debian.org>
+    Seconded: Emilio Pozuelo Monfort <pochu27@gmail.com>
+    Closes: #509933
   * Set the version of the Perl Policy to match the version of the Policy
     package.
   * Explain the Perl module package naming policy more explicitly and

diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index 0bcb07548f15d0191571b606c2a1abc72395457e..3dc378c102aef1bd31259dd41476a9675f8877a7 100644 (file)
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -60,6 +60,12 @@ Not yet released.
   there are file conflicts or one package breaks the other, not just
   because two packages provide similar functionality but don't interfere.
   </item>
+<tag>8.1</tag>
+  <item>The SONAME of a library should change whenever the ABI of the
+  library changes in a way that isn't backward-compatible.  It should not
+  change if the library ABI changes are backward-compatible.  Discourage
+  bundling shared libraries together in one package.
+  </item>
 <tag>8.6.1, 8.6.2, 8.6.5</tag>
   <item>Packages should normally not include a <file>shlibs.local</file>
   file since we now have complete <file>shlibs</file> coverage.