pythongh-119287: clarify doc on BaseExceptionGroup.derive and link to…

… it from contextlib.suppress
iritkatriel · May 28, 2024 · dbcbdee · dbcbdee
1 parent b407ad3
commit dbcbdee
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 2 deletions.
diff --git a/Doc/library/contextlib.rst b/Doc/library/contextlib.rst
@@ -314,7 +314,8 @@ Functions and classes provided:
 
    If the code within the :keyword:`!with` block raises a
    :exc:`BaseExceptionGroup`, suppressed exceptions are removed from the
-   group.  If any exceptions in the group are not suppressed, a group containing them is re-raised.
+   group.  If any exceptions in the group are not suppressed, a group containing them
+   is re-raised (see also :meth:`~BaseExceptionGroup.derive`).
 
    .. versionadded:: 3.4
 

diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst
@@ -989,7 +989,8 @@ their subgroups based on the types of the contained exceptions.
       Returns an exception group with the same :attr:`message`, but which
       wraps the exceptions in ``excs``.
 
-      This method is used by :meth:`subgroup` and :meth:`split`. A
+      This method is used by :meth:`subgroup` and :meth:`split`, which
+      are used in various contexts to break up an exception group. A
       subclass needs to override it in order to make :meth:`subgroup`
       and :meth:`split` return instances of the subclass rather
       than :exc:`ExceptionGroup`.