Issue #20769: Improve reload() docs. Patch by Dorian Pula.

This commit is contained in:
Robert Collins 2015-08-05 08:32:11 +12:00
commit 8c81711d6c
3 changed files with 8 additions and 5 deletions

View file

@ -179,11 +179,11 @@ Functions
except NameError: except NameError:
cache = {} cache = {}
It is legal though generally not very useful to reload built-in or It is generally not very useful to reload built-in or dynamically loaded
dynamically loaded modules (this is not true for e.g. :mod:`sys`, modules. Reloading :mod:`sys`, :mod:`__main__`, :mod:`builtins` and other
:mod:`__main__`, :mod:`builtins` and other key modules where reloading is key modules is not recommended. In many cases extension modules are not
frowned upon). In many cases, however, extension modules are not designed to designed to be initialized more than once, and may fail in arbitrary ways
be initialized more than once, and may fail in arbitrary ways when reloaded. when reloaded.
If a module imports objects from another module using :keyword:`from` ... If a module imports objects from another module using :keyword:`from` ...
:keyword:`import` ..., calling :func:`reload` for the other module does not :keyword:`import` ..., calling :func:`reload` for the other module does not

View file

@ -1127,6 +1127,7 @@ Paul Prescod
Donovan Preston Donovan Preston
Paul Price Paul Price
Iuliia Proskurnia Iuliia Proskurnia
Dorian Pula
Jyrki Pulliainen Jyrki Pulliainen
Steve Purcell Steve Purcell
Eduardo Pérez Eduardo Pérez

View file

@ -64,6 +64,8 @@ Library
Documentation Documentation
------------- -------------
- Issue #20769: Improve reload() docs. Patch by Dorian Pula.
- Issue #23589: Remove duplicate sentence from the FAQ. Patch by Yongzhi Pan. - Issue #23589: Remove duplicate sentence from the FAQ. Patch by Yongzhi Pan.
- Issue #24729: Correct IO tutorial to match implementation regarding - Issue #24729: Correct IO tutorial to match implementation regarding