bpo-44693: Update __future__ entry in Doc/glossary.rst (GH-27349) (GH-27357)

miss-islington · StevenHsuYL · web-flow · commit 642d873d672e · 2021-07-25T21:40:08.000-04:00
Replace sentence with confusing "pseudo-module" with two sentences separating future statements and the __future__ module. Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> (cherry picked from commit 0363a40) Co-authored-by: Steven Hsu <hsuhaochun@gmail.com> Co-authored-by: Steven Hsu <hsuhaochun@gmail.com>
diff --git a/Doc/glossary.rst b/Doc/glossary.rst
@@ -461,12 +461,13 @@ Glossary
       for best practices on working with annotations.
 
    __future__
-      A pseudo-module which programmers can use to enable new language features
-      which are not compatible with the current interpreter.
-
-      By importing the :mod:`__future__` module and evaluating its variables,
-      you can see when a new feature was first added to the language and when it
-      becomes the default::
+      A :ref:`future statement <future>`, ``from __future__ import <feature>``,
+      directs the compiler to compile the current module using syntax or
+      semantics that will become standard in a future release of Python.
+      The :mod:`__future__` module documents the possible values of
+      *feature*.  By importing this module and evaluating its variables,
+      you can see when a new feature was first added to the language and
+      when it will (or did) become the default::
 
          >>> import __future__
          >>> __future__.division
diff --git a/Misc/NEWS.d/next/Documentation/2021-07-25-23-04-15.bpo-44693.JuCbNq.rst b/Misc/NEWS.d/next/Documentation/2021-07-25-23-04-15.bpo-44693.JuCbNq.rst
@@ -0,0 +1,2 @@
+Update the definition of __future__ in the glossary by replacing the confusing
+word "pseudo-module" with a more accurate description.

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+Update the definition of __future__ in the glossary by replacing the confusing`
	`2`	`+word "pseudo-module" with a more accurate description.`