X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=upgrading-checklist.sgml;h=dc62283d8dd7be32f60159de4729c70f5350a97e;hb=f39fe9d4bc04304a4f7f561169892faa4a4f6c5e;hp=88cf3df04078444a289e292d58772a383d98860d;hpb=3233167a3027d2535829ed80e95a674e1a8c5809;p=debian%2Fdebian-policy.git diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml index 88cf3df..dc62283 100644 --- a/upgrading-checklist.sgml +++ b/upgrading-checklist.sgml @@ -34,10 +34,230 @@ picking your way through this list. The checklist - Version 3.8.5.0 + Version 3.9.3.0

-Release Jun 2010. +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 + 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. + +8.6.3 + The SONAME of a library may instead be of the + form name-major-version.so. + +10.2 + Libtool .la files should not be installed for public + libraries. If they're required (for libltdl, for instance), + the dependency_libs setting should be emptied. Library + packages historically including .la files must continue to + include them (with dependency_libs emptied) until all libraries + 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 + file. + +

+ + Version 3.9.0.0 +

+ +Released June, 2010.

4.4, 5.6.15 @@ -49,9 +269,24 @@ Release Jun 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 + 1.8. The Format field syntax for source + package .dsc files allows a subtype in parentheses, and it + is used for a different purpose than the Format field + for .changes files. + +5.6.2 + The syntax of the Maintainer field is now must rather + than should. + +5.6.3 + The comma separating entries in Uploaders is now must + rather than should. 5.6.8, 7.1, 11.1.1 Architecture wildcards may be used in addition to specific @@ -66,6 +301,25 @@ Release Jun 2010. is no controlling terminal and no reasonable default for a high-priority question, but should avoid this if possible. +7.3, 7.6.1 + Breaks should be used with Replaces for moving + files between packages. + +7.4 + Breaks should normally be used instead + of Conflicts for transient issues and moving files between + packages. New documentation of when each should be used. + +7.5 + Use Conflicts with Provides if only one provider + of a virtual facility can be installed at a time. + +8.4 + All shared library development files are no longer required to be + in the -dev package, only be available when the -dev + package is installed. This allows the -dev package to be split + as long as it depends on the additional packages. + 9.2.2 The UID range of user accounts is extended to 1000-59999. @@ -80,6 +334,11 @@ Release Jun 2010. in debian/copyright, although it will still be in common-licenses for the time being. +debconf + 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 provides perlapi-abiname instead of a @@ -94,7 +353,7 @@ Release Jun 2010.

- Version 3.8.4.0 + Version 3.8.4.0

Release Jan 2010. @@ -106,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 @@ -115,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 @@ -170,7 +430,7 @@ Released Aug 2009.

- Version 3.8.2.0 + Version 3.8.2.0

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

- Version 3.8.1.0 + Version 3.8.1.0

Released Mar 2009. @@ -225,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 @@ -240,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 @@ -268,7 +528,7 @@ Released Mar 2009.

- Version 3.8.0.0 + Version 3.8.0.0

Released Jun 2008. @@ -347,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. @@ -389,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. @@ -399,7 +659,7 @@ Released Oct 2006. should to a must)

- Version 3.7.2.0 + Version 3.7.2.0

Released Apr 2006. @@ -408,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. @@ -428,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. @@ -469,7 +729,7 @@ Released Apr 2006. is gone.

- Version 3.6.2.0 + Version 3.6.2.0

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

- Version 3.6.1.0 + Version 3.6.1.0

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

- Version 3.6.0 + Version 3.6.0

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

- Version 3.5.10 + Version 3.5.10

Released May 2003. @@ -559,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. @@ -581,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. @@ -605,7 +865,7 @@ Released Nov 2002. are still a bug.

- Version 3.5.7.0 + Version 3.5.7.0

Released Aug 2002. @@ -644,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. @@ -669,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. @@ -723,7 +983,7 @@ Released May 2001.

- Version 3.5.4.0 + Version 3.5.4.0

Released Apr 2001.

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

- Version 3.5.3.0 + Version 3.5.3.0

Released Apr 2001

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

- Version 3.5.2.0 + Version 3.5.2.0

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

- Version 3.5.1.0 + Version 3.5.1.0

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

- Version 3.5.0.0 + Version 3.5.0.0

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

- Version 3.2.1.1 + Version 3.2.1.1

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

- Version 3.2.1.0 + Version 3.2.1.0

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

- Version 3.2.0.0 + Version 3.2.0.0

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

- Version 3.1.1.0 + Version 3.1.1.0

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

- Version 3.1.0.0 + Version 3.1.0.0

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

- Version 3.0.1.0 + Version 3.0.1.0

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

- Version 3.0.0.0 + Version 3.0.0.0

Released Jun 1999. @@ -998,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. @@ -1037,7 +1297,7 @@ Policy Manual:

- Version 2.4.1.0 + Version 2.4.1.0

Released Apr 1998.

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

- Version 2.4.0.0 + Version 2.4.0.0

Released Jan 1998 @@ -1140,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. @@ -1157,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. @@ -1184,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. @@ -1202,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. @@ -1210,7 +1470,7 @@ Policy Manual: Some changes WRT shared libraries

- Version 2.1.1.0 + Version 2.1.1.0

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

- Version 2.1.0.0 + Version 2.1.0.0

Released Aug 1996.