Add changelog and upgrading-checklist for #509932

diff --git a/debian/changelog b/debian/changelog
index 87729e3d63ce0f63ea52637b22773a7c9bf82d14..864d46b8aefede46514596426fe822bb8f254286 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -16,6 +16,16 @@ debian-policy (3.9.1.0) UNRELEASED; urgency=low
     Seconded: Raphaël Hertzog <hertzog@debian.org>
     Seconded: Raphael Geissert <geissert@debian.org>
     Closes: #218897
+  * Policy: Remove encouragement to create shlibs.local
+    Wording: Russ Allbery <rra@debian.org>
+    Seconded: Julien Cristau <jcristau@debian.org>
+    Seconded: Jakub Wilk <jwilk@debian.org>
+    Seconded: Cyril Brulebois <kibi@debian.org>
+  * Policy: Document alternate SONAME format with version before .so
+    Wording: Russ Allbery <rra@debian.org>
+    Seconded: Julien Cristau <jcristau@debian.org>
+    Seconded: Raphaël Hertzog <hertzog@debian.org>
+    Closes: #509932
   * 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 b8ed4dc5d545bec130fc127d0aecd38479cf007b..d4a32a419614078fafc3255f77a698d257254ed0 100644 (file)
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -45,6 +45,14 @@ Not yet released.
   to <prgn>dpkg-divert</prgn> when creating or removing diversions and
   must not use <tt>--local</tt>.
   </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.
+  </item>
+<tag>8.6.3</tag>
+  <item>The SONAME of a library may instead be of the
+  form <tt><var>name</var>-<var>major-version</var>.so</tt>.
+  </item>
 <tag>10.2</tag>
   <item>Libtool <file>.la</file> files should not be installed for public
   libraries.  If they're required (for <tt>libltdl</tt>, for instance),