From: R David Murray <rdmurray@bitdance.com>
Date: Sun, 22 Dec 2013 19:05:11 +0000 (-0500)
Subject: Rewrite module-globals summary entry, and expand the full description a bit.
X-Git-Tag: v3.4.0b2~128
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ca7946193f54eb51106cd111f2dc873d4f3d4c7c;p=python

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 34fd4b0845..12b4dac4c2 100644
--- 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::