r277 - /web/deps/dep9.mdwn

[sez at users.alioth.debian.org]

Author: sez
Date: Sun Feb 19 21:40:51 2012
New Revision: 277

URL: http://svn.debian.org/wsvn/dep/?sc=1&rev=277
Log:
dep9: add new section for new packages and update transition section


Modified:
    web/deps/dep9.mdwn

Modified: web/deps/dep9.mdwn
URL: http://svn.debian.org/wsvn/dep/web/deps/dep9.mdwn?rev=277&op=diff
==============================================================================
--- web/deps/dep9.mdwn (original)
+++ web/deps/dep9.mdwn Sun Feb 19 21:40:51 2012
@@ -176,31 +176,43 @@
 - remove: remove inetd.conf entry and matching shadow fragment
 - enable: enable inetd.conf entry
 
+# Configuration of new server packages
+
+Packages that have never used update-inetd must do the following:
+
+* depend on reconf-inetd
+* install a reconf-inetd fragment in /usr/share/reconf-inetd, as a regular
+  file (ie. not as a conffile);
+
 # Transition of "Depends: update-inetd" packages
 
 A time-limited transition is not a strict requirement, since reconf-inetd and
 update-inetd can co-exist without problems.
-
-Server packages that depend on update-inetd can be converted as follows:
-
-* remove any references of update-inetd in post{inst,rm} scripts;
-* install a reconf-inetd fragment in /usr/share/reconf-inetd, as a regular
-  file (ie. not as a conffile);
-* replace the dependency on update-inetd with one on reconf-inetd (but see
-  notes below)
 
 reconf-inetd will not touch any entries that have not been added by itself,
 including entries added by update-inetd. Thus, a server package that is meant
 to transition from update-inetd to reconf-inetd, must remove any entries that
 it previously added using update-inetd.
 
-Below is an example postinst snippet for an ftp server package that is meant
-to be transitioned from update-inetd to reconf-inetd in release 2.0:
+Server packages that depend on update-inetd can be converted as follows:
+
+0) in the first stable Debian release in which reconf-inetd is used by the
+package:
+
+* depend on both update-inetd and reconf-inetd
+* install a reconf-inetd fragment in /usr/share/reconf-inetd, as a regular
+  file (ie. not as a conffile);
+* drop any references to update-inetd in postrm, and modify postinst to remove
+  any inetd.conf entries for that package that were previously added using
+  update-inetd
+
+Below is an example postinst snippet for the ftpd-ssl server package (assuming
+it ships /usr/share/reconf-inetc/ftpd-ssl.xinetd):
 
 <pre>
     case $1 in
         configure)
-            if dpkg --compare-versions "$2" le 2.0; then
+            if ! -e /var/lib/reconf-inetd/ftpd-ssl.xinetd; then
                 if which update-inetd; then
                     update-inetd --remove ftp
                 fi
@@ -208,6 +220,9 @@
         ;;
     esac
 </pre>
+
+1) in later stable Debian releases, simply drop update-inetd all together
+(dependency and postinst snippet)
 
 # Requirements for xinetd/reconf-inetd fragments