]> git.donarmstrong.com Git - debian/debian-policy.git/blobdiff - upgrading-checklist.html
Synchronized with patch 55 from Manojs tree
[debian/debian-policy.git] / upgrading-checklist.html
index b21e990eec28854c4465d2cd432597c0440cfcda..af7d6f1589dc51efcc82a6549c7eb2b98566995d 100644 (file)
@@ -6,10 +6,10 @@
     Author           : Manoj Srivastava ( srivasta@tiamat.datasync.com ) 
     Created On       : Thu Oct 29 20:54:48 1998
     Created On Node  : tiamat.datasync.com
-    Last Modified By : Manoj Srivastava
-    Last Modified On : Thu Oct 29 22:10:16 1998
-    Last Machine Used: tiamat.datasync.com
-    Update Count     : 5
+    Last Modified By : Julian Gilbey
+    Last Modified On : Mon Jun 19 20:06:50 2000
+    Last Machine Used: polya.maths.qmw.ac.uk
+    Update Count     : 11
     Status           : Unknown, Use with caution!
     HISTORY          : 
     Description      : 
@@ -44,11 +44,120 @@ Manual.
 <h2>The checklist</h2>
 
 <pre>
+3.2.0.0                    Jun 00
+
+  Policy Manual:
+     - By default executables should not be built with the debugging
+       option -g. Instead, it is recommended to support building the
+       package with debugging information optionally.
+     - Policy for packages where the upstream uses html changelog
+       files has been expanded. In short, a plain text changelog file
+       should always be generated for the upstream changes.
+     - Please note that the new release of the X window system (4.x)
+       shall probably need sweeping changes in policy.
+     - Policy for packages providing an X server has been codified
+       (formalizes existing practice - use virtual package xserver)
+     - Policy for packages providing an X terminal emulator has been
+       codified (use virtual package x-terminal-emulator)
+     - Policy for packages providing an X window manager has been
+       codified (use virtual package x-window-anager, and also as an
+       alternative for /usr/bin/x-window-manager. The policy has
+       guidelines on how to calculate priority)
+     - Policy for packages providing an X fonts has been
+       codified. Please look into the manual for details; this section
+       has been written from scratch.
+     - Policy for packages using the X Window System and FHS issues
+       has been clarified. Please read the manual for details.
+     - Policy for packages providing an X application default has been
+       clarified. 
+
+  Packaging Manual:
+     - Noted that newer dpkg versions do not require extreme care in
+       always creating theshared lib before the symlink, so the unpack
+       order be correct. 
+
+3.1.1.0                    Nov 99
+
+  Packaging Manual:
+     - Correction to semantics of architecture lists in Build-Depends
+      etc.  Should not affect many packages.
+
+3.1.0.0                    Oct 99
+
+  Policy Manual:
+     - /usr/doc/&lt;package&gt; has to be a symlink pointing to
+       /usr/share/doc/&lt;package&gt;.  This symlink has to be
+       maintained by postinst and prerm, because dpkg will cause
+       problems otherwise.  Create/remote the symlinks using debhelper
+       or see section "6.4. Accessing the documentation" for more
+       information.
+     - Introduced source dependencies.  (Whereas this ought to demand a
+       major policy number rise, we've only just had one of them, so
+       I'm going to use a minor number instead.)
+     - /etc/rc.boot has been deprecated in favour of /etc/rcS.d.
+       Packages should not be touching this directory, anyway, but
+       should use update-rc.d instead.
+     - update-rc.d is now the *only* allowable way of accessing the
+       /etc/rc?.d/[SK]??* links.  Any scripts which manipulate them
+       directly must be changed to use update-rc.d instead.  (This is
+       because the file-rc package handles this information in an
+       incompatible way.)
+     - Compiled examples go in /usr/lib/&lt;package&gt;/examples with
+       symlinks from /usr/share/doc/&lt;package&gt;/examples/* or from
+       /usr/share/doc/&lt;package&gt;/examples itself.
+     - Updated FHS to a 2.1 draft; this reverts /var/state to
+      /var/lib.
+     - Added MIME sub-policy document.
+     - VISUAL is allowed as a (higher priority) alternative to EDITOR.
+     - Modified liblockfile description, which affects
+       mailbox-accessing programs.  Please see the policy document for
+       details.
+     - If a package provides a changelog in HTML format, a text-only
+       version should also be included.  Such a version may be prepared
+       using lynx -dump -nolist.)
+
+  Packaging Manual:
+     - Description of how to handle version numbers based on dates
+       added: see section 5.1.
+
+
+3.0.1.0                    Jul 99
+
+  Policy Manual:
+    -  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.
+
+
+3.0.0.0                    Jun 99
+
+  Policy Manual:
+    - Debian formally moves from the FSSTND to the FHS. This is a
+      major change, and the implications of this move are probably
+      not all known.
+    - Only 3 digits of the Standards version need be included in
+      control files, though all four digits are still permitted. 
+    - The location of the GPL has changed to
+      /usr/share/common-licenses. This may require changing the
+      copyright files to point to the correct location of the GPL and
+      other major licences
+    - Packages that use libtool to create shared libraries must
+      include the .la files in the -dev packages.
+    - Use logrotate to rotate log files
+    - section 5.8 has been rewritten (Programs for the X Window
+      System) 
+    - There is now anassi=ociated menu policy, in a separate document,
+      that carries the full weight of Debian policy. 
+    - The files `/var/run/utmp', `/var/log/wtmp' and
+      `/var/log/lastlog' must be installed writeable by group
+      utmp. Programs who need to modify those files must be installed
+      install setgid utmp.
+
 
 2.5.0.0                         Oct 98
 
   Policy Manual:
-    - Rearranged the manula to create a new Section 4, Files
+    - Rearranged the manual to create a new Section 4, Files
       + Section 3.3 ("Files") was moved to Section 4. The Sections
         that  were Section 4 and Section 5 were  moved down to become
         Section 5 and Section 6.