diff options
| author | Brett Cannon <bcannon@gmail.com> | 2010-09-27 21:08:38 +0000 |
|---|---|---|
| committer | Brett Cannon <bcannon@gmail.com> | 2010-09-27 21:08:38 +0000 |
| commit | 064d77f98f02888066c602ff0315ecfb59d586c1 (patch) | |
| tree | 45500b7811901918a1d15b4143eba7f9b95c1b65 | |
| parent | 65950664d4c44baf11c19a7d47b28868cb4cf059 (diff) | |
| download | cpython-064d77f98f02888066c602ff0315ecfb59d586c1.tar.gz | |
Since __import__ is not designed for general use, have its docstring point
people towards importlib.import_module().
Closes issue #7397.
| -rw-r--r-- | Misc/NEWS | 3 | ||||
| -rw-r--r-- | Python/bltinmodule.c | 8 |
2 files changed, 9 insertions, 2 deletions
@@ -10,6 +10,9 @@ What's New in Python 3.2 Alpha 3? Core and Builtins ----------------- +- Issue #7397: Mention that importlib.import_module() is probably what someone + really wants to be using in __import__'s docstring. + - Issue #8521: Allow CreateKeyEx, OpenKeyEx, and DeleteKeyEx functions of winreg to use named arguments. diff --git a/Python/bltinmodule.c b/Python/bltinmodule.c index 60bceb7581..2e8d6e21b3 100644 --- a/Python/bltinmodule.c +++ b/Python/bltinmodule.c @@ -173,8 +173,12 @@ builtin___import__(PyObject *self, PyObject *args, PyObject *kwds) PyDoc_STRVAR(import_doc, "__import__(name, globals={}, locals={}, fromlist=[], level=-1) -> module\n\ \n\ -Import a module. The globals are only used to determine the context;\n\ -they are not modified. The locals are currently unused. The fromlist\n\ +Import a module. Because this function is meant for use by the Python\n\ +interpreter and not for general use it is better to use\n\ +importlib.import_module() to programmatically import a module.\n\ +\n\ +The globals argument is only used to determine the context;\n\ +they are not modified. The locals argument is unused. The fromlist\n\ should be a list of names to emulate ``from name import ...'', or an\n\ empty list to emulate ``import name''.\n\ When importing a module from a package, note that __import__('A.B', ...)\n\ |