Improved summary section in whatsnew

diff --git a/Doc/whatsnew/3.3.rst b/Doc/whatsnew/3.3.rst
index 3572946b860feab9bc35b485d2a717a58e2f85ec..f7a928adae5b3adc670f59553489afb442f6484c 100644 (file)
--- a/Doc/whatsnew/3.3.rst
+++ b/Doc/whatsnew/3.3.rst
@@ -53,17 +53,43 @@ This article explains the new features in Python 3.3, compared to 3.2.
    release, so it's worth checking back even after reading earlier versions.
 
 
-Summary
-=======
+Summary -- Release highlights
+=============================
+
+.. This section singles out the most important changes in Python 3.3.
+   Brevity is key.
+
+New syntax features:
+
+* New ``yield from`` expression for :ref:`generator delegation <pep-380>`.
+* The ``u'unicode'`` syntax is accepted again for :class:`str` objects.
+
+New library modules:
+
+* :mod:`faulthandler` (helps debugging low-level crashes)
+* :mod:`ipaddress` (high-level objects representing IP addresses and masks)
+* :mod:`lzma` (compress data using the XZ / LZMA algorithm)
+* :mod:`venv` (Python :ref:`virtual environments <pep-405>`, as in the
+  popular ``virtualenv`` package)
+
+New built-in features:
+
+* Reworked :ref:`I/O exception hierarchy <pep-3151>`.
 
-Major changes since Python 3.2:
+Implementation improvements:
 
- * 4 new modules: :mod:`faulthandler`, :mod:`ipaddress`, :mod:`lzma` and :mod:`venv`.
- * Syntax changes:
+* Rewritten :ref:`import machinery <importlib>` based on :mod:`importlib`.
+* More compact :ref:`unicode strings <pep-393>`.
+* More compact :ref:`attribute dictionaries <pep-412>`.
 
-   - ``u'unicode'`` syntax is accepted again
-   - Add ``yield from`` syntax
+Security improvements:
 
+* Hash randomization is switched on by default.
+
+Please read on for a comprehensive list of user-facing changes.
+
+
+.. _pep-405:
 
 PEP 405: Virtual Environments
 =============================
@@ -220,6 +246,8 @@ bit better than Python 2.7, on a Django benchmark (see the PEP for
 details).
 
 
+.. _pep-3151:
+
 PEP 3151: Reworking the OS and IO exception hierarchy
 =====================================================
 
@@ -288,6 +316,8 @@ inspection of exception attributes::
         print("You are not allowed to read document.txt")
 
 
+.. _pep-380:
+
 PEP 380: Syntax for Delegating to a Subgenerator
 ================================================
 
@@ -489,6 +519,8 @@ new, more precise information::
    '<function C.D.meth at 0x7f46b9fe31e0>'
 
 
+.. _pep-412:
+
 PEP 412: Key-Sharing Dictionary
 ===============================
 
@@ -518,6 +550,8 @@ which considerably simplifies writing decorators and any code that validates
 or amends calling signatures or arguments.
 
 
+.. _importlib:
+
 Using importlib as the Implementation of Import
 ===============================================
 :issue:`2377` - Replace __import__ w/ importlib.__import__