From 1ae28d2ff35caaa53aac34a064977c6c3997819f Mon Sep 17 00:00:00 2001 From: Robert Collins Date: Wed, 5 Aug 2015 08:20:53 +1200 Subject: [PATCH] Issue #20769: Improve reload() docs. Patch by Dorian Pula. --- Doc/library/importlib.rst | 10 +++++----- Misc/ACKS | 1 + Misc/NEWS | 2 ++ 3 files changed, 8 insertions(+), 5 deletions(-) diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst index c9473357c9f..c84d2dfbb46 100644 --- a/Doc/library/importlib.rst +++ b/Doc/library/importlib.rst @@ -166,11 +166,11 @@ Functions except NameError: cache = {} - It is legal though generally not very useful to reload built-in or - dynamically loaded modules (this is not true for e.g. :mod:`sys`, - :mod:`__main__`, :mod:`builtins` and other key modules where reloading is - frowned upon). 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 5b6a11e0e11..14fe9074186 100644 --- a/Misc/ACKS +++ b/Misc/ACKS @@ -1098,6 +1098,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 822184b4e2e..e6a53990755 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -408,6 +408,8 @@ C API Documentation ------------- +- Issue #20769: Improve reload() docs. Patch by Dorian Pula. + - Issue #23589: Remove duplicate sentence from the FAQ. Patch by Yongzhi Pan. - Issue #24729: Correct IO tutorial to match implementation regarding