X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=upgrading-checklist.sgml;h=6ebbded63bfe7ad9bd9c3dd602ab592c69100506;hb=772805dafad99de08f67274e2320a70c198b8d90;hp=41220a0424ca91663c61ab7a105901d08bb900c1;hpb=96ba2dfcb00f5cfa50d7d5ea22a88cdfdd4ccbab;p=debian%2Fdebian-policy.git diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml index 41220a0..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,11 +34,89 @@ picking your way through this list. The checklist - Version 3.9.3.0 + Version 3.9.5.0

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, @@ -49,9 +127,39 @@ Unreleased. 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 @@ -62,6 +170,15 @@ Unreleased. 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.