summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrett Cannon <brett@python.org>2014-02-06 14:46:08 (GMT)
committerBrett Cannon <brett@python.org>2014-02-06 14:46:08 (GMT)
commit07fbd7847356c704ef30f9a4230a60281422dd39 (patch)
treee23542329cbb801835339900042fb7dabfd88219
parent5b4fab1ad7382f45c848b85c6f94b08c212471bd (diff)
downloadcpython-07fbd7847356c704ef30f9a4230a60281422dd39.zip
cpython-07fbd7847356c704ef30f9a4230a60281422dd39.tar.gz
cpython-07fbd7847356c704ef30f9a4230a60281422dd39.tar.bz2
Issue #20488: Update docs to say importlib is *the* implementaiton of
import and not *an* implementation.
-rw-r--r--Doc/library/importlib.rst14
-rw-r--r--Misc/NEWS3
2 files changed, 11 insertions, 6 deletions
diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index 92339dc..5f740a2 100644
--- a/Doc/library/importlib.rst
+++ b/Doc/library/importlib.rst
@@ -1,8 +1,8 @@
-:mod:`importlib` -- An implementation of :keyword:`import`
-==========================================================
+:mod:`importlib` -- The implementation of :keyword:`import`
+===========================================================
.. module:: importlib
- :synopsis: An implementation of the import machinery.
+ :synopsis: The implementation of the import machinery.
.. moduleauthor:: Brett Cannon <brett@python.org>
.. sectionauthor:: Brett Cannon <brett@python.org>
@@ -13,17 +13,16 @@
Introduction
------------
-The purpose of the :mod:`importlib` package is two-fold. One is to provide an
+The purpose of the :mod:`importlib` package is two-fold. One is to provide the
implementation of the :keyword:`import` statement (and thus, by extension, the
:func:`__import__` function) in Python source code. This provides an
implementation of :keyword:`import` which is portable to any Python
-interpreter. This also provides a reference implementation which is easier to
+interpreter. This also provides an implementation which is easier to
comprehend than one implemented in a programming language other than Python.
Two, the components to implement :keyword:`import` are exposed in this
package, making it easier for users to create their own custom objects (known
generically as an :term:`importer`) to participate in the import process.
-Details on custom importers can be found in :pep:`302`.
.. seealso::
@@ -53,6 +52,9 @@ Details on custom importers can be found in :pep:`302`.
:pep:`366`
Main module explicit relative imports
+ :pep:`451`
+ A ModuleSpec Type for the Import System
+
:pep:`3120`
Using UTF-8 as the Default Source Encoding
diff --git a/Misc/NEWS b/Misc/NEWS
index 59bc95d..074b2db 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -379,6 +379,9 @@ Tests
Documentation
-------------
+- Issue #20488: Importlib is no longer *an* implementation of import, it's *the*
+ implementation.
+
- Issue #20265: Updated some parts of the Using Windows document.
- Issue #20266: Updated some parts of the Windows FAQ.