Clarify specification of wait_subprocess.

diff --git a/ChangeLog b/ChangeLog
index c5b7d00bbf6e9d0f535470639cfee62a21e62913..276a9f439a7ab2523a329250a22cadf7d9a06e6d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+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.

diff --git a/lib/wait-process.h b/lib/wait-process.h
index 3d7a4cf39787ee79eb02fd2fa16c89faff089841..b064c2819809bba08ee717ebd321b2e169f5a924 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,