X-Git-Url: https://git.donarmstrong.com/?p=debian%2Fdebian-policy.git;a=blobdiff_plain;f=upgrading-checklist.sgml;h=6ebbded63bfe7ad9bd9c3dd602ab592c69100506;hp=33d446765aad88e072022b53e052be479a300f87;hb=772805dafad99de08f67274e2320a70c198b8d90;hpb=023d5b14a8e51618f9c3456102196027914dc02f diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml index 33d4467..6ebbded 100644 --- a/upgrading-checklist.sgml +++ b/upgrading-checklist.sgml @@ -6,7 +6,7 @@ Bill Allombert Josip Rodin Julian Gilbey - Russ Allbery + Russ Allbery Manoj Srivastava About the checklist @@ -34,10 +34,165 @@ picking your way through this list. The checklist - Version 3.9.2.0 + Version 3.9.5.0

-Released April, 2010. +Unreleased. + +

+5.4, 5.6.24 + Checksums-Sha1 and Checksums-Sha256 are now + mandatory in .dsc files. + +5.6.25, 5.8.1 + The DM-Upload-Allowed field is obsolete. Permissions + are now granted via dak-commands files. +5.6.27 + New section documenting the Package-List field in Debian + source control files. + +5.6.28 + New section documenting the Package-Type field in source + package control files. + +debconf + The escape capability is now documented. + +

+ + Version 3.9.4.0 +

+ +Released August, 2012. + +

+2.4 + New tasks archive section. + +4.9 + build-arch and build-indep are now mandatory + targets in debian/rules. + +5.6.26 + New section documenting the Vcs-* fields, which are + already in widespread use. Note the mechanism for specifying the Git + branch used for packaging in the Vcs-Git field. + +7.1 + The deprecated relations < and > now must not be used. + +7.8 + New Built-Using 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. + +8.6 + Policy for dependencies between shared libraries and other + packages has been largely rewritten to document the symbols + system and more clearly document handling of shared library ABI + changes. symbols files are now recommended + over shlibs files in most situations. All maintainers of + shared library packages should review the entirety of this section. + +9.1.1 + Packages must not assume the /run directory exists or + is usable without a dependency on initscripts (>= 2.88dsf-13.3) + until the stable release of Debian supports /run. + +9.7 + Packages including MIME configuration can now rely on triggers and + do not need to call update-mime. +9.11 + New section documenting general requirements for alternate init + systems and specific requirements for integrating with upstart. + +12.5 + All copyright files must be encoded in UTF-8. + +

+ + Version 3.9.3.0 +

+ +Released February, 2012. + +

+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. + +7.1 + If a dependency is restricted to particular architectures, the + list of architectures must be non-empty. + +9.1.1 + /run is allowed as an exception to the FHS and + replaces /var/run. /run/lock + replaces /var/lock. The FHS requirements for the older + directories apply to these directories as well. Backward compatibility + links will be maintained and packages need not switch to + referencing /run directly yet. Files in /run + should be stored in a temporary file system. + +9.1.4 + New section spelling out the requirements for packages that use + files in /run, /var/run, + or /var/lock. This generalizes information previously only + in 9.3.2. + +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 suffix. + +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). + +copyright-format + Version 1.0 of the "Machine-readable debian/copyright + file" specification is included. + +mime + This separate document has been retired and and its (short) + contents merged 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.

* @@ -90,21 +245,21 @@ Released April, 2010. GNU/Hurd systems are allowed /hurd and /servers directories in the root filesystem. -virtual - mailx is now a virtual package provided by packages that - install /usr/bin/mailx and implement at least the - POSIX-required interface. - 9.1.1 Packages installing to architecture-specific subdirectories of - /url/lib must use the value returned by + /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 + Version 3.9.1.0

Released July, 2010. @@ -201,7 +356,7 @@ Released July, 2010.

- Version 3.9.0.0 + Version 3.9.0.0

Released June, 2010. @@ -300,7 +455,7 @@ Released June, 2010.

- Version 3.8.4.0 + Version 3.8.4.0

Release Jan 2010. @@ -321,7 +476,7 @@ Release Jan 2010.

- Version 3.8.3.0 + Version 3.8.3.0

Released Aug 2009. @@ -377,7 +532,7 @@ Released Aug 2009.

- Version 3.8.2.0 + Version 3.8.2.0

Released Jun 2009. @@ -417,7 +572,7 @@ Released Jun 2009.

- Version 3.8.1.0 + Version 3.8.1.0

Released Mar 2009. @@ -475,7 +630,7 @@ Released Mar 2009.

- Version 3.8.0.0 + Version 3.8.0.0

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

- Version 3.7.3.0 + Version 3.7.3.0

Released Dec 2007. @@ -596,7 +751,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. @@ -606,7 +761,7 @@ Released Oct 2006. should to a must)

- Version 3.7.2.0 + Version 3.7.2.0

Released Apr 2006. @@ -615,7 +770,7 @@ Released Apr 2006. 11.5 Revert the cgi-lib change.

- Version 3.7.1.0 + Version 3.7.1.0

Released Apr 2006. @@ -635,7 +790,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. @@ -676,7 +831,7 @@ Released Apr 2006. is gone.

- Version 3.6.2.0 + Version 3.6.2.0

Released 2005 @@ -696,7 +851,7 @@ Released 2005

- Version 3.6.1.0 + Version 3.6.1.0

Released Aug 2003. @@ -707,7 +862,7 @@ Released Aug 2003. user prompts are now deprecated.

- Version 3.6.0 + Version 3.6.0

Released Jul 2003. @@ -751,7 +906,7 @@ Released Jul 2003. target.

- Version 3.5.10 + Version 3.5.10

Released May 2003. @@ -766,7 +921,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. @@ -788,7 +943,7 @@ Released Mar 2003. (rather than /usr/share/doc/package/examples).

- Version 3.5.8.0 + Version 3.5.8.0

Released Nov 2002. @@ -812,7 +967,7 @@ Released Nov 2002. are still a bug.

- Version 3.5.7.0 + Version 3.5.7.0

Released Aug 2002. @@ -851,7 +1006,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. @@ -876,7 +1031,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. @@ -930,7 +1085,7 @@ Released May 2001.

- Version 3.5.4.0 + Version 3.5.4.0

Released Apr 2001.

@@ -947,7 +1102,7 @@ Released May 2001.

- Version 3.5.3.0 + Version 3.5.3.0

Released Apr 2001

@@ -963,7 +1118,7 @@ Released May 2001.

- Version 3.5.2.0 + Version 3.5.2.0

Released Feb 2001. @@ -975,7 +1130,7 @@ Released May 2001.

- Version 3.5.1.0 + Version 3.5.1.0

Released Feb 2001. @@ -986,7 +1141,7 @@ Released May 2001.

- Version 3.5.0.0 + Version 3.5.0.0

Released Jan 2001. @@ -997,7 +1152,7 @@ Released May 2001.

- Version 3.2.1.1 + Version 3.2.1.1

Released Jan 2001. @@ -1019,7 +1174,7 @@ Released May 2001.

- Version 3.2.1.0 + Version 3.2.1.0

Released Aug 00. @@ -1031,7 +1186,7 @@ Released May 2001.

- Version 3.2.0.0 + Version 3.2.0.0

Released Aug 00. @@ -1082,7 +1237,7 @@ Released May 2001.

- Version 3.1.1.0 + Version 3.1.1.0

Released Nov 1999. @@ -1093,7 +1248,7 @@ Released May 2001.

- Version 3.1.0.0 + Version 3.1.0.0

Released Oct 1999. @@ -1148,7 +1303,7 @@ Released May 2001.

- Version 3.0.1.0 + Version 3.0.1.0

Released Jul 1999. @@ -1160,7 +1315,7 @@ Released May 2001.

- Version 3.0.0.0 + Version 3.0.0.0

Released Jun 1999. @@ -1205,7 +1360,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. @@ -1244,7 +1399,7 @@ Policy Manual:

- Version 2.4.1.0 + Version 2.4.1.0

Released Apr 1998.

@@ -1271,7 +1426,7 @@ Policy Manual:

- Version 2.4.0.0 + Version 2.4.0.0

Released Jan 1998 @@ -1347,7 +1502,7 @@ Policy Manual:

- Version 2.3.0.1, 2.3.0.0 + Version 2.3.0.1, 2.3.0.0

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

- Version 2.2.0.0 + Version 2.2.0.0

Released July 1997. @@ -1391,7 +1546,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. @@ -1409,7 +1564,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. @@ -1417,7 +1572,7 @@ Policy Manual: Some changes WRT shared libraries

- Version 2.1.1.0 + Version 2.1.1.0

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

- Version 2.1.0.0 + Version 2.1.0.0

Released Aug 1996.