Clarify that put *blocks* when the queue is full. Add some blank

lines to doc strings.

diff --git a/Lib/Queue.py b/Lib/Queue.py
index 6710153d2003c633cd70717145213004eadc89f4..843b9dca197ef6abe915ec5ec9e0430f738ed685 100644 (file)
--- a/Lib/Queue.py
+++ b/Lib/Queue.py
@@ -44,7 +44,10 @@ class Queue:
         return n
 
     def put(self, item):
-        """Put an item into the queue."""
+        """Put an item into the queue.
+
+       If the queue is full, block until a free slot is avaiable.
+       """
         self.fsema.acquire_lock()
         self.mutex.acquire_lock()
         was_empty = self._empty()
@@ -57,6 +60,7 @@ class Queue:
 
     def get(self):
         """Gets and returns an item from the queue.
+
         This method blocks if necessary until an item is available.
         """
         self.esema.acquire_lock()
@@ -74,6 +78,7 @@ class Queue:
     # raise Empty if the queue is empty or temporarily unavailable
     def get_nowait(self):
         """Gets and returns an item from the queue.
+
         Only gets an item if one is immediately available, Otherwise
         this raises the Empty exception if the queue is empty or
         temporarily unavailable.