Clarify specification of wait_subprocess.

diff --git a/ChangeLog b/ChangeLog
index c5b7d00..276a9f4 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2009-02-28  Bruno Haible  <bruno@clisp.org>
 
+       * lib/wait-process.h (wait_subprocess): Clarify restriction regarding
+       SIGCHLD.
+       Reported by Jim Meyering.
+
+2009-02-28  Bruno Haible  <bruno@clisp.org>
+
        * m4/printf.m4 (gl_PRINTF_DIRECTIVE_LS): Separate the two first tests.
        Mention the results of these tests on various platforms.
        * doc/posix-functions/fprintf.texi: Mention platforms in canonical

diff --git a/lib/wait-process.h b/lib/wait-process.h
index 3d7a4cf..b064c28 100644 (file)
--- a/lib/wait-process.h
+++ b/lib/wait-process.h
@@ -1,5 +1,5 @@
 /* Waiting for a subprocess to finish.
-   Copyright (C) 2001-2003, 2006, 2008 Free Software Foundation, Inc.
+   Copyright (C) 2001-2003, 2006, 2008-2009 Free Software Foundation, Inc.
    Written by Bruno Haible <haible@clisp.cons.org>, 2001.
 
    This program is free software: you can redistribute it and/or modify
@@ -50,7 +50,9 @@ extern "C" {
      with an error status.
    - If termsigp is not NULL, *termsig will be set to the signal that
      terminated the subprocess (if supported by the platform: not on native
-     Windows platforms), otherwise 0.  */
+     Windows platforms), otherwise 0.
+   Prerequisites: The signal handler for SIGCHLD should not be set to SIG_IGN,
+   otherwise this function will not work.  */
 extern int wait_subprocess (pid_t child, const char *progname,
                            bool ignore_sigpipe, bool null_stderr,
                            bool slave_process, bool exit_on_error,