<!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 : Fri Mar 17 14:31:26 2000
+ Last Modified On : Sat Apr 28 13:36:28 2001
Last Machine Used: glaurung.green-gryphon.com
- Update Count : 10
+ Update Count : 16
Status : Unknown, Use with caution!
- HISTORY :
- Description :
+ HISTORY :
+ Description :
-->
<h2>The checklist</h2>
<pre>
-4.0.0.0 Mar 00
+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.
+ 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.
- 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
+ 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
- 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.
+ 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 theshared lib before the symlink, so the unpack
- order be correct.
+ always creating the shared lib before the symlink, so the unpack
+ order be correct.
3.1.1.0 Nov 99
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.)
+ - 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.
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.
+ 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
+ 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 anassi=ociated menu policy, in a separate document,
- that carries the full weight of Debian policy.
+ 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
"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
projects / debian / debian-policy.git / blobdiff