X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=upgrading-checklist.sgml;h=3dc378c102aef1bd31259dd41476a9675f8877a7;hb=ba04d788ed3b8a5ec1acc2bed52500dc97d86a01;hp=03669f9a6be3598760cddc18636710a07c38a930;hpb=a6b5c99da21817476d98ca976e034a0dd86a9804;p=debian%2Fdebian-policy.git diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml index 03669f9..3dc378c 100644 --- a/upgrading-checklist.sgml +++ b/upgrading-checklist.sgml @@ -34,16 +34,113 @@ picking your way through this list. The checklist - Version 3.8.5.0 + Version 3.9.1.0

-Release Jun 2010. +Not yet released. + +

+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. + +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.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. + +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 The required format for the date in a changelog entry and in the Date control field is now precisely specified. +5.1 + A control paragraph must not contain more than one instance of a + 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. + +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 architectures in debian/control and *.dsc @@ -57,6 +154,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. @@ -64,6 +180,18 @@ Release Jun 2010. init.d scripts are a possible exception from the normal requirement to use set -e in each shell script. +12.5 + The UCB BSD license was removed from the list of licenses that + should be referenced from /usr/share/common-licenses/BSD. + It should instead be included directly + in debian/copyright, although it will still be in + 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. + perl perl-base now provides perlapi-abiname instead of a