[Python-checkins] cpython: Improved summary section in whatsnew

[antoine.pitrou]

http://hg.python.org/cpython/rev/a22ed8b509f5
changeset:   78688:a22ed8b509f5
user:        Antoine Pitrou <solipsis at pitrou.net>
date:        Tue Aug 21 00:53:06 2012 +0200
summary:
  Improved summary section in whatsnew

files:
  Doc/whatsnew/3.3.rst |  56 +++++++++++++++++++++++++------
  1 files changed, 45 insertions(+), 11 deletions(-)


diff --git a/Doc/whatsnew/3.3.rst b/Doc/whatsnew/3.3.rst
--- a/Doc/whatsnew/3.3.rst
+++ b/Doc/whatsnew/3.3.rst
@@ -53,17 +53,43 @@
    release, so it's worth checking back even after reading earlier versions.
 
 
-Summary
-=======
-
-Major changes since Python 3.2:
-
- * 4 new modules: :mod:`faulthandler`, :mod:`ipaddress`, :mod:`lzma` and :mod:`venv`.
- * Syntax changes:
-
-   - ``u'unicode'`` syntax is accepted again
-   - Add ``yield from`` syntax
-
+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>`.
+
+Implementation improvements:
+
+* Rewritten :ref:`import machinery <importlib>` based on :mod:`importlib`.
+* More compact :ref:`unicode strings <pep-393>`.
+* More compact :ref:`attribute dictionaries <pep-412>`.
+
+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 @@
 details).
 
 
+.. _pep-3151:
+
 PEP 3151: Reworking the OS and IO exception hierarchy
 =====================================================
 
@@ -288,6 +316,8 @@
         print("You are not allowed to read document.txt")
 
 
+.. _pep-380:
+
 PEP 380: Syntax for Delegating to a Subgenerator
 ================================================
 
@@ -489,6 +519,8 @@
    '<function C.D.meth at 0x7f46b9fe31e0>'
 
 
+.. _pep-412:
+
 PEP 412: Key-Sharing Dictionary
 ===============================
 
@@ -518,6 +550,8 @@
 or amends calling signatures or arguments.
 
 
+.. _importlib:
+
 Using importlib as the Implementation of Import
 ===============================================
 :issue:`2377` - Replace __import__ w/ importlib.__import__

-- 
Repository URL: http://hg.python.org/cpython