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 <tjreedy@udel.edu>
This commit is contained in:
Steven Hsu 2021-07-26 09:11:12 +08:00 committed by GitHub
parent 4214f470f0
commit 0363a4014d
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 9 additions and 6 deletions

View file

@ -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 <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

View file

@ -0,0 +1,2 @@
Update the definition of __future__ in the glossary by replacing the confusing
word "pseudo-module" with a more accurate description.