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 5425cfccab9862fdfa073ce86fc960514a6338bb..06349a5be84e4abf58abe1d79fe84c579d7d0d50 100644 (file)
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -34,6 +34,98 @@ picking your way through this list.
 
 <chapt> The checklist
 
+<sect> Version 3.8.5.0
+<p>
+
+Release Jun 2010.
+
+</p><p><taglist>
+<tag>4.4, 5.6.15</tag>
+  <item>The required format for the date in a changelog entry and in the
+  Date control field is now precisely specified.
+  </item>
+<tag>5.1</tag>
+  <item>A control paragraph must not contain more than one instance of a
+  particular field name.
+  </item>
+<tag>5.4, 5.5, 5.6.24</tag>
+  <item>Document and recommend the <tt>Checksums-Sha1</tt>
+  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>
+  Architecture fields, and in architecture restrictions in build
+  relationships.
+  </item>
+<tag>6.3</tag>
+  <item>Maintainer scripts are no longer guaranteed to run with a
+  controlling terminal and must be able to fall back to noninteractive
+  behavior (debconf handles this).  Maintainer scripts may abort if there
+  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>
+  package is installed.  This allows the <tt>-dev</tt> package to be split
+  as long as it depends on the additional packages.
+  </item>
+<tag>9.2.2</tag>
+  <item>The UID range of user accounts is extended to 1000-59999.
+  </item>
+<tag>9.3.2, 10.4</tag>
+  <item><file>init.d</file> scripts are a possible exception from the
+  normal requirement to use <tt>set -e</tt> in each shell script.
+  </item>
+<tag>12.5</tag>
+  <item>The UCB BSD license was removed from the list of licenses that
+  should be referenced from <file>/usr/share/common-licenses/BSD</file>.
+  It should instead be included directly
+  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
+  package based solely on the Perl version.  Perl packages must now depend
+  on <package>perlapi-$Config{debian_abi}</package>, falling back
+  on <tt>$Config{version}</tt> if <tt>$Config{debian_abi}</tt> is not set.
+  </item>
+<tag>perl</tag>
+  <item>Packages using <file>Makefile.PL</file> should use
+  <tt>DESTDIR</tt> rather than <tt>PREFIX</tt> to install into the package
+  staging area.  <tt>PREFIX</tt> only worked due to a Debian-local patch.
+  </item>
+</taglist></p>
+
 <sect> Version 3.8.4.0
 <p>