diff options
author | Ludovic Courtès <ludo@gnu.org> | 2014-11-20 21:32:44 +0100 |
---|---|---|
committer | Ludovic Courtès <ludo@gnu.org> | 2014-11-20 21:32:44 +0100 |
commit | d1447c717bd90f00b53da87b8b9a80d5fcb41f39 (patch) | |
tree | 5c81f26f277b36cd9e563c185f3d2d2e1e55d8ad /libguile/filesys.c | |
parent | 136c3a4c4a42f72331f5d18c592ef003bf894178 (diff) | |
download | guile-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.c | 9 |
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" |