Changelog and upgrading-checklist for #504880

diff --git a/debian/changelog b/debian/changelog
index 43b714cd28f30968b1f5c907ecedca7c88ad0c45..d8f3535fe7ad7979ea9e744196ecc034ed56a5c2 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -20,6 +20,11 @@ debian-policy (3.9.2.0) UNRELEASED; urgency=low
     Seconded: Aurelien Jarno <aurelien@aurel32.net>
     Seconded: Raphael Hertzog <hertzog@debian.org>
     Closes: #619186
+  * Policy: Significant additions to maintainer script documentation
+    Wording: Russ Allbery <rra@debian.org>
+    Seconded: Steve Langasek <vorlon@debian.org>
+    Seconded: Raphaël Hertzog <hertzog@debian.org>
+    Closes: #504880
   * Virtual: Added mailx as a new virtual package
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Raphaël Hertzog <hertzog@debian.org>

diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index 2138b5ccec240182956e357fbe1ca9407fa47abb..e603852d4e1972490cd6dc901b27a6e0ae58cca0 100644 (file)
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -40,6 +40,11 @@ picking your way through this list.
 Unreleased.
 
 </p><p><taglist>
+<tag>*</tag>
+  <item>Multiple clarifications throughout Policy where "installed" was
+  used and the more precise terms "unpacked" or "configured" were
+  intended.
+  </item>
 <tag>3.3</tag>
   <item>Clarify the duties of a maintainer, require that the maintainer
   address accept mail from Debian role accounts and the BTS, and require
@@ -49,6 +54,25 @@ Unreleased.
 <tag>5.6.25</tag>
   <item>Document the <tt>DM-Upload-Allowed</tt> field.
   </item>
+<tag>6.5</tag>
+  <item>Document the system state maintainer scripts can rely upon during
+  each possible invocation.  In several less-common cases, this is
+  stricter than Policy had previously documented.  Packages with complex
+  maintainer scripts should be reviewed in light of this new
+  documentation.
+  </item>
+<tag>7.2</tag>
+  <item>Better document the impact on system state when maintainer scripts
+  that are part of a circular dependency are run.  Circular dependencies
+  are now a should not.
+  </item>
+<tag>7.2</tag>
+  <item>Document the system state when <prgn>postinst</prgn>
+  and <prgn>prerm</prgn> scripts are run, and better document the special
+  case of dependency state for <prgn>postrm</prgn>
+  scripts.  <prgn>postrm</prgn> scripts are required to gracefully skip
+  actions if their dependencies are not available.
+  </item>
 <tag>9.1.1</tag>
   <item>GNU/Hurd systems are allowed <file>/hurd</file>
   and <file>/servers</file> directories in the root filesystem.