summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorSteve Dower <steve.dower@microsoft.com>2016-12-07 21:02:27 (GMT)
committerSteve Dower <steve.dower@microsoft.com>2016-12-07 21:02:27 (GMT)
commit20367420c8b32602a550834fa3fb061a9d9a3b55 (patch)
treeca1b0d1b1fd1b04451990a2787f22f396b7552f7 /Doc
parenteae64fda5beb687ec3fd51e98ca78dac00d06db7 (diff)
downloadcpython-20367420c8b32602a550834fa3fb061a9d9a3b55.zip
cpython-20367420c8b32602a550834fa3fb061a9d9a3b55.tar.gz
cpython-20367420c8b32602a550834fa3fb061a9d9a3b55.tar.bz2
Issue #28896: Deprecate WindowsRegistryFinder
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/importlib.rst4
-rw-r--r--Doc/using/windows.rst8
-rw-r--r--Doc/whatsnew/3.6.rst4
3 files changed, 16 insertions, 0 deletions
diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index 8210a2f..1fd5698 100644
--- a/Doc/library/importlib.rst
+++ b/Doc/library/importlib.rst
@@ -806,6 +806,10 @@ find and load modules.
.. versionadded:: 3.3
+ .. deprecated:: 3.6
+ Use :mod:`site` configuration instead. Future versions of Python may
+ not enable this finder by default.
+
.. class:: PathFinder
diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
index 81efbb0..3e4b70e 100644
--- a/Doc/using/windows.rst
+++ b/Doc/using/windows.rst
@@ -823,6 +823,14 @@ non-standard paths in the registry and user site-packages.
* Adds ``pythonXX.zip`` as a potential landmark when directly adjacent
to the executable.
+.. deprecated::
+ 3.6
+
+ Modules specified in the registry under ``Modules`` (not ``PythonPath``)
+ may be imported by :class:`importlib.machinery.WindowsRegistryFinder`.
+ This finder is enabled on Windows in 3.6.0 and earlier, but may need to
+ be explicitly added to :attr:`sys.meta_path` in the future.
+
Additional modules
==================
diff --git a/Doc/whatsnew/3.6.rst b/Doc/whatsnew/3.6.rst
index 527e742..ddca2ef 100644
--- a/Doc/whatsnew/3.6.rst
+++ b/Doc/whatsnew/3.6.rst
@@ -1938,6 +1938,10 @@ are now deprecated. They were the only remaining implementations of
been deprecated in previous versions of Python in favour of
:meth:`importlib.abc.Loader.exec_module`.
+The :class:`importlib.machinery.WindowsRegistryFinder` class is now
+deprecated. As of 3.6.0, it is still added to :attr:`sys.meta_path` by
+default (on Windows), but this may change in future releases.
+
os
~~