[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[SCM] Debian package checker branch, master, updated. 2.5.11-133-gcc029ec



The following commit has been merged in the master branch:
commit cc029ece10b07a42416265e1abcf5bd8c30c656a
Author: Niels Thykier <niels@thykier.net>
Date:   Tue Jan 29 18:58:43 2013 +0100

    L::C::Simple: Doc changes missing in the last commit
    
    Signed-off-by: Niels Thykier <niels@thykier.net>

diff --git a/lib/Lintian/Command/Simple.pm b/lib/Lintian/Command/Simple.pm
index fad2f6d..5c54787 100644
--- a/lib/Lintian/Command/Simple.pm
+++ b/lib/Lintian/Command/Simple.pm
@@ -167,14 +167,14 @@ The return value in scalar context is value associated with the pid of
 the reaped processed.  In list context, the pid and value are returned
 as a pair.
 
-Whenever waitpid() would return -1, wait() returns undef or a null
+Whenever waitpid() would return -1, wait_any() returns undef or a null
 value so that it is safe to:
 
-    while($cmd = Lintian::Command::Simple::wait(\%hash)) { something; }
+    while($cmd = wait_any(\%hash)) { something; }
 
 The same is true whenever the hash reference points to an empty hash.
 
-If C<nohang> is also given, wait will attempt to reap any child
+If C<nohang> is also given, wait_any will attempt to reap any child
 process non-blockingly.  If no child can be reaped, it will
 immediately return (like there were no more processes left) instead of
 waiting.
@@ -258,17 +258,8 @@ provided by this package itself.
 
 =head1 CAVEATS
 
-Combining asynchronous jobs from Lintian::Command and calls to wait()
-can lead to unexpected results.
-
-Calling wait() without a pid via the procedural interface can lead to
-processes started via the OO interface to be reaped. In this case, the
-object that started the reaped process won't be able to determine the
-return status, which can affect the rest of the application.
-
-As a general advise, the procedural and OO interfaces should not be
-combined when using background(). Unless, of course, you are calling wait()
-with a hash ref.
+Combining asynchronous jobs (e.g. via Lintian::Command) and calls to
+wait_any() can lead to unexpected results.
 
 =head1 AUTHOR
 

-- 
Debian package checker


Reply to: