From ad893844ead0e88bea4bfa7dd458884ea3632635 Mon Sep 17 00:00:00 2001 From: Steven Hsu <81967953+StevenHsuYL@users.noreply.github.com> Date: Mon, 26 Jul 2021 00:59:01 +0800 Subject: [PATCH 1/3] bpo-44693: Doc/glossary.rst Update definition of the __future__ in the glossary. --- Doc/glossary.rst | 6 ++++-- .../Documentation/2021-07-25-23-04-15.bpo-44693.JuCbNq.rst | 2 ++ 2 files changed, 6 insertions(+), 2 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 ff3785b2cac72d..00559fbcdb55c8 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -451,8 +451,10 @@ 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. + A :ref:`future statement `, "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 the :mod:`__future__` module and evaluating its variables, you can see when a new feature was first added to the language and when it 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 00000000000000..614abb412df8ea --- /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. From 8c11a1ab4e1a6ee0d7e49de0186f319fc911c13e Mon Sep 17 00:00:00 2001 From: Steven Hsu <81967953+StevenHsuYL@users.noreply.github.com> Date: Mon, 26 Jul 2021 01:17:14 +0800 Subject: [PATCH 2/3] Update glossary.rst Remove white space. --- Doc/glossary.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Doc/glossary.rst b/Doc/glossary.rst index 00559fbcdb55c8..c3a2cb5a781f78 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -451,9 +451,9 @@ Glossary for best practices on working with annotations. __future__ - A :ref:`future statement `, "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 + A :ref:`future statement `, "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 the :mod:`__future__` module and evaluating its variables, From d93b502f033cfc189546dad1acc7d71ae931d43a Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Sun, 25 Jul 2021 19:11:36 -0400 Subject: [PATCH 3/3] Revisions --- Doc/glossary.rst | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/Doc/glossary.rst b/Doc/glossary.rst index c3a2cb5a781f78..1f14946fa13427 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -451,14 +451,13 @@ Glossary for best practices on working with annotations. __future__ - A :ref:`future statement `, "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 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