From: Robert Collins Date: Tue, 4 Aug 2015 20:16:41 +0000 (+1200) Subject: Issue #20769: Improve reload() docs. Patch by Dorian Pula. X-Git-Tag: v2.7.11rc1~203 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=937f2f70f5da95a3cfe72a0bdac91abad327a7bc;p=thirdparty%2FPython%2Fcpython.git Issue #20769: Improve reload() docs. Patch by Dorian Pula. --- diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index f8f878071791..8fac44816772 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 diff --git a/Misc/ACKS b/Misc/ACKS index 21f4cca1476c..12d96748ae6c 100644 --- a/Misc/ACKS +++ b/Misc/ACKS @@ -1088,6 +1088,7 @@ Paul Prescod Donovan Preston Paul Price Iuliia Proskurnia +Dorian Pula Jyrki Pulliainen Steve Purcell Eduardo Pérez diff --git a/Misc/NEWS b/Misc/NEWS index 54c2d8cda649..09db1d3ec5b8 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -142,6 +142,8 @@ IDLE Documentation ------------- +- Issue #20769: Improve reload() docs. Patch by Dorian Pula. + - Issue #23589: Remove duplicate sentence from the FAQ. Patch by Yongzhi Pan. - Issue #22155: Add File Handlers subsection with createfilehandler to Tkinter