]> git.donarmstrong.com Git - debian/debian-policy.git/blobdiff - upgrading-checklist.html
Sync with upstream
[debian/debian-policy.git] / upgrading-checklist.html
index f3bf0af135ee466b01dcef9983b78a2dabdf903d..2358c2f4aef577c42daf88ffed8bb510a09f37c4 100644 (file)
@@ -53,7 +53,55 @@ picking your way through this list.
 <h2>The checklist</h2>
 
 <pre>
-3.7.3.0                        unreleased
+3.7.4.0                        unreleased
+
+     * The base section has been removed.  contrib and non-free have been
+       removed from the section list; they are only categories.  The base
+       system is now defined by priority.                        [2.4, 3.7]
+     * If dpkg-source -x doesn't provide the source that will be compiled,
+       a debian/rules patch target is recommended and should do whatever
+       else is necessary.                                        [4.9]
+     * Standardized the format of DEB_BUILD_OPTIONS.  Specified permitted
+       characters for tags, required that tags be whitespace-separated,
+       allowed packages to assume non-conflicting tags, and required
+       unknown flags be ignored.                                 [4.9.1, 10.1]
+     * Added parallel=n to the standardized DEB_BUILD_OPTIONS tags,
+       indicating that a package should be built using up to n parallel
+       processes if the package supports it                      [4.9.1]
+     * Debian packages should not use convience copies of code from other
+       packages unless the included package is explicitly intended to be
+       used that way.                                            [4.13]
+     * If dpkg-source -x doesn't produce source ready for editing and
+       building with dpkg-buildpackage, packages should include a
+       debian/README.source file explaining how to generate the patched
+       source, add a new modification, and remove an existing
+       modification.  This file may also be used to document packaging a
+       new upstream release and any other complexity of the Debian build
+       process.                                                  [4.14]
+     * The Uploaders field in debian/control may be wrapped.     [5.6.3]
+     * New Homepage field for upstream web sites.                [5.6.23]
+     * The Breaks field declares that this package breaks another and
+       prevents installation of the breaking package unless the package
+       named in Breaks is deconfigured first.  This field should not be
+       used until the dpkg in Debian stable supports it.         [6.5, 6.6, 7]
+     * Files in /etc/cron.{hourly,daily,weekly,monthly} must be
+       configuration files (upgraded from should).  Mention the hourly
+       directory.                                                [9.5]
+     * Manual pages in locale-specific directories should use either the
+       legacy encoding for that directory or UTF-8.  Country names should
+       not be included in locale-specific manual page directories unless
+       indicating a significant difference in the language.  All
+       characters in the manual page source should be representable in the
+       legacy encoding for a locale even if the man page is encoded in
+       UTF-8.                                                    [12.1]
+     * The Apache 2.0 license is now in common-licenses and should be
+       referenced rather than quoted in debian/copyright.        [12.5]
+     * Packages in contrib and non-free should state in the copyright file
+       that the package is not part of Debian GNU/Linux and briefly
+       explain why.                                              [12.5]
+
+3.7.3.0                        Dec 2007
+
      * Package version numbers may contain tildes, which sort before
        anything, even the end of a part.                         [5.6.12]
      * Scripts may assume that /bin/sh supports local (at a basic level)
@@ -66,13 +114,31 @@ picking your way through this list.
        menu structure.  Packages with menu entries should be reviewed to
        see if the menu section has been renamed or if one of the new
        sections would be more appropriate.                       [menu policy]
+     * The Source field in a .changes file may contain a version number
+       in parentheses.                                           [5.6.1]
+     * The acceptable values for the Urgency field are low, medium, high,
+       critical, or emergency.                                   [5.6.17]
+     * The shlibs file now allows an optional type field, indicating the
+       type of package for which the line is valid.  The only currently
+       supported type is udeb, used with packages for the Debian
+       Installer.                                                [8.6]
+     * Packages following the Debian Configuration management
+       specification must allow for translation of their messages by using
+       a gettext-based system such as po-debconf.                [3.9.1]
+     * GFDL 1.2, GPL 3, and LGPL 3 are now in common-licenses and should
+       be referenced rather than quoted in debian/copyright.     [12.5]
+
 3.7.2.2                        Oct 2006
+
      * Maintainer scripts must not be world writeable (up from a
        should to a must)                                         [6.1]
+
 3.7.2.0                        Apr 2006
+
      * Revert the cgi-lib change.                                [11.5]
 
 3.7.1.0                        Apr 2006
+
      * It is now possible to create shared libraries without
        relocatable code (using -fPIC) in certain exceptional cases,
        provided some procedures are followed, and for creating static
@@ -85,6 +151,7 @@ picking your way through this list.
        must  pre-depend on x11-common (>= 1:7.0.0)              [11.8.7] 
 
 3.7.0.0                        Apr 2006
+
      * Packages shipping web server CGI files are expected to install
        them in /usr/lib/cgi-lib/ directories.  This location change
        perhaps should be documented in NEWS                      [11.5]
@@ -112,8 +179,8 @@ picking your way through this list.
        /usr/share/fonts/X11/ now, and /usr/X11R6 is gone.
                                                       [ 11.8.5.2, 11.8.7, etc]
 
-
 3.6.2.0                        2005
+
      * Recommend doc-base, and not menu, for registering package documentation.
      * Run time support programs should live in subdirectories of
        /usr/lib/ or /usr/share, and preferably the shared lib is named
@@ -122,6 +189,7 @@ picking your way through this list.
        allow packages to share image files with the web server [11.5]
 
 3.6.1.0                    Aug 2003
+
      + Prompting the user should be done using debconf. Non debconf
        user prompts are now deprecated. [3.10.1]
 
@@ -164,7 +232,6 @@ picking your way through this list.
      - Window managers compliant with the Window Manager Specification
        Project may add 40 points for ranking in the alternatives [11.8.4]
 
-
 3.5.9.0                    Mar 2003
 
      - The section describing the Description: package field once again has
@@ -178,7 +245,6 @@ picking your way through this list.
        example files can be installed into <tt>/usr/share/doc/package</tt>
        (rather than <tt>/usr/share/doc/package/examples</tt>). [12.6]
 
-
 3.5.8.0                    Nov 2002
 
      - It is no longer necessary to keep a log of changes to the upstream
@@ -234,7 +300,6 @@ picking your way through this list.
      - There are new rules for build-indep/build-arch targets and
        there is a new Build-Depend-Indep semantic. [7]
 
-
 3.5.5.0                    May 2001
 
      - Manpages should not rely on header information to have
@@ -261,7 +326,6 @@ picking your way through this list.
        * OpenMotif linked binaries have the same rules as
          OSF/Motif-linked ones [11.8.8]
 
-
 3.5.4.0                    Apr 2001
 
      - The system-wide mail directory is now /var/mail, no longer
@@ -272,7 +336,6 @@ picking your way through this list.
        programs and modules should follow the current Perl policy
        [11.9; perl-policy]
 
-
 3.5.3.0                    Apr 2001
 
      - Build-Depends arch syntax has been changed to be less
@@ -282,25 +345,21 @@ picking your way through this list.
        symbolic links from /usr/share/doc/&lt;package&gt;/examples as
        needed [10.7.3]
 
-
 3.5.2.0                    Feb 2001
 
      - X app-defaults directory has moved from
        /usr/X11R6/lib/X11/app-defaults to /etc/X11/app-defaults [11.8.6]
 
-
 3.5.1.0                    Feb 2001
 
      - dpkg-shlibdeps now uses objdump, so shared libraries have to be
        run through dpkg-shlibdeps as well as executables [8.1]
 
-
 3.5.0.0                    Jan 2001
 
      - Font packages for the X Window System must now declare a
        dependency on xutils (>= 4.0.2) [11.8.5]
 
-
 3.2.1.1                    Jan 2001
 
      - Daemon startup scripts in /etc/init.d/ should not contain
@@ -313,14 +372,12 @@ picking your way through this list.
      - Much of the packaging manual has now been imported into the
        policy document
 
-
 3.2.1.0                    Aug 00
 
      - A package of priority standard or higher may provide two
        binaries, one compiled with support for the X Window System,
        and the other without [11.8.1]
 
-
 3.2.0.0                    Aug 00
 
      - By default executables should not be built with the debugging
@@ -347,13 +404,11 @@ picking your way through this list.
        always creating the shared lib before the symlink, so the unpack
        order be correct [8]
 
-
 3.1.1.0                    Nov 1999
 
      - Correction to semantics of architecture lists in Build-Depends
        etc.  Should not affect many packages [7.1]
 
-
 3.1.0.0                    Oct 1999
 
      - /usr/doc/&lt;package&gt; has to be a symlink pointing to
@@ -384,14 +439,12 @@ picking your way through this list.
      - Description of how to handle version numbers based on dates
        added [3.2.1]
 
-
 3.0.1.0                    Jul 1999
 
     -  Added the clarification that the .la files are essential for the
        packages using libtool's libltdl library, in which case the
        .la files must go in the run-time library package [10.2]
 
-
 3.0.0.0                    Jun 1999
 
     - Debian formally moves from the FSSTND to the FHS. This is a