locks,queues: Add versionchanged docs for #3621

tornado/locks.py

@@ -119,6 +119,10 @@ def wait(
 
         Returns a `.Future` that resolves ``True`` if the condition is notified,
         or ``False`` after a timeout.
+
+        .. versionchanged:: 6.6
+           A ``timeout`` argument of zero will either return or raise immediately.
+           Previously, zero was treated equivalent to ``None`` (wait forever).
         """
         waiter: Future[bool] = Future()
         self._waiters.append(waiter)
@@ -231,6 +235,10 @@ def wait(
 
         Returns an awaitable, which raises `tornado.util.TimeoutError` after a
         timeout.
+
+        .. versionchanged:: 6.6
+           A ``timeout`` argument of zero will either return or raise immediately.
+           Previously, zero was treated equivalent to ``None`` (wait forever).
         """
         fut: Future[None] = Future()
         if self._value:
@@ -414,6 +422,10 @@ def acquire(
 
         Block if the counter is zero and wait for a `.release`. The awaitable
         raises `.TimeoutError` after the deadline.
+
+        .. versionchanged:: 6.6
+           A ``timeout`` argument of zero will either return or raise immediately.
+           Previously, zero was treated equivalent to ``None`` (wait forever).
         """
         waiter: Future[_ReleasingContextManager] = Future()
         if self._value > 0:
@@ -528,6 +540,10 @@ def acquire(
 
         Returns an awaitable, which raises `tornado.util.TimeoutError` after a
         timeout.
+
+        .. versionchanged:: 6.6
+           A ``timeout`` argument of zero will either return or raise immediately.
+           Previously, zero was treated equivalent to ``None`` (wait forever).
         """
         return self._block.acquire(timeout)
 

tornado/queues.py

@@ -193,6 +193,10 @@ def put(
         scale as `tornado.ioloop.IOLoop.time`, normally `time.time`), or a
         `datetime.timedelta` object for a deadline relative to the
         current time.
+
+        .. versionchanged:: 6.6
+           A ``timeout`` argument of zero will either return or raise immediately.
+           Previously, zero was treated equivalent to ``None`` (wait forever).
         """
         future: Future[None] = Future()
         try:
@@ -240,6 +244,9 @@ def get(self, timeout: float | datetime.timedelta | None = None) -> Awaitable[_T
            ``timedelta`` objects for relative timeouts (consistent
            with other timeouts in Tornado).
 
+        .. versionchanged:: 6.6
+           A ``timeout`` argument of zero will either return or raise immediately.
+           Previously, zero was treated equivalent to ``None`` (wait forever).
         """
         future: Future[_T] = Future()
         try:
@@ -292,6 +299,10 @@ def join(
 
         Returns an awaitable, which raises `tornado.util.TimeoutError` after a
         timeout.
+
+        .. versionchanged:: 6.6
+           A ``timeout`` argument of zero will either return or raise immediately.
+           Previously, zero was treated equivalent to ``None`` (wait forever).
         """
         return self._finished.wait(timeout)