summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorRobert Collins <rbtcollins@hp.com>2015-08-04 20:16:41 (GMT)
committerRobert Collins <rbtcollins@hp.com>2015-08-04 20:16:41 (GMT)
commit937f2f70f5da95a3cfe72a0bdac91abad327a7bc (patch)
tree16af90ceb909303a8487b9884da802f45afa1935 /Doc/library
parent1d8b7be33316619083a7189f2cdd70fb071c14d0 (diff)
downloadcpython-937f2f70f5da95a3cfe72a0bdac91abad327a7bc.zip
cpython-937f2f70f5da95a3cfe72a0bdac91abad327a7bc.tar.gz
cpython-937f2f70f5da95a3cfe72a0bdac91abad327a7bc.tar.bz2
Issue #20769: Improve reload() docs. Patch by Dorian Pula.
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/functions.rst9
1 files changed, 5 insertions, 4 deletions
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index f8f8780..8fac448 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1191,10 +1191,11 @@ section.
except NameError:
cache = {}
- It is legal though generally not very useful to reload built-in or dynamically
- loaded modules, except for :mod:`sys`, :mod:`__main__` and :mod:`__builtin__`.
- In many cases, however, extension modules are not designed to be initialized
- more than once, and may fail in arbitrary ways when reloaded.
+ It is generally not very useful to reload built-in or dynamically loaded
+ modules. Reloading :mod:`sys`, :mod:`__main__`, :mod:`builtins` and other
+ key modules is not recommended. In many cases extension modules are not
+ designed to be initialized more than once, and may fail in arbitrary ways
+ when reloaded.
If a module imports objects from another module using :keyword:`from` ...
:keyword:`import` ..., calling :func:`reload` for the other module does not