gh-108951: Whatsnew and doc tweaks for TaskGroup.cancel()

Doc/library/asyncio-task.rst

@@ -394,8 +394,8 @@ Example::
 The ``async with`` statement will wait for all tasks in the group to finish.
 While waiting, new tasks may still be added to the group
 (for example, by passing ``tg`` into one of the coroutines
-and calling ``tg.create_task()`` in that coroutine).  There is also opportunity
-to short-circuit the entire task group with ``tg.cancel()``, based on some condition.
+and calling ``tg.create_task()`` in that coroutine).  There is also opportunity to
+request termination of the entire task group with ``tg.cancel()``, based on some condition.
 Once the last task has finished and the ``async with`` block is exited,
 no new tasks may be added to the group.
 

Doc/whatsnew/3.15.rst

@@ -717,6 +717,14 @@ ast
   This can be :ref:`controlled using environment variables <using-on-controlling-color>`.
   (Contributed by Stan Ulbrych in :gh:`148981`.)
 
+asyncio
+-------
+
+* Added :meth:`~asyncio.TaskGroup.cancel` to allow early termination of a task group --
+  e.g. when the goal of the tasks has been achieved or their services no longer needed.
+  Previously this would involve unintuitive boilerplate such as an extra task raising
+  a custom exception which is then suppressed as it exits TaskGroup.
+  (Contributed by John Belmonte in :gh:`127214`.)
 
 base64
 ------

Misc/NEWS.d/next/Library/2024-11-24-07-18-40.gh-issue-108951.jyKygP.rst

@@ -1 +1 @@
-Add :meth:`~asyncio.TaskGroup.cancel` which cancels unfinished tasks and exits the group without error.
+Add :meth:`~asyncio.TaskGroup.cancel` which cancels unfinished tasks and exits the group without raising :exc:`asyncio.CancelledError`.