From 0363a4014d90df17a29042de008ef0b659f92505 Mon Sep 17 00:00:00 2001 From: Steven Hsu Date: Mon, 26 Jul 2021 09:11:12 +0800 Subject: bpo-44693: Update __future__ entry in Doc/glossary.rst (GH-27349) Replace sentence with confusing "pseudo-module" with two sentences separating future statements and the __future__ module. Co-authored-by: Terry Jan Reedy --- Doc/glossary.rst | 13 +++++++------ .../Documentation/2021-07-25-23-04-15.bpo-44693.JuCbNq.rst | 2 ++ 2 files changed, 9 insertions(+), 6 deletions(-) create mode 100644 Misc/NEWS.d/next/Documentation/2021-07-25-23-04-15.bpo-44693.JuCbNq.rst diff --git a/Doc/glossary.rst b/Doc/glossary.rst index ff3785b..1f14946 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -451,12 +451,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 `, ``from __future__ import ``, + 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 new file mode 100644 index 0000000..614abb4 --- /dev/null +++ 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. -- cgit v0.12