Bug#211856: documentation update for start-stop-daemon

[dean gaudet <dean-debian@arctic.org>]

Package: dpkg
Version: 1.10.13

please consider applying the following documentation patch.  it may help
avoid bugs such as 211849 i just reported in the cron package.

-dean

--- dpkg-1.10.13/utils/start-stop-daemon.8.orig	2003-09-13 18:49:08.000000000 -0700
+++ dpkg-1.10.13/utils/start-stop-daemon.8	2003-09-20 11:00:02.000000000 -0700
@@ -64,6 +64,25 @@
 .BR --oknodo
 is specified).

+Note that unless
+.BR --pidfile ,
+is specified, then
+.B start\-stop\-daemon
+behaves similarly to
+.B killall(1).
+.B start\-stop\-daemon
+will scan the process table looking for any processes which
+match the process name, uid, and/or gid (if specified).  Any
+matching process will prevent
+.BR --start
+from starting the daemon.  All matching processes will be
+sent the KILL signal if
+.BR --stop
+is specified.  For daemons which have long-lived children
+which need to live through a
+.BR --stop
+you must specify a pidfile.
+
 .SH OPTIONS

 .TP