Clarification of the Format field in control files -- patch for #547272.

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

diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index 394d9c69ff0f822fc69caa729e51e60b193608bf..06349a5be84e4abf58abe1d79fe84c579d7d0d50 100644 (file)
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -53,6 +53,14 @@ Release Jun 2010.
   and <tt>Checksums-Sha256</tt> fields in <file>*.dsc</file>
   and <file>*.changes</file> files.
   </item>
+<tag>5.6.2</tag>
+  <item>The syntax of the <tt>Maintainer</tt> field is now must rather
+  than should.
+  </item>
+<tag>5.6.3</tag>
+  <item>The comma separating entries in <tt>Uploaders</tt> is now must
+  rather than should.
+  </item>
 <tag>5.6.8, 7.1, 11.1.1</tag>
   <item>Architecture wildcards may be used in addition to specific
   architectures in <file>debian/control</file> and <file>*.dsc</file>
@@ -66,6 +74,19 @@ Release Jun 2010.
   is no controlling terminal and no reasonable default for a high-priority
   question, but should avoid this if possible.
   </item>
+<tag>7.3, 7.6.1</tag>
+  <item><tt>Breaks</tt> should be used with <tt>Replaces</tt> for moving
+  files between packages.
+  </item>
+<tag>7.4</tag>
+  <item><tt>Breaks</tt> should normally be used instead
+  of <tt>Conflicts</tt> for transient issues and moving files between
+  packages.  New documentation of when each should be used.
+  </item>
+<tag>7.5</tag>
+  <item>Use <tt>Conflicts</tt> with <tt>Provides</tt> if only one provider
+  of a virtual facility can ge installed at a time.
+  </item>
 <tag>8.4</tag>
   <item>All shared library development files are no longer required to be
   in the <tt>-dev</tt> package, only be available when the <tt>-dev</tt>
@@ -86,6 +107,11 @@ Release Jun 2010.
   in <file>debian/copyright</file>, although it will still be in
   common-licenses for the time being.
   </item>
+<tag>debconf</tag>
+  <item>Add <tt>SETTITLE</tt> (which has been supported for some time).
+  Like <tt>TITLE</tt> but takes a template instead of a string to allow
+  translation.
+  </item>
 <tag>perl</tag>
   <item><package>perl-base</package> now
   provides <package>perlapi-<var>abiname</var></package> instead of a