Rewrite module-globals summary entry, and expand the full description a bit.

diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
index 34fd4b0845f37eafbe18bc095c869a444f5c3c57..12b4dac4c22abc0dfe123ad9d7858168f512df06 100644 (file)
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -124,11 +124,11 @@ Significantly Improved Library Modules:
 CPython implementation improvements:
 
 * :pep:`442`: :ref:`Safe object finalization <whatsnew-pep-442>`
+* Leveraging :pep:`442`, :ref:`module globals are no longer set to None
+  during finalization <whatsnew-pep-442>`, in most cases (:issue:`18214`).
 * :pep:`445`: :ref:`Configurable memory allocators <whatsnew-pep-445>`
 * :pep:`456`: :ref:`Secure and interchangeable hash algorithm <whatsnew-pep-456>`
 * :pep:`436`: :ref:`Argument Clinic <whatsnew-pep-436>`.
-* Improve finalization of Python modules to avoid setting their globals
-  to None, in most cases (:issue:`18214`).
 * A more efficient :mod:`marshal` format (:issue:`16475`).
 
 Please read on for a comprehensive list of user-facing changes.
@@ -933,7 +933,10 @@ part of a reference cycle.
 
 As part of this change, module globals are no longer forcibly set to
 :const:`None` during interpreter shutdown in most cases, instead relying
-on the normal operation of the cyclic garbage collector.
+on the normal operation of the cyclic garbage collector.  This avoids a
+whole class of interpreter-shutdown-time errors, usually involving
+``__del__`` methods, that have plagued Python since the cyclic GC
+was first introduced.
 
 .. seealso::