From b52e7a9a364096d355d32927c537389cfc10a5db Mon Sep 17 00:00:00 2001 From: Sandro Tosi Date: Sat, 7 Jan 2012 17:56:58 +0100 Subject: [PATCH] clarify recv* are blocking operations; thanks to Chris Kogelnik from docs@ --- Doc/library/multiprocessing.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index 1ae7419871a..3d83114f7a2 100644 --- a/Doc/library/multiprocessing.rst +++ b/Doc/library/multiprocessing.rst @@ -727,7 +727,8 @@ Connection objects are usually created using :func:`Pipe` -- see also .. method:: recv() Return an object sent from the other end of the connection using - :meth:`send`. Raises :exc:`EOFError` if there is nothing left to receive + :meth:`send`. Blocks until there its something to receive. Raises + :exc:`EOFError` if there is nothing left to receive and the other end was closed. .. method:: fileno() @@ -761,7 +762,8 @@ Connection objects are usually created using :func:`Pipe` -- see also .. method:: recv_bytes([maxlength]) Return a complete message of byte data sent from the other end of the - connection as a string. Raises :exc:`EOFError` if there is nothing left + connection as a string. Blocks until there is something to receive. + Raises :exc:`EOFError` if there is nothing left to receive and the other end has closed. If *maxlength* is specified and the message is longer than *maxlength* @@ -771,7 +773,8 @@ Connection objects are usually created using :func:`Pipe` -- see also .. method:: recv_bytes_into(buffer[, offset]) Read into *buffer* a complete message of byte data sent from the other end - of the connection and return the number of bytes in the message. Raises + of the connection and return the number of bytes in the message. Blocks + until there is something to receive. Raises :exc:`EOFError` if there is nothing left to receive and the other end was closed.