]> git.donarmstrong.com Git - debian/debian-policy.git/blobdiff - upgrading-checklist.html
* Set the cotact information for the FHS contact, and add mention of the
[debian/debian-policy.git] / upgrading-checklist.html
index bb81e6b57231a2fd205c9928d9733354e8b18738..187d657bd61e234569b76e396653fccfc01e217b 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 : Thu Mar 14 11:42:10 2002
     Last Machine Used: glaurung.green-gryphon.com
-    Update Count     : 16
+    Update Count     : 20
     Status           : Unknown, Use with caution!
     HISTORY          :
     Description      :
@@ -53,8 +53,49 @@ picking your way through this list.
 <h2>The checklist</h2>
 
 <pre>
+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
+     - 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 //localhost/doc/ directory, then it is preferred that one
+       ask permission to expose that information during the install [12.5]
+
+
+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
-  Policy Manual:
+
      - The system-wide mail directory is now /var/mail, no longer
        /var/spool/mail.  Any packages accessing the mail spool should
        access it via /var/mail and include a suitable Depends field;
@@ -65,39 +106,38 @@ picking your way through this list.
 
 
 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 [7.1]
-     - Examples and templates should now live in
-       /usr/share/&lt;package&gt; or /usr/lib/&lt;package&gt;, with
+     - 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
        needed [11.7.3]
 
 
 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 [12.8]
+       /usr/X11R6/lib/X11/app-defaults to /etc/X11/app-defaults [12.8.6]
 
 
 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 [9.1]
 
 
 3.5.0.0                    Jan 01
-  Policy Manual:
+
      - 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
 
-  Policy Manual:
      - 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
@@ -110,7 +150,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
@@ -124,16 +164,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
@@ -179,7 +219,6 @@ picking your way through this list.
 
 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 [11.2]
@@ -187,7 +226,6 @@ picking your way through this list.
 
 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. [10.1]
@@ -297,7 +335,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