<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
<html>
<head>
- <!-- -*- Mode: Sgml -*-
+ <!-- -*- Mode: Sgml -*-
upgrading-checklist.html
- Author : Manoj Srivastava ( srivasta@tiamat.datasync.com )
+ 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:12:16 1998
- Last Machine Used: tiamat.datasync.com
- Update Count : 6
+ Last Modified On : Sat Apr 28 13:36:28 2001
+ Last Machine Used: glaurung.green-gryphon.com
+ Update Count : 16
Status : Unknown, Use with caution!
- HISTORY :
- Description :
+ HISTORY :
+ Description :
-->
<h2>The checklist</h2>
<pre>
+3.5.4.0 Apr 01
+ Policy Manual:
+ - The system-wide mail directory is <tt>/var/mail</tt>.
+ All access to the mail spool should be via the /var/mail
+ directory or symbolic link.
+ To maintain partial upgrade compatibility for systems
+ which have <tt>/var/spool/mail</tt> as their physical mail
+ spool, packages using <tt>/var/mail</tt> must depend on
+ either <em>libc6</em> (>= 2.1.3-13), or on
+ <em>base-files</em> (>= 2.2.0), or on later
+ versions of either one of these packages.
+ - The perl policy is now part of Debian policy proper. Perl
+ programs and modules should follow the current Perl policy.
+
+3.5.3.0 Apr 01
+ Policy Manual:
+ - Build-Depends arch syntax has been changed to be less
+ ambiguous. This should not affect any current packages
+ - Examples and templates should now live in
+ /usr/share/<package> or /usr/lib/<package>, with
+ symbolic links from /usr/share/doc//<package>/examples as
+ needed.
+
+3.5.2.0 Feb 01
+ Policy Manual:
+ - X app-defaults directory has moved from
+ /usr/X11R6/lib/X11/app-defaults to /etc/X11/app-defaults.
+
+3.5.1.0 Feb 01
+ Policy Manual:
+ - dpkg-shlibdeps now uses objdump, so shared libraries have to be
+ run through dpkg-shlibdeps as well as executables
+
+3.5.0.0 Jan 01
+ 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/
+ - Much of the packaging manual has now been imported into the
+ policy document
+
+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/<package> has to be a symlink pointing to
+ /usr/share/doc/<package>. 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 (Build-Depends, etc.). (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/<package>/examples with
+ symlinks from /usr/share/doc/<package>/examples/* or from
+ /usr/share/doc/<package>/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
"Configuration files", moving the Section 4.8 ("Permissions
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
+ gap.
+ - Modified the section about changelog files to accommodate
upstream changelogs which were formatted as HTML/ These
- upstream chagelog files should now be accessible as
- /usr/doc/package/changelog.html.gz
+ 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.
- Clarified that HTML documentation should be present in some
- Corrected all references to the location of the copyright
files. The correct location is /usr/doc/package/copyright
- Ratified the architecture specification strings to cater to the
- HURD.
+ HURD.
2.4.1.0 Apr 98
ldconfig must be called in the postinst script if the package
installs shared libraries
(cf., Policy Weekly Issue #6, fixes:bug#20515)
-
+
2.4.0.0 Jan 98
- Updated section 3.3.4 Scripts:
/etc/services, /etc/protocols, /etc/rpc, and /etc/inetd.conf
* updated section about `Configuration files':
- packages may not touch other packages' configuration files
+ packages may not touch other packages' configuration files
* MUAs and MTAs have to use liblockfile
* added section 4.1 `Architecture specification strings':
use
- <arch>-linux
+ <arch>-linux
where <arch> is one of the following:
i386, alpha, arm, m68k, powerpc, sparc.
2.1.1.0 Sep 96
* No hard links in source packages
-
+
* Do not use dpkg-divert or update-alternatives without consultation
* Shared libraries must be installed stripped
</body>
</html>
-
-
-
-
-
-
-
-
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml