Add changelog and upgrading-checklist for #571776

diff --git a/debian/changelog b/debian/changelog
index d11c1fd9a6e476a333d0b49a19abf320e2c6e3e8..1592f94d0fa6967b1569e9ea793e3baf2049f755 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -30,6 +30,12 @@ debian-policy (3.9.4.0) UNRELEASED; urgency=low
     Seconded: Charles Plessy <plessy@debian.org>
     Seconded: Russ Allbery <rra@debian.org>
     Closes: #676561
+  * Policy: Rewrite shared library dependency policy to document symbols
+    Wording: Russ Allbery <rra@debian.org>
+    Wording: Jonathan Nieder <jrnieder@gmail.com>
+    Seconded: Raphaël Hertzog <hertzog@debian.org>
+    Seconded: Julien Cristau <jcristau@debian.org>
+    Closes: #571776
 
  -- Russ Allbery <rra@debian.org>  Sat, 17 Mar 2012 16:30:33 -0700
 

diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index 233e8c2495de839fcd6d138036b913c07fbea6ca..2c0912c841ea3a221fa333c1eabad7263cb8a2cd 100644 (file)
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -57,6 +57,14 @@ Unreleased.
   at build time.  This is used to ensure that the archive meets license
   requirements for providing source for all binaries.
   </item>
+<tag>8.6</tag>
+  <item>Policy for dependencies between shared libraries and other
+  packages has been largely rewritten to document the <tt>symbols</tt>
+  system and more clearly document handling of shared library ABI
+  changes.  <file>symbols</file> files are now recommended
+  over <file>shlibs</file> files in most situations.  All maintainers of
+  shared library packages should review the entirety of this section.
+  </item>
 <tag>9.1.1</tag>
   <item>Packages must not assume the <file>/run</file> directory exists or
   is usable without a dependency on <tt>initscripts (>= 2.88dsf-13.3)</tt>