]> git.donarmstrong.com Git - debian/debian-policy.git/blobdiff - upgrading-checklist.sgml
Release policy 3.9.7.0
[debian/debian-policy.git] / upgrading-checklist.sgml
index 90dace524de5dc49e7e22b8eefe7d9133495ae72..e4245cfc7f0efd4663a4402553ab4a734dd0ab43 100644 (file)
@@ -34,16 +34,141 @@ picking your way through this list.
 
 <chapt> The checklist
 
+<sect id="3.9.7.0"> Version 3.9.7.0
+<p>
+
+Released February, 2016.
+
+</p><p><taglist>
+<tag>10.5</tag>
+  <item> Symbolic links must not traverse above the root directory.
+  </item>
+<tag>9.2.2</tag>
+  <item> 32bit UIDs in the range 65536-4294967293 are reserved for dynamically
+  allocated user accounts.
+  </item>
+<tag>5.1</tag>
+  <item> Empty field values in control files are only permitted in the
+  <file>debian/control</file> file of a source package.
+  </item>
+<tag>4.9</tag>
+  <item> <file>debian/rules</file>: required targets must not attempt
+  network access.
+  </item>
+<tag>12.3</tag>
+  <item> recommend to ship additional documentation for package
+  <prgn>pkg</prgn> in a separate package <prgn>pkg-doc</prgn> and install it
+  into <file>/usr/share/doc/pkg</file>.
+  </item> </taglist></p>
+
+<sect id="3.9.6.0"> Version 3.9.6.0
+<p>
+
+Released September, 2014.
+
+</p><p><taglist>
+<tag>9.1</tag>
+  <item> The FHS is relaxed to allow a subdirectory of <file>/usr/lib</file>
+  to hold a mixture of architecture-independent and architecture-dependent
+  files, though directories entirely composed of architecture-independent files
+  should be located in <file>/usr/share</file>.
+  </item>
+<tag>9.1</tag>
+  <item>The FHS requirement for <file>/usr/local/lib64</file> to exist
+  if <file>/lib64</file> or <file>/usr/lib64</file> exists is removed.
+  </item>
+<tag>9.1</tag>
+  <item> An FHS exception has been granted for multiarch include files,
+  permitting header files to instead be installed to
+  <file>/usr/include/triplet</file>.
+  </item>
+<tag>10.1</tag>
+  <item> Binaries must not be statically linked with the GNU C library,
+  see policy for exceptions.
+  </item>
+<tag>4.4</tag>
+  <item> It is clarified that signature appearing in debian/changelog should be
+  the details of the person who prepared this release of the package.
+  </item>
+<tag>11.5</tag>
+  <item> The default web document root is now <file>/var/www/html</file>
+  </item>
+<tag>virtual</tag>
+  <item><tt>java1-runtime</tt> and <tt>java2-runtime</tt> are removed,
+  <tt>javaN-runtime</tt> and <tt>javaN-runtime-headless</tt> are added
+  for all N between 5 and 9.
+  </item>
+<tag>virtual</tag>
+  <item>Added <tt>httpd-wsgi</tt> for WSGI capable HTTP servers.
+  </item>
+<tag>perl</tag>
+  <item> Perl packages should use the <tt>%Config</tt> hash to locate module
+         paths instead of hardcoding paths in <tt>@INC</tt>.
+  </item>
+<tag>perl</tag>
+  <item> Perl binary modules and any modules installed into
+         <tt>$Config{vendorarch}</tt> must depend on the relevant
+         <package>perlapi-*</package> package.
+  </item> </taglist></p>
+
 <sect id="3.9.5.0"> Version 3.9.5.0
 <p>
 
-Unreleased.
+Released October, 2013.
 
 </p><p><taglist>
+<tag>5.1</tag>
+  <item>Control data fields must not start with the hyphen character
+  (<tt>-</tt>), to avoid potential confusions when parsing clearsigned control
+  data files that were not properly unescaped.
+  </item>
 <tag>5.4, 5.6.24</tag>
   <item><tt>Checksums-Sha1</tt> and <tt>Checksums-Sha256</tt> are now
   mandatory in <file>.dsc</file> files.
   </item>
+<tag>5.6.25, 5.8.1</tag>
+  <item>The <tt>DM-Upload-Allowed</tt> field is obsolete.  Permissions
+  are now granted via <em>dak-commands</em> files.
+<tag>5.6.27</tag>
+  <item>New section documenting the <tt>Package-List</tt> field in Debian
+  source control files.
+  </item>
+<tag>5.6.28</tag>
+  <item>New section documenting the <tt>Package-Type</tt> field in source
+  package control files.
+  </item>
+<tag>5.6.29</tag>
+  <item>New section documenting the <tt>Dgit</tt> field in Debian
+  source control files.
+  </item>
+<tag>9.1.1.8</tag>
+  <item>The exception to the FHS for the <file>/selinux</file> was removed.
+  </item>
+<tag>10.7.3</tag>
+  <item>Packages should remove all obsolete configuration files without
+  local changes during upgrades.  The <prgn>dpkg-maintscript-helper</prgn>
+  tool, available from the <package>dpkg</package> package since
+  <em>Wheezy</em>, can help with this.
+  </item>
+<tag>10.10</tag>
+  <item>The name of the files and directories installed by binary packages
+  must be encoded in UTF-8 and should be restricted to ASCII when possible.
+  In the system PATH, they must be restricted to ASCII.
+  </item>
+<tag>11.5.2</tag>
+  <item>Stop recommending to serve HTML documents from
+  <file>/usr/share/doc/<var>package</var></file>.
+  </item>
+<tag>12.2</tag>
+  <item>Packages distributing Info documents should use
+  <package>install-info</package>'s trigger, and do not need anymore
+  to depend on <tt>dpkg (>= 1.15.4) | install-info</tt>.
+  </item>
+<tag>debconf</tag>
+  <item>The <tt>escape</tt> capability is now documented.
+  </item>
+<tag>virtual</tag>
+  <item><tt>mp3-decoder</tt> and <tt>mp3-encoder</tt> are removed.</item>
 </taglist></p>
 
 <sect id="3.9.4.0"> Version 3.9.4.0
@@ -1079,7 +1204,6 @@ Released  May 2001.
 <item>The system-wide mail directory is now /var/mail, no longer
   /var/spool/mail.  Any packages accessing the mail spool should
   access it via /var/mail and include a suitable Depends field;
-  details in
 </item>
 <tag>11.9; perl-policy</tag>
 <item>The perl policy is now part of Debian policy
@@ -1180,7 +1304,7 @@ Released  May 2001.
 <tag>10.1</tag>
 <item>By default executables should not be built with the debugging
   option -g. Instead, it is recommended to support building the
-  package with debugging information optionally.  Details in
+  package with debugging information optionally.
 </item>
 <tag>12.8</tag>
 <item>Policy for packages where the upstream uses HTML changelog