Patch is for perl5.005_03.
The remarks about Win32 are second-hand, and need checking by someone
--- ./pod/perlport.pod.orig Fri Feb 12 00:06:09 1999 +++ ./pod/perlport.pod Wed Oct 13 04:09:31 1999 @@ -1321,13 +1321,15 @@ Available only for socket handles. (S<RISC OS>) -=item kill LIST +=item kill SIGNAL, LIST Not implemented, hence not useful for taint checking. (S<Mac OS>, S<RISC OS>) Available only for process handles returned by the C<system(1, ...)> method of spawning a process. (Win32) + +C<kill 0, ...> kills the process. (Win32) =item link OLDFILE,NEWFILE --- ./README.win32.orig Sun Mar 28 23:36:42 1999 +++ ./README.win32 Wed Oct 13 04:02:45 1999 @@ -697,7 +697,8 @@ C<raise()>, i.e. it doesn't send a signal to the identified process like it does on Unix platforms. Instead it immediately calls C<TerminateProcess(process,signal)>. Thus the signal argument is -used to set the exit-status of the terminated process. This behavior +used to set the exit-status of the terminated process. In particular, +unlike on Unix, C<kill 0, ...> will kill the process. This behavior may change in future. =item * --- ./pod/perlfunc.pod.orig Wed Oct 13 03:58:52 1999 +++ ./pod/perlfunc.pod Wed Oct 13 03:54:14 1999 @@ -2066,20 +2066,22 @@ See also C<each()>, C<values()> and C<sort()>. -=item kill LIST +=item kill SIGNAL, LIST -Sends a signal to a list of processes. The first element of -the list must be the signal to send. Returns the number of -processes successfully signaled. +Sends a signal to a list of processes. Returns the number of processes +successfully signaled. $cnt = kill 1, $child1, $child2; kill 9, @goners; -Unlike in the shell, in Perl if the I<SIGNAL> is negative, it kills -process groups instead of processes. (On System V, a negative I<PROCESS> +Unlike in the shell, in Perl if the SIGNAL is negative, it kills +process groups instead of processes. (On System V, a negative PROCESS number will also kill process groups, but that's not portable.) That means you usually want to use positive not negative signals. You may also use a signal name in quotes. See L<perlipc/"Signals"> for details. + +If the SIGNAL is zero, no signal is sent to the process; it just checks +that the process is alive and hasn't changed its UID. =item last LABEL End of patch