From: Vinodhini Balusamy <me.vinob@gmail.com>
Date: Tue, 14 May 2019 12:11:41 +0000 (+1000)
Subject: bpo-32995 - Added context variable in glossary (GH-9741)
X-Git-Tag: v3.8.0b1~371
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=c0a1a07c7e9814cad79cce3580c16284b2df7f52;p=thirdparty%2FPython%2Fcpython.git

bpo-32995 - Added context variable in glossary (GH-9741)
---

diff --git a/Doc/glossary.rst b/Doc/glossary.rst
index 9c64e4886319..d3ce36525519 100644
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -225,6 +225,15 @@ Glossary
       statement by defining :meth:`__enter__` and :meth:`__exit__` methods.
       See :pep:`343`.
 
+    context variable
+      A variable which can have different values depending on its context.
+      This is similar to Thread-Local Storage in which each execution
+      thread may have a different value for a variable. However, with context
+      variables, there may be several contexts in one execution thread and the
+      main usage for context variables is to keep track of variables in
+      concurrent asynchronous tasks.
+      See :mod:`contextvars`.
+
    contiguous
       .. index:: C-contiguous, Fortran contiguous
 
diff --git a/Misc/NEWS.d/next/Documentation/2018-10-07-03-04-57.bpo-32995.TXN9ur.rst b/Misc/NEWS.d/next/Documentation/2018-10-07-03-04-57.bpo-32995.TXN9ur.rst
new file mode 100644
index 000000000000..1df5eeaa965a
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2018-10-07-03-04-57.bpo-32995.TXN9ur.rst
@@ -0,0 +1 @@
+Added the context variable in glossary.