bpo-27618: Clarify that threading.Lock is a factory function (GH-1307) (GH-1894)

(cherry picked from commit 56ddfd2eea4d98456a9a99bf2a718f21ee6b2be2)

diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst
index 2792dfdce04c6c035f4a87e0f2283c73ade4e1cb..cda859fe4cbd3a09579610b66735b20dd4f3e464 100644 (file)
--- a/Doc/library/threading.rst
+++ b/Doc/library/threading.rst
@@ -371,8 +371,9 @@ All methods are executed atomically.
    lock, subsequent attempts to acquire it block, until it is released; any
    thread may release it.
 
-   .. versionchanged:: 3.3
-      Changed from a factory function to a class.
+   Note that ``Lock`` is actually a factory function which returns an instance
+   of the most efficient version of the concrete Lock class that is supported
+   by the platform.
 
 
    .. method:: acquire(blocking=True, timeout=-1)