X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=upgrading-checklist.sgml;h=e69607733ac978fd805ada3cb0deae562ed28234;hb=776b3c76f338fbf07bde61ac1bcfd7efbbfe9069;hp=fabc1cbab3eb84f2d068fe3e9335283da5ef681e;hpb=96b4b014f126df57d6599ab9b0e5db4495f28bd0;p=debian%2Fdebian-policy.git

diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index fabc1cb..e696077 100644
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -34,12 +34,122 @@ picking your way through this list.
 
 <chapt> The checklist
 
+<sect> Version 3.9.2.0
+<p>
+
+Unreleased.
+
+</p><p><taglist>
+<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
+  at least one human with their personal email address
+  in <tt>Uploaders</tt> if the maintainer is a shared email address.
+  </item>
+<tag>5.6.25</tag>
+  <item>Document the <tt>DM-Upload-Allowed</tt> field.
+  </item>
+<tag>9.1.1</tag>
+  <item>GNU/Hurd systems are allowed <file>/hurd</file>
+  and <file>/servers</file> directories in the root filesystem.
+  </item>
+<tag>virtual</tag>
+  <item><tt>mailx</tt> added as a virtual package provided by packages
+  that install <prgn>/usr/bin/mailx</prgn> and implement at least the
+  POSIX-required interface.
+  </item>
+</taglist></p>
+
 <sect> Version 3.9.1.0
 <p>
 
-Not yet released.
+Released July, 2010.
 
 </p><p><taglist>
+<tag>3.2.1</tag>
+  <item>Date-based version components should be given as the four-digit
+  year, two-digit month, and then two-digit day, but may have embedded
+  punctuation.
+  </item>
+<tag>3.9</tag>
+  <item>Maintainer scripts must pass <tt>--package</tt>
+  to <prgn>dpkg-divert</prgn> when creating or removing diversions and
+  must not use <tt>--local</tt>.
+  </item>
+<tag>4.10</tag>
+  <item>Only <prgn>dpkg-gencontrol</prgn> supports variable substitution.
+  <prgn>dpkg-genchanges</prgn> (for <file>*.changes</file>)
+  and <prgn>dpkg-source</prgn> (for <file>*.dsc</file>) do not.
+  </item>
+<tag>7.1</tag>
+  <item>Architecture restrictions and wildcards are also allowed in binary
+  package relationships provided that the binary package is not
+  architecture-independent.
+  </item>
+<tag>7.4</tag>
+  <item><tt>Conflicts</tt> and <tt>Breaks</tt> should only be used when
+  there are file conflicts or one package breaks the other, not just
+  because two packages provide similar functionality but don't interfere.
+  </item>
+<tag>8.1</tag>
+  <item>The SONAME of a library should change whenever the ABI of the
+  library changes in a way that isn't backward-compatible.  It should not
+  change if the library ABI changes are backward-compatible.  Discourage
+  bundling shared libraries together in one package.
+  </item>
+<tag>8.4</tag>
+  <item>Ada Library Information (<file>*.ali</file>) files must be
+  installed read-only.
+  </item>
+<tag>8.6.1, 8.6.2, 8.6.5</tag>
+  <item>Packages should normally not include a <file>shlibs.local</file>
+  file since we now have complete <file>shlibs</file> coverage.
+  </item>
+<tag>8.6.3</tag>
+  <item>The SONAME of a library may instead be of the
+  form <tt><var>name</var>-<var>major-version</var>.so</tt>.
+  </item>
+<tag>10.2</tag>
+  <item>Libtool <file>.la</file> files should not be installed for public
+  libraries.  If they're required (for <tt>libltdl</tt>, for instance),
+  the <tt>dependency_libs</tt> setting should be emptied.  Library
+  packages historically including <file>.la</file> files must continue to
+  include them (with <tt>dependency_libs</tt> emptied) until all libraries
+  that depend on that library have removed or emptied
+  their <file>.la</file> files.
+  </item>
+<tag>10.2</tag>
+  <item>Libraries no longer need to be built with <tt>-D_REENTRANT</tt>,
+  which was an obsolete LinuxThreads requirement.  Instead, say explicitly
+  that libraries should be built with threading support and to be
+  thread-safe if the library supports this.
+  </item>
+<tag>10.4</tag>
+  <item><file>/bin/sh</file> scripts may assume that <prgn>kill</prgn>
+  supports an argument of <tt>-<var>signal</var></tt>,
+  that <prgn>kill</prgn> and <prgn>trap</prgn> support the numeric signals
+  listed in the XSI extension, and that signal 13 (SIGPIPE) can be trapped
+  with <prgn>trap</prgn>.
+  </item>
+<tag>10.8</tag>
+  <item>Recommend <file>/etc/logrotate.d/<var>package</var></file> for
+  logrotate rules.
+  </item>
+<tag>10.9</tag>
+  <item>Control information files should be owned by <tt>root:root</tt>
+  and either mode 644 or mode 755.
+  </item>
+<tag>11.4, 11.8.3, 11.8.4</tag>
+  <item>Packages providing alternatives for <prgn>editor</prgn>,
+  <prgn>pager</prgn>, <prgn>x-terminal-emulator</prgn>, or
+  <prgn>x-window-manager</prgn> should also provide a slave alternative
+  for the corresponding manual page.
+  </item>
+<tag>11.5</tag>
+  <item>Cgi-bin executable files may be installed in subdirectories
+  of <file>/usr/lib/cgi-bin</file> and web servers should serve out
+  executables in those subdirectories.
+  </item>
 <tag>12.5</tag>
   <item>The GPL version 1 is now included in common-licenses and should be
   referenced from there instead of included in the <file>copyright</file>