]> git.donarmstrong.com Git - debian/debian-policy.git/blobdiff - upgrading-checklist.sgml
Document that empty field values are only allowed in debian/control.
[debian/debian-policy.git] / upgrading-checklist.sgml
index 88c1950e883dab0838c8637a38f0652793d3a474..7e490e643b38d882a88241fb4a469a7beaaa2014 100644 (file)
@@ -6,7 +6,7 @@
       <author> Bill Allombert <email/ballombe@debian.org/ </author>
       <author> Josip Rodin </author>
       <author> Julian Gilbey </author>
       <author> Bill Allombert <email/ballombe@debian.org/ </author>
       <author> Josip Rodin </author>
       <author> Julian Gilbey </author>
-      <author> Russ Allbery </author>
+      <author> Russ Allbery <email/rra@debian.org/ </author>
       <author> Manoj Srivastava <email/srivasta@debian.org/
 
 <chapt> About the checklist
       <author> Manoj Srivastava <email/srivasta@debian.org/
 
 <chapt> About the checklist
@@ -34,10 +34,189 @@ picking your way through this list.
 
 <chapt> The checklist
 
 
 <chapt> The checklist
 
+<sect id="3.9.7.0"> Version 3.9.7.0
+<p>
+
+Released xxx, 2015.
+
+</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.
+<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> </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>
+
+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
+<p>
+
+Released August, 2012.
+
+</p><p><taglist>
+<tag>2.4</tag>
+  <item>New <em>tasks</em> archive section.
+  </item>
+<tag>4.9</tag>
+  <item><tt>build-arch</tt> and <tt>build-indep</tt> are now mandatory
+  targets in <file>debian/rules</file>.
+  </item>
+<tag>5.6.26</tag>
+  <item>New section documenting the <tt>Vcs-*</tt> fields, which are
+  already in widespread use.  Note the mechanism for specifying the Git
+  branch used for packaging in the Vcs-Git field.
+  </item>
+<tag>7.1</tag>
+  <item>The deprecated relations &lt; and &gt; now must not be used.
+  </item>
+<tag>7.8</tag>
+  <item>New <tt>Built-Using</tt> field, which must be used to document the
+  source packages for any binaries that are incorporated into this package
+  at build time.  This is used to ensure that the archive meets license
+  requirements for providing source for all binaries.
+  </item>
+<tag>8.6</tag>
+  <item>Policy for dependencies between shared libraries and other
+  packages has been largely rewritten to document the <tt>symbols</tt>
+  system and more clearly document handling of shared library ABI
+  changes.  <file>symbols</file> files are now recommended
+  over <file>shlibs</file> files in most situations.  All maintainers of
+  shared library packages should review the entirety of this section.
+  </item>
+<tag>9.1.1</tag>
+  <item>Packages must not assume the <file>/run</file> directory exists or
+  is usable without a dependency on <tt>initscripts (>= 2.88dsf-13.3)</tt>
+  until the stable release of Debian supports <file>/run</file>.
+  </item>
+<tag>9.7</tag>
+  <item>Packages including MIME configuration can now rely on triggers and
+  do not need to call update-mime.</item>
+<tag>9.11</tag>
+  <item>New section documenting general requirements for alternate init
+  systems and specific requirements for integrating with upstart.
+  </item>
+<tag>12.5</tag>
+  <item>All copyright files must be encoded in UTF-8.
+  </item>
+</taglist></p>
+
 <sect id="3.9.3.0"> Version 3.9.3.0
 <p>
 
 <sect id="3.9.3.0"> Version 3.9.3.0
 <p>
 
-Unreleased.
+Released February, 2012.
 
 </p><p><taglist>
 <tag>2.4</tag>
 
 </p><p><taglist>
 <tag>2.4</tag>
@@ -49,6 +228,10 @@ Unreleased.
   now contain the value <tt>any all</tt> for source packages building both
   architecture-independent and architecture-dependent packages.
   </item>
   now contain the value <tt>any all</tt> for source packages building both
   architecture-independent and architecture-dependent packages.
   </item>
+<tag>7.1</tag>
+  <item>If a dependency is restricted to particular architectures, the
+  list of architectures must be non-empty.
+  </item>
 <tag>9.1.1</tag>
   <item><file>/run</file> is allowed as an exception to the FHS and
   replaces <file>/var/run</file>.  <file>/run/lock</file>
 <tag>9.1.1</tag>
   <item><file>/run</file> is allowed as an exception to the FHS and
   replaces <file>/var/run</file>.  <file>/run/lock</file>
@@ -69,7 +252,7 @@ Unreleased.
   they will be ignored by cron.  They should replace those characters
   with <tt>_</tt>.  If a package provides multiple cron job files in the
   same directory, they should each start with the package name (possibly
   they will be ignored by cron.  They should replace those characters
   with <tt>_</tt>.  If a package provides multiple cron job files in the
   same directory, they should each start with the package name (possibly
-  modified as above), <tt>-</tt>, and then some suitable prefix.
+  modified as above), <tt>-</tt>, and then some suitable suffix.
   </item>
 <tag>9.10</tag>
   <item>Packages using doc-base do not need to call install-docs anymore.
   </item>
 <tag>9.10</tag>
   <item>Packages using doc-base do not need to call install-docs anymore.
@@ -88,9 +271,14 @@ Unreleased.
   Debian maintainers involved in the creation of the package (although
   note that the requirement to list copyright information is unchanged).
   </item>
   Debian maintainers involved in the creation of the package (although
   note that the requirement to list copyright information is unchanged).
   </item>
+<tag>copyright-format</tag>
+  <item>Version 1.0 of the "Machine-readable <file>debian/copyright</file>
+  file" specification is included.
+  </item>
 <tag>mime</tag>
 <tag>mime</tag>
-  <item>Retire this separate document and merge its (short) contents into
-  Policy section 9.7.  There are no changes to the requirements.
+  <item>This separate document has been retired and and its (short)
+  contents merged into Policy section 9.7.  There are no changes to the
+  requirements.
   </item>
 <tag>perl</tag>
   <item>Packages may declare an interest in the <var>perl-major-upgrade</var> 
   </item>
 <tag>perl</tag>
   <item>Packages may declare an interest in the <var>perl-major-upgrade</var> 
@@ -1006,7 +1194,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;
 <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
 </item>
 <tag>11.9; perl-policy</tag>
 <item>The perl policy is now part of Debian policy
@@ -1107,7 +1294,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
 <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
 </item>
 <tag>12.8</tag>
 <item>Policy for packages where the upstream uses HTML changelog