2004-07-12 Roland McGrath <roland@redhat.com>
authorroland <roland>
Mon, 12 Jul 2004 21:44:33 +0000 (21:44 +0000)
committerroland <roland>
Mon, 12 Jul 2004 21:44:33 +0000 (21:44 +0000)
* manual/signal.texi (Interrupted Primitives): Make clear that
TEMP_FAILURE_RETRY evaluates its expression as long int and compares
it to -1 to define "failure".

manual/signal.texi

index 2c06c6c..1d28f74 100644 (file)
@@ -2083,9 +2083,12 @@ temporary failure, with the macro @code{TEMP_FAILURE_RETRY}:
 @comment unistd.h
 @comment GNU
 @defmac TEMP_FAILURE_RETRY (@var{expression})
-This macro evaluates @var{expression} once.  If it fails and reports
-error code @code{EINTR}, @code{TEMP_FAILURE_RETRY} evaluates it again,
-and over and over until the result is not a temporary failure.
+This macro evaluates @var{expression} once, and examines its value as
+type @code{long int}.  If the value equals @code{-1}, that indicates a
+failure and @code{errno} should be set to show what kind of failure.
+If it fails and reports error code @code{EINTR},
+@code{TEMP_FAILURE_RETRY} evaluates it again, and over and over until
+the result is not a temporary failure.
 
 The value returned by @code{TEMP_FAILURE_RETRY} is whatever value
 @var{expression} produced.