X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=upgrading-checklist.sgml;h=e1e789b03eca7c6a1076cf192a2a2fc4b8ba0661;hb=f545dfd88c291812520adee2147723a47e16f220;hp=c2d3c52f49bee7dd76dce1f8e8d898c390135efc;hpb=f59895b75b30a01846c8ad0390d4782fa1f2a895;p=debian%2Fdebian-policy.git diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml index c2d3c52..e1e789b 100644 --- a/upgrading-checklist.sgml +++ b/upgrading-checklist.sgml @@ -34,6 +34,139 @@ picking your way through this list. The checklist + Version 3.9.6.0 +

+ +Not yet released. + +

+9.6 + The requirements for the FreeDesktop menu entries are now + documented, in particular regarding the icon size and format, when to display + the entry, and where to coordinate the integration of the entries in menus of + specific desktop systems. The Debian menu is optionally supported. + +9.7 + Packages already shipping FreeDesktop menu entries should use + them to associate applications with media types. Only in the absence of + desktop entries, a file in mailcap format should be used. + Associations between media types and files should be done via upstream + databases, nevertheless it is also possible to register these associations + directly in Debian if needed. + +

+ + Version 3.9.5.0 +

+ +Released October, 2013. + +

+5.1 + Control data fields must not start with the hyphen character + (-), to avoid potential confusions when parsing clearsigned control + data files that were not properly unescaped. + +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. + +5.6.29 + New section documenting the Dgit field in Debian + source control files. + +9.1.1.8 + The exception to the FHS for the /selinux was removed. + +10.7.3 + Packages should remove all obsolete configuration files without + local changes during upgrades. The dpkg-maintscript-helper + tool, available from the dpkg package since + Wheezy, can help with this. + +10.10 + 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. + +11.5.2 + Stop recommending to serve HTML documents from + /usr/share/doc/package. + +12.2 + Packages distributing Info documents should use + install-info's trigger, and do not need anymore + to depend on dpkg (>= 1.15.4) | install-info. + +debconf + The escape capability is now documented. + +virtual + mp3-decoder and mp3-encoder are removed. +

+ 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

@@ -73,7 +206,7 @@ Released February, 2012. 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. + modified as above), -, and then some suitable suffix. 9.10 Packages using doc-base do not need to call install-docs anymore.