]> git.donarmstrong.com Git - debian/debian-policy.git/blobdiff - upgrading-checklist.html
Synchronized with patch 75 from Manojs tree
[debian/debian-policy.git] / upgrading-checklist.html
index 6055f4f3ecc2e84ee00570303f159891f0db299c..16baa1cda3722ae14849a37becb705457bd7c6ba 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 : Thu Oct 29 22:12:16 1998
-    Last Machine Used: tiamat.datasync.com
-    Update Count     : 6
+    Last Modified On : Fri Jan 19 14:01:36 2001
+    Last Machine Used: glaurung.green-gryphon.com
+    Update Count     : 15
     Status           : Unknown, Use with caution!
     HISTORY          : 
     Description      : 
@@ -44,6 +44,148 @@ Manual.
 <h2>The checklist</h2>
 
 <pre>
+3.5.0.0                    Jan 28
+
+  Policy Manual:
+     - If your package had fonts for the X Window System, and you
+       converted BDF to PCF formats, the <tt>bdftopcf</tt> utility has
+       moved to the xutils package. 
+     - Font packages for the X Window System must now declare a
+       dependency on xutils >= 4.0.2 
+
+3.2.1.1                    Jan 01
+
+  Policy Manual:
+     - If your package has a daemon startup script in /etc/init.d/,
+       and that script has parameters a system administrator may need,
+       you need to modify the script to read values from a conffile
+       placed in /etc/default/ directory. This conffile maybe sourced
+       by the init.d script to determine the sonfigurable values (and
+       the conffile may contain only variable settings and comments).
+     - Files in /usr/share/doc may not be referenced by any
+       program. If such files are needed, they must be placed in
+       /usr/share/package-name/, and symbolic links created as required
+       in /usr/share/doc/package-name/
+
+3.2.1.0                    Aug 00
+
+  Policy Manual:
+     - A package of priority standard or higher may provide two
+       binaries, one compiled with support for the X Window System,
+       and the other without.
+     -
+
+3.2.0.0                    Aug 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. Please look at the 
+       examples using  DEB_BUILD_OPTIONS in the policy manual.
+     - 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-manager, 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. 
+     - No package may contain or make hard links to conffiles.
+
+  Packaging Manual:
+     - Noted that newer dpkg versions do not require extreme care in
+       always creating the shared 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 licenses
+    - 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 anassociated 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
 
@@ -58,9 +200,9 @@ Manual.
         and owners") to Section 4.9.  All subsections of the old
         Section 5 after 5.5  were moved down to fill in the number
         gap. 
-    - Modified the section about changelog files to accomodate
+    - Modified the section about changelog files to accommodate
       upstream changelogs which were formatted as HTML/ These
-      upstream chagelog files should now be accessible as
+      upstream changelog files should now be accessible as
       /usr/doc/package/changelog.html.gz 
       + Symlinks are permissible to link the real, or upstream,
         changelog name to the Debian mandated name.