Issue #20769: Improve reload() docs. Patch by Dorian Pula.
diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index c947335..c84d2df 100644
--- a/Doc/library/importlib.rst
+++ b/Doc/library/importlib.rst
@@ -166,11 +166,11 @@
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 5b6a11e..14fe907 100644
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -1098,6 +1098,7 @@
Donovan Preston
Paul Price
Iuliia Proskurnia
+Dorian Pula
Jyrki Pulliainen
Steve Purcell
Eduardo Pérez
diff --git a/Misc/NEWS b/Misc/NEWS
index 822184b..e6a5399 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -408,6 +408,8 @@
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