diff --git a/doc/zmq_msg_recv.txt b/doc/zmq_msg_recv.txt
index 2f8b2a5c..436011f8 100644
--- a/doc/zmq_msg_recv.txt
+++ b/doc/zmq_msg_recv.txt
@@ -54,7 +54,10 @@ values defined below.
 ERRORS
 ------
 *EAGAIN*::
-Non-blocking mode was requested and no messages are available at the moment.
+Either the timeout set via the socket-option ZMQ_RCVTIMEO (see linkzmq:zmq_setsockopt[3])
+has been reached (flag ZMQ_DONTWAIT not set) without being able to read a message
+from the socket or there are no messages available at the moment (flag ZMQ_DONTWAIT set)
+and the operation would block.
 *ENOTSUP*::
 The _zmq_msg_recv()_ operation is not supported by this socket type.
 *EFSM*::
@@ -114,6 +117,7 @@ linkzmq:zmq_recv[3]
 linkzmq:zmq_send[3]
 linkzmq:zmq_msg_send[3]
 linkzmq:zmq_getsockopt[3]
+linkzmq:zmq_setsockopt[3]
 linkzmq:zmq_socket[7]
 linkzmq:zmq[7]
 
diff --git a/doc/zmq_recv.txt b/doc/zmq_recv.txt
index 5813e1d4..03468c1c 100644
--- a/doc/zmq_recv.txt
+++ b/doc/zmq_recv.txt
@@ -50,7 +50,10 @@ in case the message was truncated. If not successful the function shall return
 ERRORS
 ------
 *EAGAIN*::
-Non-blocking mode was requested and no messages are available at the moment.
+Either the timeout set via the socket-option ZMQ_RCVTIMEO (see linkzmq:zmq_setsockopt[3])
+has been reached (flag ZMQ_DONTWAIT not set) without being able to read a message
+from the socket or there are no messages available at the moment (flag ZMQ_DONTWAIT set)
+and the operation would block.
 *ENOTSUP*::
 The _zmq_recv()_ operation is not supported by this socket type.
 *EFSM*::
@@ -81,6 +84,7 @@ SEE ALSO
 --------
 linkzmq:zmq_send[3]
 linkzmq:zmq_getsockopt[3]
+linkzmq:zmq_setsockopt[3]
 linkzmq:zmq_socket[7]
 linkzmq:zmq[7]
 
diff --git a/doc/zmq_recvmsg.txt b/doc/zmq_recvmsg.txt
index 9024f771..adf2d4a9 100644
--- a/doc/zmq_recvmsg.txt
+++ b/doc/zmq_recvmsg.txt
@@ -52,7 +52,10 @@ values defined below.
 ERRORS
 ------
 *EAGAIN*::
-Non-blocking mode was requested and no messages are available at the moment.
+Either the timeout set via the socket-option ZMQ_RCVTIMEO (see linkzmq:zmq_setsockopt[3])
+has been reached (flag ZMQ_DONTWAIT not set) without being able to read a message
+from the socket or there are no messages available at the moment (flag ZMQ_DONTWAIT set)
+and the operation would block.
 *ENOTSUP*::
 The _zmq_recvmsg()_ operation is not supported by this socket type.
 *EFSM*::
@@ -111,6 +114,7 @@ SEE ALSO
 linkzmq:zmq_recv[3]
 linkzmq:zmq_send[3]
 linkzmq:zmq_getsockopt[3]
+linkzmq:zmq_setsockopt[3]
 linkzmq:zmq_socket[7]
 linkzmq:zmq[7]