]> git.donarmstrong.com Git - debian/debian-policy.git/blobdiff - upgrading-checklist.html
init script restart will start a service if not running (three seconds to the latest...
[debian/debian-policy.git] / upgrading-checklist.html
index 7e27c6604a089a3dc8917ff9ed86e78fa27eb782..aa56254de3364d0e156f3d24382aa64feceb0ce0 100644 (file)
@@ -7,9 +7,9 @@
     Created On       : Thu Oct 29 20:54:48 1998
     Created On Node  : tiamat.datasync.com
     Last Modified By : Manoj Srivastava
-    Last Modified On : Sat Apr 28 13:36:28 2001
+    Last Modified On : Sat Oct 26 12:22:40 2002
     Last Machine Used: glaurung.green-gryphon.com
-    Update Count     : 16
+    Update Count     : 29
     Status           : Unknown, Use with caution!
     HISTORY          :
     Description      :
@@ -53,6 +53,99 @@ picking your way through this list.
 <h2>The checklist</h2>
 
 <pre>
+3.5.9.0                    ??? ??
+
+     - The section describing the Description: package filed once again has
+       full details of the long description format. [5.7.2]
+     - Clarified that if a package has non-build-essential
+       build-dependencies, it should have them listed in the Build-Depends
+       and related fields (i.e. it's just optional). [2.4.2]
+     - When asked to restart a service that isn't already running,
+       the init script should start the service. [10.3.2]
+
+3.5.8.0                    Nov 02
+
+     - It is no longer necessary to keep a log of changes to the upstream
+       sources in the copyright file. Instead, all such changes should be
+       documented in the changelog file. [13.7]
+     - <tt>Build-Depends</tt>,         <tt>Build-Conflicts</tt>,
+       <tt>Build-Depends-Indep</tt>, and
+       <tt>Build-Conflicts-Indep</tt> must also be satisfied when the
+       clean target is called. [7.6]
+     - A new apps/Science menu section is available [menu policy]
+     - debconf specification cleared up, various changes. [debconf
+       policy]
+     - It is no longer recommended to create symlinks from nonexistent
+       manual pages to undocumented(7). Missing manual pages for programs
+       are still a bug. [13.1]
+
+3.5.7.0                    Aug 02
+
+     - Packages no longer have to ask permission to call MAKEDEV in
+       postinst, merely notifying the user ought to be enough. [11.6]
+     - cryptographic software may now be included in the main
+       archive. [2.1.5]
+     - task packages are no longer permitted; tasks are now created by a
+       special Tasks: field in the control file. [2.3.8]
+     - window managers that support netwm can now add 20 points when
+       they add themselves as an alternative for
+       /usr/bin/x-window-manager [12.8.4]
+     - The default compilation options have now changed, one should
+       provide debugging symbols in all cases, and optionally step
+       back optimization to -O0, depending on the DEB_BUILD_OPTIONS
+       environment variable. [11.1]
+     - Added mention of build-arch, build-indep, etc, in describing
+       the relationships with `Build-Depends', `Build-Conflicts',
+       `Build-Depends-Indep', and `Build-Conflicts-Indep'. May need to
+       review the new rules.  [7.6, 5.2]
+     - Changed rules on how, and when, to invoke ldconfig in maintiner
+       scripts. Long rationale. [9]
+     - [Added the last note in 3.5.6 upgrading checklist item regarding
+       build rules, please see below]
+
+3.5.6.0                    Jul 01
+
+     - Emacs and TeX are no longer mandated by policy to be priority
+       standard packages [2.2]
+     - Programs that access docs need to do so via /usr/share/doc, and
+       not via /usr/doc/ as was the policy previously [12.5]
+     - Putting documentation in /usr/doc versus /usr/share/doc is now
+       a ``serious'' policy violation. [13.3]
+     - For web servers, one should not provide non-local access to the
+       /usr/share/doc hierarchy. If one can't provide access controls for
+       the http://localhost/doc/ directory, then it is preferred that one
+       ask permission to expose that information during the install. [12.5]
+     - 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 01
+
+     - Manpages should not rely on header information to have
+       alternative manpage names available; it should only use
+       symlinks or .so pages to do this [13.1]
+     - [Clarified note in 3.5.3.0 upgrading checklist regarding
+        examples and templates: this refers only to those examples used
+        by scripts; see section 11.7.3 for the whole story]
+     - Included a new section 11.9.1 describing the use of
+       dpkg-statoverride; this does not have the weight of policy
+     - Clarify Standards-Version: you don't need to rebuild your
+       packages just to change the Standards-Version!
+     - Plugins are no longer bound by all the rules of shared
+       libraries [11.2]
+     - X Windows related things:
+       * Clarification of priority levels of X Window System related
+         packages [12.8.1]
+       * Rules for defining x-terminal-emulator improved [12.8.3]
+       * X Font policy rewritten: you must read this if you provide
+         fonts for the X Window System [12.8.5]
+       * Packages must not ship /usr/X11R6/lib/X11/app-defaults/ [12.8.6]
+       * X-related packages should usually use the regular FHS
+         locations; imake-using packages are exempted from this [12.8.7]
+       * OpenMotif linked binaries have the same rules as
+         OSF/Motif-linked ones [12.8.8]
+
+
 3.5.4.0                    Apr 01
 
      - The system-wide mail directory is now /var/mail, no longer
@@ -70,14 +163,14 @@ picking your way through this list.
        ambiguous. This should not affect any current packages [7.1]
      - Examples and templates files for use by scripts should now live
        in /usr/share/&lt;package&gt; or /usr/lib/&lt;package&gt;, with
-       symbolic links from /usr/share/doc//&lt;package&gt;/examples as
+       symbolic links from /usr/share/doc/&lt;package&gt;/examples as
        needed [11.7.3]
 
 
 3.5.2.0                    Feb 01
 
      - X app-defaults directory has moved from
-       /usr/X11R6/lib/X11/app-defaults to /etc/X11/app-defaults [12.8]
+       /usr/X11R6/lib/X11/app-defaults to /etc/X11/app-defaults [12.8.6]
 
 
 3.5.1.0                    Feb 01
@@ -89,14 +182,14 @@ picking your way through this list.
 3.5.0.0                    Jan 01
 
      - Font packages for the X Window System must now declare a
-       dependency on xutils (>= 4.0.2) [12.8]
+       dependency on xutils (>= 4.0.2) [12.8.5]
 
 
 3.2.1.1                    Jan 01
 
      - Daemon startup scripts in /etc/init.d/ should not contain
        modifiable parameters; these should be moved to a file in
-      /etc/default/; see [10.3.2] for details
+       /etc/default/; see [10.3.2] for details
      - Files in /usr/share/doc must not be referenced by any
        program.  If such files are needed, they must be placed in
        /usr/share/&lt;package&gt;/, and symbolic links created as required
@@ -109,7 +202,7 @@ picking your way through this list.
 
      - A package of priority standard or higher may provide two
        binaries, one compiled with support for the X Window System,
-       and the other without [12.8]
+       and the other without [12.8.1]
 
 
 3.2.0.0                    Aug 00
@@ -123,16 +216,16 @@ picking your way through this list.
      - Please note that the new release of the X window system (4.x)
        shall probably need sweeping changes in policy
      - Policy for packages providing the following X-based features
-       has been codified [12.8]:
-       - X server (virtual package xserver)
-       - X terminal emulator (virtual package x-terminal-emulator)
+       has been codified:
+       - X server (virtual package xserver) [12.8.2]
+       - X terminal emulator (virtual package x-terminal-emulator) [12.8.3]
        - X window manager (virtual package x-window-manager, and
          /usr/bin/x-window-manager alternative, with priority
-         calculation guidelines)
-       - X fonts (this section has been written from scratch)
-       - X application defaults
+         calculation guidelines) [12.8.4]
+       - X fonts (this section has been written from scratch) [12.8.5]
+       - X application defaults [12.8.6]
      - Policy for packages using the X Window System and FHS issues
-       has been clarified; see [12.8]
+       has been clarified; see [12.8.7]
      - No package may contain or make hard links to conffiles [11.7.3]
      - Noted that newer dpkg versions do not require extreme care in
        always creating the shared lib before the symlink, so the unpack
@@ -294,7 +387,7 @@ picking your way through this list.
       + /etc/news/organization and /etc/news/server should be supported
         by all news servers and clients
 
-    - Updated section 4.7 Programs for the X Windows system:
+    - Updated section 4.7 Programs for the X Window System:
       + programs requiring a non-free Motif library should be provided
         as foo-smotif and foo-dmotif package
       + if lesstif works reliably for such program, it should be linked