diff options
| author | Brett Cannon <brett@python.org> | 2012-11-17 14:30:55 (GMT) |
|---|---|---|
| committer | Brett Cannon <brett@python.org> | 2012-11-17 14:30:55 (GMT) |
| commit | 56b4ca78d8cd30e6f2a1292fa9d7004ef157f68c (patch) | |
| tree | c251b081a40a91bea5eee9205282ff390a80f8b7 /Doc/library | |
| parent | 4a42ec5089fd652ad04649811c246005ad1a74f9 (diff) | |
| download | cpython-56b4ca78d8cd30e6f2a1292fa9d7004ef157f68c.zip cpython-56b4ca78d8cd30e6f2a1292fa9d7004ef157f68c.tar.gz cpython-56b4ca78d8cd30e6f2a1292fa9d7004ef157f68c.tar.bz2 | |
Issue #16489: Make it clearer that importlib.find_loader() requires
the user to import any parent packages.
Diffstat (limited to 'Doc/library')
| -rw-r--r-- | Doc/library/importlib.rst | 9 |
1 files changed, 4 insertions, 5 deletions
diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst index 681f1d9..083656e 100644 --- a/Doc/library/importlib.rst +++ b/Doc/library/importlib.rst @@ -94,11 +94,10 @@ Functions :exc:`ValueError` is raised). Otherwise a search using :attr:`sys.meta_path` is done. ``None`` is returned if no loader is found. - A dotted name does not have its parent's implicitly imported. If that is - desired (although not nessarily required to find the loader, it will most - likely be needed if the loader actually is used to load the module), then - you will have to import the packages containing the module prior to calling - this function. + A dotted name does not have its parent's implicitly imported as that requires + loading them and that may not be desired. To properly import a submodule you + will need to import all parent packages of the submodule and use the correct + argument to *path*. .. function:: invalidate_caches() |