[Python-checkins] cpython: Issue #17176: Document that imp.NullImporter is no longer inserted

Wed Mar 13 19:03:08 CET 2013

http://hg.python.org/cpython/rev/8e390e4784b0
changeset: 82645:8e390e4784b0
user: Brett Cannon <brett at python.org>
date: Wed Mar 13 10:46:22 2013 -0700
summary:
 Issue #17176: Document that imp.NullImporter is no longer inserted
into sys.path_importer_cache.
files:
 Doc/library/imp.rst | 9 +++++----
 Doc/library/sys.rst | 9 ++++++---
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/Doc/library/imp.rst b/Doc/library/imp.rst
--- a/Doc/library/imp.rst
+++ b/Doc/library/imp.rst
@@ -326,16 +326,17 @@
 with an existing directory or empty string raises :exc:`ImportError`.
 Otherwise, a :class:`NullImporter` instance is returned.
 
- Python adds instances of this type to ``sys.path_importer_cache`` for any path
- entries that are not directories and are not handled by any other path hooks on
- ``sys.path_hooks``. Instances have only one method:
-
+ Instances have only one method:
 
 .. method:: NullImporter.find_module(fullname [, path])
 
 This method always returns ``None``, indicating that the requested module could
 not be found.
 
+ .. versionchanged:: 3.3
+ ``None`` is inserted into ``sys.path_importer_cache`` instead of an
+ instance of :class:`NullImporter`.
+
 
 .. _examples-imp:
 
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -785,12 +785,15 @@
 A dictionary acting as a cache for :term:`finder` objects. The keys are
 paths that have been passed to :data:`sys.path_hooks` and the values are
 the finders that are found. If a path is a valid file system path but no
- explicit finder is found on :data:`sys.path_hooks` then ``None`` is
- stored to represent the implicit default finder should be used. If the path
- is not an existing path then :class:`imp.NullImporter` is set.
+ finder is found on :data:`sys.path_hooks` then ``None`` is
+ stored.
 
 Originally specified in :pep:`302`.
 
+ .. versionchanged:: 3.3
+ ``None`` is stored instead of :class:`imp.NullImporter` when no finder
+ is found.
+
 
 .. data:: platform
 
-- 
Repository URL: http://hg.python.org/cpython
