summaryrefslogtreecommitdiffstats
path: root/Doc/c-api/contextvars.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/c-api/contextvars.rst')
-rw-r--r--Doc/c-api/contextvars.rst14
1 files changed, 10 insertions, 4 deletions
diff --git a/Doc/c-api/contextvars.rst b/Doc/c-api/contextvars.rst
index b7c6550..8eba54a 100644
--- a/Doc/c-api/contextvars.rst
+++ b/Doc/c-api/contextvars.rst
@@ -123,10 +123,16 @@ Context object management functions:
Enumeration of possible context object watcher events:
- - ``Py_CONTEXT_SWITCHED``: The :term:`current context` has switched to a
- different context. The object passed to the watch callback is the
- now-current :class:`contextvars.Context` object, or None if no context is
- current.
+ - ``Py_CONTEXT_EVENT_ENTER``: A context has been entered, causing the
+ :term:`current context` to switch to it. The object passed to the watch
+ callback is the now-current :class:`contextvars.Context` object. Each
+ enter event will eventually have a corresponding exit event for the same
+ context object after any subsequently entered contexts have themselves been
+ exited.
+ - ``Py_CONTEXT_EVENT_EXIT``: A context is about to be exited, which will
+ cause the :term:`current context` to switch back to what it was before the
+ context was entered. The object passed to the watch callback is the
+ still-current :class:`contextvars.Context` object.
.. versionadded:: 3.14