Add changelog and upgrading-checklist for #571776

[debian/debian-policy.git] / upgrading-checklist.sgml

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>