From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sun, 30 Nov 2025 12:19:30 +0000 (+0100)
Subject: [3.14] gh-132795: Add docs for `multiprocessing.Semaphore.locked` (GH-133299) (#142111)
X-Git-Tag: v3.14.1~22
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=1011c0c38f920d2a6d0625416fa4b5388208644b;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-132795: Add docs for `multiprocessing.Semaphore.locked` (GH-133299) (#142111)

Co-authored-by: Duprat <yduprat@gmail.com>
---

diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
index 0d46a5dfc746..714207cb0aef 100644
--- a/Doc/library/multiprocessing.rst
+++ b/Doc/library/multiprocessing.rst
@@ -1419,6 +1419,12 @@ object -- see :ref:`multiprocessing-managers`.
    A solitary difference from its close analog exists: its ``acquire`` method's
    first argument is named *block*, as is consistent with :meth:`Lock.acquire`.
 
+   .. method:: locked()
+
+      Return a boolean indicating whether this object is locked right now.
+
+      .. versionadded:: 3.14
+
    .. note::
       On macOS, this is indistinguishable from :class:`Semaphore` because
       ``sem_getvalue()`` is not implemented on that platform.
@@ -1571,6 +1577,12 @@ object -- see :ref:`multiprocessing-managers`.
    A solitary difference from its close analog exists: its ``acquire`` method's
    first argument is named *block*, as is consistent with :meth:`Lock.acquire`.
 
+   .. method:: locked()
+
+      Return a boolean indicating whether this object is locked right now.
+
+      .. versionadded:: 3.14
+
 .. note::
 
    On macOS, ``sem_timedwait`` is unsupported, so calling ``acquire()`` with