pthread_sigmask: Work around Cygwin bug.

[pspp] / doc / posix-functions / read.texi

diff --git a/doc/posix-functions/read.texi b/doc/posix-functions/read.texi
index e78764da3ce045c64224acd0b42df177b1b18411..2b5aeb2e44dbd9f49e6463f6546400b8142311e2 100644 (file)
--- a/doc/posix-functions/read.texi
+++ b/doc/posix-functions/read.texi
@@ -2,14 +2,26 @@
 @section @code{read}
 @findex read
 
-POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/read.html}
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/read.html}
 
-Gnulib module: ---
+Gnulib module: stdio, nonblocking
 
-Portability problems fixed by Gnulib:
+Portability problems fixed by Gnulib module @code{stdio}, together with module @code{nonblocking}:
 @itemize
+@item
+When reading from a non-blocking pipe whose buffer is empty, this function
+fails with @code{errno} being set to @code{EINVAL} instead of @code{EAGAIN} on
+some platforms:
+mingw.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function may fail with error @code{EINTR}, even in programs that don't
+install any signal handlers, on some platforms:
+MacOS X 10.5.
 @end itemize
+
+For handling @code{EINTR}, Gnulib provides a module @samp{safe-read} with a
+function @code{safe_read}.