diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst index e4343e87fad..91ab0854b57 100644 --- a/Doc/library/warnings.rst +++ b/Doc/library/warnings.rst @@ -381,6 +381,14 @@ Available Context Managers protected. This argument exists primarily for testing the :mod:`warnings` module itself. + .. note:: + + The :class:`catch_warnings` manager works by replacing and + then later restoring the module's + :func:`showwarning` function and internal list of filter + specifications. This means the context manager is modifying + global state and therefore is not thread-safe. + .. note:: In Python 3.0, the arguments to the constructor for