# HG changeset patch
# User Bruno Haible <bruno@clisp.org>
# Date 1222610872 -7200
# Node ID d638c278c6d6d00e7ec76f405bab750666d3974e
# Parent  b7630b904ebdee7f69b3df79a80f3e24eae2db1d
Add comment about SIGPIPE.

diff -r b7630b904ebd -r d638c278c6d6 ChangeLog
--- a/ChangeLog	Sun Sep 28 16:04:07 2008 +0200
+++ b/ChangeLog	Sun Sep 28 16:07:52 2008 +0200
@@ -1,3 +1,8 @@
+2008-09-28  Bruno Haible  <bruno@clisp.org>
+
+	* lib/pipe.h (create_pipe_out, create_pipe_bidi): Add comment about
+	SIGPIPE.
+
 2008-09-28  Bruno Haible  <bruno@clisp.org>
 
 	* tests/test-sigaction.c (handler, main): Disable the check whether
diff -r b7630b904ebd -r d638c278c6d6 lib/pipe.h
--- a/lib/pipe.h	Sun Sep 28 16:04:07 2008 +0200
+++ b/lib/pipe.h	Sun Sep 28 16:07:52 2008 +0200
@@ -1,5 +1,5 @@
 /* Creation of subprocesses, communicating via pipes.
-   Copyright (C) 2001-2003, 2006 Free Software Foundation, Inc.
+   Copyright (C) 2001-2003, 2006, 2008 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
@@ -78,6 +78,8 @@
  *           write       system                read
  *    parent  ->   fd[0]   ->   STDIN_FILENO    ->   child
  *
+ * Note: When writing to a child process, it is useful to ignore the SIGPIPE
+ * signal and the EPIPE error code.
  */
 extern pid_t create_pipe_out (const char *progname,
 			      const char *prog_path, char **prog_argv,
@@ -105,6 +107,8 @@
  *    parent  <-   fd[0]   <-   STDOUT_FILENO   <-   child
  *           read        system                write
  *
+ * Note: When writing to a child process, it is useful to ignore the SIGPIPE
+ * signal and the EPIPE error code.
  */
 extern pid_t create_pipe_bidi (const char *progname,
 			       const char *prog_path, char **prog_argv,