From a8b12fb7c895ab8b86373b91b452b50bc8f276e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Alex=20Gr=C3=B6nholm?= <alex.gronholm@nextday.fi>
Date: Wed, 30 Aug 2023 00:47:48 +0300
Subject: [PATCH] Fixed one bad link and some factual errors in the docs

---
 docs/tasks.rst | 34 +++++++++++++++++++++-------------
 1 file changed, 21 insertions(+), 13 deletions(-)

diff --git a/docs/tasks.rst b/docs/tasks.rst
index 3ad607ad..9e75957a 100644
--- a/docs/tasks.rst
+++ b/docs/tasks.rst
@@ -93,31 +93,38 @@ exception objects.
 To catch such exceptions potentially nested in groups, special measures are required.
 On Python 3.11 and later, you can use the ``except*`` syntax to catch multiple exceptions::
 
+    from anyio import create_task_group
+
     try:
-        async with TaskGroup() as tg:
+        async with create_task_group() as tg:
             tg.start_soon(some_task)
             tg.start_soon(another_task)
-    except* ValueError:
-        ...  # handle each ValueError
-    except* KeyError:
-        ...  # handle each KeyError
+    except* ValueError as excgroup:
+        for exc in excgroup:
+            ...  # handle each ValueError
+    except* KeyError as excgroup:
+        for exc in excgroup:
+            ...  # handle each KeyError
 
-If compatibility with older Python versions is required, you can use the ``catch()`` function from
-the exceptiongroup_ package::
+If compatibility with older Python versions is required, you can use the ``catch()``
+function from the exceptiongroup_ package::
 
+    from anyio import create_task_group
     from exceptiongroup import catch
 
-    def handle_valueerror(exc: ValueError) -> None:
-        ...  # handle each ValueError
+    def handle_valueerror(excgroup: ExceptionGroup) -> None:
+        for exc in excgroup.exceptions:
+            ...  # handle each ValueError
 
-    def handle_keyerror(exc: KeyError) -> None:
-        ...  # handle each KeyError
+    def handle_keyerror(excgroup: ExceptionGroup) -> None:
+        for exc in excgroup.exceptions:
+            ...  # handle each KeyError
 
     with catch({
         ValueError: handle_valueerror,
         KeyError: handle_keyerror
     }):
-        async with TaskGroup() as tg:
+        async with create_task_group() as tg:
             tg.start_soon(some_task)
             tg.start_soon(another_task)
 
@@ -144,9 +151,10 @@ Differences with asyncio.TaskGroup
 ----------------------------------
 
 The :class:`asyncio.TaskGroup` class, added in Python 3.11, is very similar in design to
-the AnyIO :class:`~TaskGroup` class. The asyncio counterpart has some important
+the AnyIO :class:`~.abc.TaskGroup` class. The asyncio counterpart has some important
 differences in its semantics, however:
 
+* The task group itself is instantiated directly, rather than using a factory function
 * Tasks are spawned solely through :meth:`~asyncio.TaskGroup.create_task`; there is no
   ``start()`` or ``start_soon()`` method
 * The :meth:`~asyncio.TaskGroup.create_task` method returns a task object which can be