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

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index f8f87807179181d02b7ad189fe841545f9e09ff1..8fac448167726acb7ad3808367b99d7d4fadcb8b 100644 (file)
--- 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 21f4cca1476c299deab1181bdfe6d687605a83b8..12d96748ae6c6870bfb004d47a3c111ec5bfe7aa 100644 (file)
--- 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 54c2d8cda649aa4a01330ca7eea90db624fdbcd8..09db1d3ec5b84c724d6d4cc38930d9c7f488d8f8 100644 (file)
--- 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