[Python-checkins] cpython: Neaten up structure of major sections.

[r.david.murray]

http://hg.python.org/cpython/rev/36e6fb43b611
changeset:   88173:36e6fb43b611
user:        R David Murray <rdmurray at bitdance.com>
date:        Tue Dec 24 15:33:02 2013 -0500
summary:
  Neaten up structure of major sections.

Also move tick_counter from deprecated section to removed section.

files:
  Doc/whatsnew/3.4.rst |  33 +++++++++++++++++++------------
  1 files changed, 20 insertions(+), 13 deletions(-)


diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -1035,8 +1035,6 @@
 Other Build and C API Changes
 -----------------------------
 
-Other changes to Python's build process and to the C API include:
-
 * The new :c:func:`Py_SetStandardStreamEncoding` pre-initialization API
   allows applications embedding the CPython interpreter to reliably force
   a particular encoding and error handler for the standard streams
@@ -1078,10 +1076,8 @@
   :issue:`13390`).
 
 
-Optimizations
-=============
-
-Major performance enhancements have been added:
+Significant Optimizations
+=========================
 
 * The UTF-32 decoder is now 3x to 4x faster.
 
@@ -1112,6 +1108,12 @@
 Deprecated
 ==========
 
+This section covers various APIs and other features that have been deprecated
+in Python 3.4, and will be removed in Python 3.5 or later.  In most (but not
+all) cases, using the deprecated APIs will produce a :exc:`DeprecationWarning`
+when the interpreter is run with deprecation warnings enabled (for example, by
+using ``-Wd``).
+
 
 Deprecated Python Modules, Functions and Methods
 ------------------------------------------------
@@ -1138,8 +1140,7 @@
 Deprecated Functions and Types in the C API
 -------------------------------------------
 
-* The ``PyThreadState.tick_counter`` field has been removed: its value was
-  meaningless since Python 3.2 ("new GIL").
+XXX: None so far
 
 
 Deprecated Features
@@ -1152,8 +1153,11 @@
 Removed
 =======
 
-* Support for the following previously deprecated operating systems has been
-  removed from the source and build tools:
+The following previously deprecated APIs and features have been removed
+in Python 3.4:
+
+* Support for the following operating systems has been removed from the source
+  and build tools:
 
     * OS/2 (:issue:`16135`).
     * Windows 2000 (changeset e52df05b496a).
@@ -1166,16 +1170,19 @@
 * The ``SO`` makefile macro is removed (it was replaced by the
   ``SHLIB_SUFFIX`` and ``EXT_SUFFIX`` macros) (:issue:`16754`).
 
+* The ``PyThreadState.tick_counter`` field has been removed; its value has
+  been meaningless since Python 3.2, when the "new GIL" was introduced.
+
 
 Porting to Python 3.4
 =====================
 
+This section lists previously described changes and other bugfixes
+that may require changes to your code.
+
 Changes in the Python API
 -------------------------
 
-This section lists previously described changes and other bugfixes
-that may require changes to your code.
-
 * The ABCs defined in :mod:`importlib.abc` now either raise the appropriate
   exception or return a default value instead of raising
   :exc:`NotImplementedError` blindly. This will only affect code calling

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