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

gvanrossum · gvanrossum · commit c09e6b1c0ab8 · 1998-04-09T14:25:32.000Z
lines to doc strings.
diff --git a/Lib/Queue.py b/Lib/Queue.py
@@ -44,7 +44,10 @@ def full(self):
         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 @@ def put(self, item):
 
     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 @@ def get(self):
     # 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.
