X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=upgrading-checklist.sgml;h=dc62283d8dd7be32f60159de4729c70f5350a97e;hb=0808200988a182be172f20818a9274dab0d40a7f;hp=4e0ad915bc5dc940596024e86398dfe689a67066;hpb=4193abd826ca56cb68f6d130c948b3e8daf49578;p=debian%2Fdebian-policy.git diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml index 4e0ad91..dc62283 100644 --- a/upgrading-checklist.sgml +++ b/upgrading-checklist.sgml @@ -34,10 +34,133 @@ picking your way through this list. The checklist - Version 3.9.1.0 + Version 3.9.3.0

-Not yet released. +Unreleased. + +

+2.4 + New archive sections education, introspection, + and metapackages added. + +5.6.8 + The Architecture field in *.dsc files may + now contain the value any all for source packages building both + architecture-independent and architecture-dependent packages. + +9.5 + Cron job file names must not contain . or + or + they will be ignored by cron. They should replace those characters + with _. If a package provides multiple cron job files in the + same directory, they should each start with the package name (possibly + modified as above), -, and then some suitable prefix. + +9.10 + Packages using doc-base do not need to call install-docs anymore. + +10.7.4 + Packages that declare the same conffile may see left-over + configuration files from each other even if they conflict. + +11.8 + The Policy rules around Motif libraries were just a special case + of normal rules for non-free dependencies and were largely obsolete, so + they have been removed. + +12.5 + debian/copyright is no longer required to list the + Debian maintainers involved in the creation of the package (although + note that the requirement to list copyright information is unchanged). + +mime + Retire this separate document and merge its (short) contents into + Policy section 9.7. There are no changes to the requirements. + +perl + Packages may declare an interest in the perl-major-upgrade + trigger to be notified of major upgrades of perl. + +virtual + ttf-japanese-{mincho, gothic} is renamed to + fonts-japanese-{mincho, gothic}. + +

+ + Version 3.9.2.0 +

+ +Released April, 2011. + +

+* + Multiple clarifications throughout Policy where "installed" was + used and the more precise terms "unpacked" or "configured" were + intended. + +3.3 + The maintainer address must accept mail from Debian role accounts + and the BTS. At least one human must be listed with their personal + email address in Uploaders if the maintainer is a shared email + address. The duties of a maintainer are also clearer. + +5 + All control fields are now classified as simple, folded, or + multiline, which governs whether their values must be a single line or + may be continued across multiple lines and whether line breaks are + significant. + +5.1 + Parsers are allowed to accept paragraph separation lines + containing whitespace, but control files should use completely empty + lines. Ordering of paragraphs is significant. Field names must be + composed of printable ASCII characters except colon and must not begin + with #. + +5.6.25 + The DM-Upload-Allowed field is now documented. + +6.5 + The system state maintainer scripts can rely upon during each + possible invocation is now documented. In several less-common cases, + this is stricter than Policy had previously documented. Packages with + complex maintainer scripts should be reviewed in light of this new + documentation. + +7.2 + The impact on system state when maintainer scripts that are part + of a circular dependency are run is now documented. Circular + dependencies are now a should not. + +7.2 + The system state when postinst and prerm + scripts are run is now documented, and the documentation of the special + case of dependency state for postrm scripts has been + improved. postrm scripts are required to gracefully skip + actions if their dependencies are not available. + +9.1.1 + GNU/Hurd systems are allowed /hurd + and /servers directories in the root filesystem. + +9.1.1 + Packages installing to architecture-specific subdirectories of + /usr/lib must use the value returned by + dpkg-architecture -qDEB_HOST_MULTIARCH, not by + dpkg-architecture -qDEB_HOST_GNU_TYPE; this is a path change + on i386 architectures and a no-op for other architectures. + +virtual + mailx is now a virtual package provided by packages that + install /usr/bin/mailx and implement at least the + POSIX-required interface. + +

+ + Version 3.9.1.0 +

+ +Released July, 2010.

3.2.1 @@ -106,8 +229,8 @@ Not yet released. with trap. 10.8 - Recommend /etc/logrotate.d/package for - logrotate rules. + Use of /etc/logrotate.d/package for + logrotate rules is now recommended. 10.9 Control information files should be owned by root:root @@ -131,7 +254,7 @@ Not yet released.

- Version 3.9.0.0 + Version 3.9.0.0

Released June, 2010. @@ -146,9 +269,9 @@ Released June, 2010. particular field name. 5.4, 5.5, 5.6.24 - Document and recommend the Checksums-Sha1 - and Checksums-Sha256 fields in *.dsc - and *.changes files. + The Checksums-Sha1 and Checksums-Sha256 fields + in *.dsc and *.changes files are now + documented and recommended. 5.5, 5.6.16 The Format field of .changes files is now @@ -212,9 +335,9 @@ Released June, 2010. common-licenses for the time being. debconf - Add SETTITLE (which has been supported for some time). - Like TITLE but takes a template instead of a string to allow - translation. + SETTITLE is now documented (it has been supported for + some time). SETTITLE is like TITLE but takes a + template instead of a string to allow translation. perl perl-base now @@ -230,7 +353,7 @@ Released June, 2010.

- Version 3.8.4.0 + Version 3.8.4.0

Release Jan 2010. @@ -242,8 +365,8 @@ Release Jan 2010. /usr/lib/triplet directories. 10.6 - Explicitly state that packages may not contain named pipes and - should instead create them in postinst and remove them in prerm or postrm. + Packages may not contain named pipes and should instead create + them in postinst and remove them in prerm or postrm. 9.1.1 /sys and /selinux directories are explicitly @@ -251,14 +374,14 @@ Release Jan 2010.

- Version 3.8.3.0 + Version 3.8.3.0

Released Aug 2009.

4.9 - Add DEB_*_ARCH_CPU and DEB_*_ARCH_OS variables and - recommend them over GNU-style variables for that information. + DEB_*_ARCH_CPU and DEB_*_ARCH_OS variables are now documented and + recommended over GNU-style variables for that information. 5.6.8 Source package Architecture fields may contain The Binary field may span multiple lines. 10.2 - Remove the permission for shared library packages to - install libraries in a non-standard location and modify Shared library packages are no longer allowed to install libraries + in a non-standard location and modify 11.8.7 - Clarify installation directories for X programs and - remove the requirement to pre-depend on x11-common before installing - into /usr/include/X11 and /usr/lib/X11. + Installation directories for X programs have been clarified. + Packages are no longer required to pre-depend on x11-common before + installing into /usr/include/X11 + and /usr/lib/X11. 12.1 - Remove the requirement that all characters in a manual - page be representable in the legacy encoding for that language. + Manual pages are no longer required to contain only characters + representable in the legacy encoding for that language. 12.1 Localized man pages should either be kept up-to-date with @@ -306,7 +430,7 @@ Released Aug 2009.

- Version 3.8.2.0 + Version 3.8.2.0

Released Jun 2009. @@ -346,7 +470,7 @@ Released Jun 2009.

- Version 3.8.1.0 + Version 3.8.1.0

Released Mar 2009. @@ -361,12 +485,12 @@ Released Mar 2009. Changelog files must be encoded in UTF-8. 4.4 - Tighten some format requirements for changelog files from a should - to a must. + Some format requirements for changelog files are now "must" + instead of "should." 4.4.1 - Remove alternative changelog formats. Debian only supports one - changelog format for the Debian Archive. + Alternative changelog formats have been removed. Debian only + supports one changelog format for the Debian Archive. 4.9.1 New nocheck option for DEB_BUILD_OPTIONS indicating any build-time @@ -376,8 +500,8 @@ Released Mar 2009. All control files must be encoded in UTF-8. 5.2 - debian/control allows comment lines starting with # with no - preceding whitespace. + debian/control allows comment lines starting with # + with no preceding whitespace. 9.3 Init scripts ending in .sh are not handled specially. They are not @@ -404,7 +528,7 @@ Released Mar 2009.

- Version 3.8.0.0 + Version 3.8.0.0

Released Jun 2008. @@ -483,7 +607,7 @@ Released Jun 2008. Underscore (_) is allowed in debconf template names.

- Version 3.7.3.0 + Version 3.7.3.0

Released Dec 2007. @@ -525,7 +649,7 @@ Released Dec 2007. be referenced rather than quoted in debian/copyright.

- Version 3.7.2.2 + Version 3.7.2.2

Released Oct 2006. @@ -535,7 +659,7 @@ Released Oct 2006. should to a must)

- Version 3.7.2.0 + Version 3.7.2.0

Released Apr 2006. @@ -544,7 +668,7 @@ Released Apr 2006. 11.5 Revert the cgi-lib change.

- Version 3.7.1.0 + Version 3.7.1.0

Released Apr 2006. @@ -564,7 +688,7 @@ Released Apr 2006. they do so, they must pre-depend on x11-common (>= 1:7.0.0)

- Version 3.7.0.0 + Version 3.7.0.0

Released Apr 2006. @@ -605,7 +729,7 @@ Released Apr 2006. is gone.

- Version 3.6.2.0 + Version 3.6.2.0

Released 2005 @@ -625,7 +749,7 @@ Released 2005

- Version 3.6.1.0 + Version 3.6.1.0

Released Aug 2003. @@ -636,7 +760,7 @@ Released Aug 2003. user prompts are now deprecated.

- Version 3.6.0 + Version 3.6.0

Released Jul 2003. @@ -680,7 +804,7 @@ Released Jul 2003. target.

- Version 3.5.10 + Version 3.5.10

Released May 2003. @@ -695,7 +819,7 @@ Released May 2003. Project may add 40 points for ranking in the alternatives

- Version 3.5.9.0 + Version 3.5.9.0

Released Mar 2003. @@ -717,7 +841,7 @@ Released Mar 2003. (rather than /usr/share/doc/package/examples).

- Version 3.5.8.0 + Version 3.5.8.0

Released Nov 2002. @@ -741,7 +865,7 @@ Released Nov 2002. are still a bug.

- Version 3.5.7.0 + Version 3.5.7.0

Released Aug 2002. @@ -780,7 +904,7 @@ Added the last note in 3.5.6 upgrading checklist item regarding build rules, please see below

- Version 3.5.6.0 + Version 3.5.6.0

Released Jul 2001. @@ -805,7 +929,7 @@ Released Jul 2001. there is a new Build-Depend-Indep semantic.

- Version 3.5.5.0 + Version 3.5.5.0

Released May 2001. @@ -859,7 +983,7 @@ Released May 2001.

- Version 3.5.4.0 + Version 3.5.4.0

Released Apr 2001.

@@ -876,7 +1000,7 @@ Released May 2001.

- Version 3.5.3.0 + Version 3.5.3.0

Released Apr 2001

@@ -892,7 +1016,7 @@ Released May 2001.

- Version 3.5.2.0 + Version 3.5.2.0

Released Feb 2001. @@ -904,7 +1028,7 @@ Released May 2001.

- Version 3.5.1.0 + Version 3.5.1.0

Released Feb 2001. @@ -915,7 +1039,7 @@ Released May 2001.

- Version 3.5.0.0 + Version 3.5.0.0

Released Jan 2001. @@ -926,7 +1050,7 @@ Released May 2001.

- Version 3.2.1.1 + Version 3.2.1.1

Released Jan 2001. @@ -948,7 +1072,7 @@ Released May 2001.

- Version 3.2.1.0 + Version 3.2.1.0

Released Aug 00. @@ -960,7 +1084,7 @@ Released May 2001.

- Version 3.2.0.0 + Version 3.2.0.0

Released Aug 00. @@ -1011,7 +1135,7 @@ Released May 2001.

- Version 3.1.1.0 + Version 3.1.1.0

Released Nov 1999. @@ -1022,7 +1146,7 @@ Released May 2001.

- Version 3.1.0.0 + Version 3.1.0.0

Released Oct 1999. @@ -1077,7 +1201,7 @@ Released May 2001.

- Version 3.0.1.0 + Version 3.0.1.0

Released Jul 1999. @@ -1089,7 +1213,7 @@ Released May 2001.

- Version 3.0.0.0 + Version 3.0.0.0

Released Jun 1999. @@ -1134,7 +1258,7 @@ Released May 2001. Please note that section numbers below this point may not be up to date

- Version 2.5.0.0 + Version 2.5.0.0

Released Oct 1998. @@ -1173,7 +1297,7 @@ Policy Manual:

- Version 2.4.1.0 + Version 2.4.1.0

Released Apr 1998.

@@ -1200,7 +1324,7 @@ Policy Manual:

- Version 2.4.0.0 + Version 2.4.0.0

Released Jan 1998 @@ -1276,7 +1400,7 @@ Policy Manual:

- Version 2.3.0.1, 2.3.0.0 + Version 2.3.0.1, 2.3.0.0

Released Sep 1997. @@ -1293,7 +1417,7 @@ Policy Manual: MUAs and MTAs have to use liblockfile

- Version 2.2.0.0 + Version 2.2.0.0

Released July 1997. @@ -1320,7 +1444,7 @@ Policy Manual: app-defaults files may not be conffiles

- Version 2.1.3.2, 2.1.3.1, 2.1.3.0 + Version 2.1.3.2, 2.1.3.1, 2.1.3.0

Released Mar 1997. @@ -1338,7 +1462,7 @@ Policy Manual:

- Version 2.1.2.2, 2.1.2.1, 2.1.2.0 + Version 2.1.2.2, 2.1.2.1, 2.1.2.0

Released Nov 1996. @@ -1346,7 +1470,7 @@ Policy Manual: Some changes WRT shared libraries

- Version 2.1.1.0 + Version 2.1.1.0

Released Sep 1996. @@ -1359,7 +1483,7 @@ without consultation Shared libraries must be installed stripped

- Version 2.1.0.0 + Version 2.1.0.0

Released Aug 1996.