From 07fbd7847356c704ef30f9a4230a60281422dd39 Mon Sep 17 00:00:00 2001 From: Brett Cannon Date: Thu, 6 Feb 2014 09:46:08 -0500 Subject: [PATCH] Issue #20488: Update docs to say importlib is *the* implementaiton of import and not *an* implementation. --- Doc/library/importlib.rst | 14 ++++++++------ Misc/NEWS | 3 +++ 2 files changed, 11 insertions(+), 6 deletions(-) diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst index 92339dcd85..5f740a2732 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 .. sectionauthor:: Brett Cannon @@ -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 59bc95d269..074b2dbda1 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. -- 2.40.0