From: Rafael Garcia-Suarez <rgarciasuarez@gmail.com>
Date: Wed, 1 Feb 2006 18:07:26 +0000 (+0000)
Subject: Improve a bit the documentation for kill() with SIGNAL==0
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=70fb64f63d6cf0a6c7ededf95d88e9321d4efe68;p=p5sagit%2Fp5-mst-13.2.git

Improve a bit the documentation for kill() with SIGNAL==0

p4raw-id: //depot/perl@27039
---

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index c75d580..67d8b05 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -2593,10 +2593,12 @@ same as the number actually killed).
     $cnt = kill 1, $child1, $child2;
     kill 9, @goners;
 
-If SIGNAL is zero, no signal is sent to the process.  This is a
-useful way to check that a child process is alive and hasn't changed
-its UID.  See L<perlport> for notes on the portability of this
-construct.
+If SIGNAL is zero, no signal is sent to the process, but the kill(2)
+system call will check whether it's possible so send a signal to it (that
+means, to be brief, that the process is owned by the same user, or we are
+the super-user).  This is a useful way to check that a child process is
+alive and hasn't changed its UID.  See L<perlport> for notes on the
+portability of this construct.
 
 Unlike in the shell, if SIGNAL is negative, it kills
 process groups instead of processes.  (On System V, a negative I<PROCESS>