[3.13] gh-132354: document return value for asyncio.Task.cancel (GH-132374) (#132465)

miss-islington · felixscherz · web-flow · commit ff66901d8a87 · 2025-04-13T07:41:26.000Z
gh-132354: document return value for `asyncio.Task.cancel` (GH-132374) (cherry picked from commit 64b066a) Co-authored-by: Felix Scherz <felixwscherz@gmail.com>
diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
@@ -1336,7 +1336,10 @@ Task Object
 
       Request the Task to be cancelled.
 
-      This arranges for a :exc:`CancelledError` exception to be thrown
+      If the Task is already *done* or *cancelled*, return ``False``,
+      otherwise, return ``True``.
+
+      The method arranges for a :exc:`CancelledError` exception to be thrown
       into the wrapped coroutine on the next cycle of the event loop.
 
       The coroutine then has a chance to clean up or even deny the
diff --git a/Misc/ACKS b/Misc/ACKS
@@ -1644,6 +1644,7 @@ Andreas Schawo
 Neil Schemenauer
 David Scherer
 Wolfgang Scherer
+Felix Scherz
 Hynek Schlawack
 Bob Schmertz
 Gregor Schmid
