]> git.donarmstrong.com Git - debian/debian-policy.git/blobdiff - upgrading-checklist.sgml
debian-policy (3.9.5.0) unstable; urgency=low
[debian/debian-policy.git] / upgrading-checklist.sgml
index b62e5e0ecb03ea9312fdff8f7dc163123fd43ac9..19ddd19487b5ada565b57d026a40e4ff88e0af29 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,122 @@ picking your way through this list.
 
 <chapt> The checklist
 
 
 <chapt> The checklist
 
+<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>
@@ -73,7 +185,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.
@@ -92,9 +204,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>