[Pkg-sysvinit-commits] r1608 - in sysvinit/trunk/debian: . sysv-rc/man8

[Petter Reinholdtsen]

Author: pere
Date: 2009-08-13 21:28:11 +0000 (Thu, 13 Aug 2009)
New Revision: 1608

Modified:
   sysvinit/trunk/debian/changelog
   sysvinit/trunk/debian/sysv-rc/man8/update-rc.d.8
Log:
Extend the update-rc.d(8) manual page to document the new behaviour.

Modified: sysvinit/trunk/debian/changelog
===================================================================
--- sysvinit/trunk/debian/changelog	2009-08-13 18:38:35 UTC (rev 1607)
+++ sysvinit/trunk/debian/changelog	2009-08-13 21:28:11 UTC (rev 1608)
@@ -47,6 +47,7 @@
   * Adjust init.d/bootlogd dependencies to start before hostname,
     procps, pcmcia, hwclock, hwclockfirst, hibernate-clean and hdparm,
     to get the bootlogger started earlier in the boot (Closes: #538936).
+  * Extend the update-rc.d(8) manual page to document the new behaviour.
 
  -- Kel Modderman <kel at otaku42.de>  Sun, 02 Aug 2009 05:46:21 +1000
 

Modified: sysvinit/trunk/debian/sysv-rc/man8/update-rc.d.8
===================================================================
--- sysvinit/trunk/debian/sysv-rc/man8/update-rc.d.8	2009-08-13 18:38:35 UTC (rev 1607)
+++ sysvinit/trunk/debian/sysv-rc/man8/update-rc.d.8	2009-08-13 21:28:11 UTC (rev 1608)
@@ -55,6 +55,23 @@
 .I R "Debian Policy Manual" .
 
 .SH "INSTALLING INIT SCRIPT LINKS"
+update\-rc.d have two modes of operation for installing scripts
+into the boot sequence.  The legacy mode
+where the arguments are used to decide the boot sequence,
+and the current mode where dependency and runlevel
+information in the init.d script is used instead.
+See the insserv(8) manual page for details about the
+header format.  The boot sequencing method is decided
+during installation or upgrades.  During upgrades, if there
+are no loops in the dependencies and no obsolete init.d scripts,
+the boot system is converted to dependency based boot sequencing.
+This is a one\-way transition.
+
+Packages installing init.d scripts should make sure both methods
+work.
+
+For legacy mode, the following section document the old behaviour.
+
 When run with either the
 .BR defaults ", " start ", or " stop
 options,
@@ -228,6 +245,9 @@
 Insert links using the defaults:
 .nf 
 .B "   update\-rc.d foobar defaults"
+The equvalent dependency header would have start and stop
+dependencies on $remote_fs and $syslog, and start in
+runlevels 2\-5 and stop in runlevels 0, 1 and 6.
 .fi 
 Equivalent command using explicit argument sets:
 .nf