summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorBrett Cannon <brett@python.org>2015-12-04 22:51:26 (GMT)
committerBrett Cannon <brett@python.org>2015-12-04 22:51:26 (GMT)
commitf4f25fe576ca86a51c8e4f98a801f32879d7a582 (patch)
tree1e62d09973796a94149838242794d1da18dd06d0 /Doc
parentf17c20076cb9e6b96cf1f1fe19062b397ff58b3a (diff)
downloadcpython-f4f25fe576ca86a51c8e4f98a801f32879d7a582.zip
cpython-f4f25fe576ca86a51c8e4f98a801f32879d7a582.tar.gz
cpython-f4f25fe576ca86a51c8e4f98a801f32879d7a582.tar.bz2
Issue #25500: Fix the language reference to not claim that import
statements search for __import__ in the global scope. Thanks to Sergei Lebedev for finding the documentation bug.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/reference/import.rst9
1 files changed, 4 insertions, 5 deletions
diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst
index d549b26..2144c1f 100644
--- a/Doc/reference/import.rst
+++ b/Doc/reference/import.rst
@@ -29,11 +29,10 @@ such as the importing of parent packages, and the updating of various caches
a name binding operation.
When calling :func:`__import__` as part of an import statement, the
-import system first checks the module global namespace for a function by
-that name. If it is not found, then the standard builtin :func:`__import__`
-is called. Other mechanisms for invoking the import system (such as
-:func:`importlib.import_module`) do not perform this check and will always
-use the standard import system.
+standard builtin :func:`__import__` is called. Other mechanisms for
+invoking the import system (such as :func:`importlib.import_module`) may
+choose to subvert :func:`__import__` and use its own solution to
+implement import semantics.
When a module is first imported, Python searches for the module and if found,
it creates a module object [#fnmo]_, initializing it. If the named module