summaryrefslogtreecommitdiffstats
path: root/Doc/library/importlib.rst
diff options
context:
space:
mode:
authorMarc-Andre Lemburg <mal@egenix.com>2012-04-25 00:11:07 (GMT)
committerMarc-Andre Lemburg <mal@egenix.com>2012-04-25 00:11:07 (GMT)
commitac8805a01a0beeb4c5b2f6d9d988629446517632 (patch)
tree508e1844c0372f19b7bcdbf22d9aeb7de1635ca6 /Doc/library/importlib.rst
parent2945e78b05b8629969764842f73a845c1cbb2fb9 (diff)
downloadcpython-ac8805a01a0beeb4c5b2f6d9d988629446517632.zip
cpython-ac8805a01a0beeb4c5b2f6d9d988629446517632.tar.gz
cpython-ac8805a01a0beeb4c5b2f6d9d988629446517632.tar.bz2
Issue #14605: Revert renaming of _SourcelessFileLoader, since it caused
the buildbots to fail.
Diffstat (limited to 'Doc/library/importlib.rst')
-rw-r--r--Doc/library/importlib.rst13
1 files changed, 8 insertions, 5 deletions
diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index a8013d2..de29e4f 100644
--- a/Doc/library/importlib.rst
+++ b/Doc/library/importlib.rst
@@ -606,15 +606,18 @@ find and load modules.
Load the specified module if it is the same as :attr:`name`.
-.. class:: SourcelessFileLoader(fullname, path)
+.. class:: _SourcelessFileLoader(fullname, path)
A concrete implementation of :class:`importlib.abc.FileLoader` which can
import bytecode files (i.e. no source code files exist).
- Please note that direct use of bytecode files (and thus not source code
- files) inhibits your modules from being usable by all Python
- implementations or new versions of Python which change the bytecode
- format.
+ It is **strongly** suggested you do not rely on this loader (hence the
+ leading underscore of the class). Direct use of bytecode files (and thus not
+ source code files) inhibits your modules from being usable by all Python
+ implementations. It also runs the risk of your bytecode files not being
+ usable by new versions of Python which change the bytecode format. This
+ class is only documented as it is directly used by import and thus can
+ potentially have instances show up as a module's ``__loader__`` attribute.
.. versionadded:: 3.3