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

diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index c9473357c9f3f27a02f2bc2f772e938e1a8c5a1a..c84d2dfbb46a18deae8617cd6ae1087e48b229ad 100644 (file)
--- 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 5b6a11e0e11bd73331c45db81f2bbb516b179a3e..14fe90741867e8ab681a461b7f9fbaeb9bd8b556 100644 (file)
--- 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 822184b4e2e9ab542b84ed12609cb6c4796596db..e6a539907553b72f8da33ca45068ae97a3824c92 100644 (file)
--- 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