X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=upgrading-checklist.sgml;h=a0f46980356505ebe93fba83a7075d3cd5628ef4;hb=d87b820af684e823db0d13542635a987ad9504dc;hp=37830375c18f604bd26798c4c4ef23d21bc64268;hpb=3212d8cadc3c02921a48b7e8aba9bb82924c70d1;p=debian%2Fdebian-policy.git diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml index 3783037..a0f4698 100644 --- a/upgrading-checklist.sgml +++ b/upgrading-checklist.sgml @@ -34,22 +34,150 @@ picking your way through this list. The checklist + Version 3.9.3.0 +

+ +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.10 + Packages using doc-base do not need to call install-docs anymore. + +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. + +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

-Not yet released. +Released July, 2010.

+3.2.1 + Date-based version components should be given as the four-digit + year, two-digit month, and then two-digit day, but may have embedded + punctuation. + 3.9 Maintainer scripts must pass --package to dpkg-divert when creating or removing diversions and must not use --local. +4.10 + Only dpkg-gencontrol supports variable substitution. + dpkg-genchanges (for *.changes) + and dpkg-source (for *.dsc) do not. + 7.1 Architecture restrictions and wildcards are also allowed in binary package relationships provided that the binary package is not architecture-independent. +7.4 + Conflicts and Breaks should only be used when + there are file conflicts or one package breaks the other, not just + because two packages provide similar functionality but don't interfere. + +8.1 + The SONAME of a library should change whenever the ABI of the + library changes in a way that isn't backward-compatible. It should not + change if the library ABI changes are backward-compatible. Discourage + bundling shared libraries together in one package. + +8.4 + Ada Library Information (*.ali) files must be + installed read-only. + 8.6.1, 8.6.2, 8.6.5 Packages should normally not include a shlibs.local file since we now have complete shlibs coverage. @@ -67,6 +195,38 @@ Not yet released. that depend on that library have removed or emptied their .la files. +10.2 + Libraries no longer need to be built with -D_REENTRANT, + which was an obsolete LinuxThreads requirement. Instead, say explicitly + that libraries should be built with threading support and to be + thread-safe if the library supports this. + +10.4 + /bin/sh scripts may assume that kill + supports an argument of -signal, + that kill and trap support the numeric signals + listed in the XSI extension, and that signal 13 (SIGPIPE) can be trapped + with trap. + +10.8 + Use of /etc/logrotate.d/package for + logrotate rules is now recommended. + +10.9 + Control information files should be owned by root:root + and either mode 644 or mode 755. + +11.4, 11.8.3, 11.8.4 + Packages providing alternatives for editor, + pager, x-terminal-emulator, or + x-window-manager should also provide a slave alternative + for the corresponding manual page. + +11.5 + Cgi-bin executable files may be installed in subdirectories + of /usr/lib/cgi-bin and web servers should serve out + executables in those subdirectories. + 12.5 The GPL version 1 is now included in common-licenses and should be referenced from there instead of included in the copyright @@ -89,9 +249,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 @@ -155,9 +315,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 @@ -185,8 +345,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 @@ -200,8 +360,8 @@ 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 @@ -304,12 +465,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 @@ -319,8 +480,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