From 2b9fd47da776f75ddf5b488fcc73b8631ece8e2b Mon Sep 17 00:00:00 2001 From: Brett Cannon Date: Sun, 15 Mar 2009 02:18:41 +0000 Subject: [PATCH] Fix docs for __import__ that say the default for 'level' is -1; it's actually 0. --- Doc/library/functions.rst | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index 815b3a7de2..e807e79c06 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1207,9 +1207,8 @@ are always available. They are listed here in alphabetical order. not use its *locals* argument at all, and uses its *globals* only to determine the package context of the :keyword:`import` statement. - *level* specifies whether to use absolute or relative imports. The default - is ``-1`` which indicates both absolute and relative imports will be - attempted. ``0`` means only perform absolute imports. Positive values for + *level* specifies whether to use absolute or relative imports. ``0`` (the + default) means only perform absolute imports. Positive values for *level* indicate the number of parent directories to search relative to the directory of the module calling :func:`__import__`. @@ -1221,11 +1220,11 @@ are always available. They are listed here in alphabetical order. For example, the statement ``import spam`` results in bytecode resembling the following code:: - spam = __import__('spam', globals(), locals(), [], -1) + spam = __import__('spam', globals(), locals(), [], 0) The statement ``import spam.ham`` results in this call:: - spam = __import__('spam.ham', globals(), locals(), [], -1) + spam = __import__('spam.ham', globals(), locals(), [], 0) Note how :func:`__import__` returns the toplevel module here because this is the object that is bound to a name by the :keyword:`import` statement. @@ -1233,7 +1232,7 @@ are always available. They are listed here in alphabetical order. On the other hand, the statement ``from spam.ham import eggs, sausage as saus`` results in :: - _temp = __import__('spam.ham', globals(), locals(), ['eggs', 'sausage'], -1) + _temp = __import__('spam.ham', globals(), locals(), ['eggs', 'sausage'], 0) eggs = _temp.eggs saus = _temp.sausage -- 2.40.0