From: Raymond Hettinger <python@rcn.com>
Date: Fri, 6 Mar 2009 23:28:53 +0000 (+0000)
Subject: Document the suggested alternative to emtpy() and full().
X-Git-Tag: 3.0~336
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f9ffe0465871dd93708d6e122fc7f9013fd0584d;p=thirdparty%2FPython%2Fcpython.git

Document the suggested alternative to emtpy() and full().
---

diff --git a/Lib/queue.py b/Lib/queue.py
index 773b680d8c6a..7cb297c9167e 100644
--- a/Lib/queue.py
+++ b/Lib/queue.py
@@ -91,14 +91,22 @@ class Queue:
         return n
 
     def empty(self):
-        """Return True if the queue is empty, False otherwise (not reliable!)."""
+        """Return True if the queue is empty, False otherwise (not reliable!).
+
+        This method is likely to be removed at some point.  Use qsize() instead.
+
+        """
         self.mutex.acquire()
         n = not self._qsize()
         self.mutex.release()
         return n
 
     def full(self):
-        """Return True if the queue is full, False otherwise (not reliable!)."""
+        """Return True if the queue is full, False otherwise (not reliable!).
+
+        This method is likely to be removed at some point.  Use qsize() instead.
+
+        """
         self.mutex.acquire()
         n = 0 < self.maxsize == self._qsize()
         self.mutex.release()