summaryrefslogtreecommitdiff
path: root/libguile/filesys.c
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2014-11-20 21:32:44 +0100
committerLudovic Courtès <ludo@gnu.org>2014-11-20 21:32:44 +0100
commitd1447c717bd90f00b53da87b8b9a80d5fcb41f39 (patch)
tree5c81f26f277b36cd9e563c185f3d2d2e1e55d8ad /libguile/filesys.c
parent136c3a4c4a42f72331f5d18c592ef003bf894178 (diff)
downloadguile-d1447c717bd90f00b53da87b8b9a80d5fcb41f39.tar.gz
doc: Clarify behavior of 'select' in the presence of signal interruptions.
Fixes <http://bugs.gnu.org/18988>. Reported by Chris Vine <chris@cvine.freeserve.co.uk>. * libguile/filesys.c (scm_select): Clarify handling of signal interruptions. * doc/ref/posix.texi (Ports and File Descriptors): Adjust accordingly.
Diffstat (limited to 'libguile/filesys.c')
-rw-r--r--libguile/filesys.c9
1 files changed, 7 insertions, 2 deletions
diff --git a/libguile/filesys.c b/libguile/filesys.c
index 301040a7d..b473af811 100644
--- a/libguile/filesys.c
+++ b/libguile/filesys.c
@@ -771,8 +771,13 @@ SCM_DEFINE (scm_select, "select", 3, 2, 0,
"This procedure has a variety of uses: waiting for the ability\n"
"to provide input, accept output, or the existence of\n"
"exceptional conditions on a collection of ports or file\n"
- "descriptors, or waiting for a timeout to occur.\n"
- "It also returns if interrupted by a signal.\n\n"
+ "descriptors, or waiting for a timeout to occur.\n\n"
+
+ "When an error occurs, of if it is interrupted by a signal, this\n"
+ "procedure throws a @code{system-error} exception\n"
+ "(@pxref{Conventions, @code{system-error}}). In case of an\n"
+ "interruption, the associated error number is @var{EINTR}.\n\n"
+
"@var{reads}, @var{writes} and @var{excepts} can be lists or\n"
"vectors, with each member a port or a file descriptor.\n"
"The value returned is a list of three corresponding\n"