NEWS rewrap and punctuation consistency.

Misc/NEWS

@@ -12,18 +12,18 @@ What's New in Python 2.7 Release Candidate 1?
 Core and Builtins
 -----------------
 
-- Issue #7902: When using explicit relative import syntax, don't try
+- Issue #7902: When using explicit relative import syntax, don't try implicit
-  implicit relative import semantics.
+  relative import semantics.
 
-- Issue #7079: Fix a possible crash when closing a file object while using
+- Issue #7079: Fix a possible crash when closing a file object while using it
-  it from another thread.  Patch by Daniel Stutzbach.
+  from another thread.  Patch by Daniel Stutzbach.
 
 C-API
 -----
 
-- Issue #5753: A new C API function, :cfunc:`PySys_SetArgvEx`, allows
+- Issue #5753: A new C API function, :cfunc:`PySys_SetArgvEx`, allows embedders
-  embedders of the interpreter to set sys.argv without also modifying
+  of the interpreter to set sys.argv without also modifying sys.path.  This
-  sys.path.  This helps fix `CVE-2008-5983
+  helps fix `CVE-2008-5983
   <http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2008-5983>`_.
 
 Library
@@ -36,36 +36,37 @@ Library
   StreamWriter classes.
 
 - Issue #5640: Fix Shift-JIS incremental encoder for error handlers different
-  than strict
+  than 'strict'.
 
 - Issue #8782: Add a trailing newline in linecache.updatecache to the last line
   of files without one.
 
-- Issue #8729: Return NotImplemented from collections.Mapping.__eq__ when
+- Issue #8729: Return NotImplemented from ``collections.Mapping.__eq__()`` when
   comparing to a non-mapping.
 
-- Issue #8759: Fixed user paths in sysconfig for posix and os2 schemes.
+- Issue #8759: Fix user paths in sysconfig for posix and os2 schemes.
 
-- Issue #1285086: Speed up urllib.quote and urllib.unquote for simple cases.
+- Issue #1285086: Speed up ``urllib.quote()`` and urllib.unquote for simple
+  cases.
 
 - Issue #8688: Distutils now recalculates MANIFEST everytime.
 
-- Issue #5099: subprocess.Popen's __del__ method (and the methods it calls)
+- Issue #5099: The ``__del__()`` method of ``subprocess.Popen`` (and the methods
-  referenced global objects, causing errors to pop up during interpreter
+  it calls) referenced global objects, causing errors to pop up during
-  shutdown.
+  interpreter shutdown.
 
 Extension Modules
 -----------------
 
 - Issue #8674: Fixed a number of incorrect or undefined-behaviour-inducing
-  overflow checks in the audioop module.
+  overflow checks in the ``audioop`` module.
 
 Tests
 -----
 
-- On darwin, test_site assumed that a framework build was being used, leading
+- On darwin, ``test_site`` assumed that a framework build was being used,
-  to a failure where four directories were expected for site-packages instead
+  leading to a failure where four directories were expected for site-packages
-  of two in a non-framework build.
+  instead of two in a non-framework build.
 
 
 What's New in Python 2.7 beta 2?
@@ -76,226 +77,221 @@ What's New in Python 2.7 beta 2?
 Core and Builtins
 -----------------
 
-- Run Clang 2.7's static analyzer for Objects/ and Python/ .
+- Run Clang 2.7's static analyzer for ``Objects/`` and ``Python/``.
 
-- Issue #1533: fix inconsistency in range function argument
+- Issue #1533: Fix inconsistency in range function argument processing: any
-  processing: any non-float non-integer argument is now converted to
+  non-float non-integer argument is now converted to an integer (if possible)
-  an integer (if possible) using its __int__ method.  Previously, only
+  using its __int__ method.  Previously, only small arguments were treated this
-  small arguments were treated this way; larger arguments (those whose
+  way; larger arguments (those whose __int__ was outside the range of a C long)
-  __int__ was outside the range of a C long) would produce a TypeError.
+  would produce a TypeError.
 
-- Issue #8202: sys.argv[0] is now set to '-m' instead of '-c' when
+- Issue #8202: ``sys.argv[0]`` is now set to '-m' instead of '-c' when searching
-  searching for the module file to be executed with the -m command
+  for the module file to be executed with the -m command line option.
-  line option
 
 - Issue #7319: When -Q is used, do not silence DeprecationWarning.
 
 - Issue #7332: Remove the 16KB stack-based buffer in
-  PyMarshal_ReadLastObjectFromFile, which doesn't bring any noticeable
+  ``PyMarshal_ReadLastObjectFromFile``, which doesn't bring any noticeable
   benefit compared to the dynamic memory allocation fallback.  Patch by
   Charles-François Natali.
 
 - Issue #8417: Raise an OverflowError when an integer larger than sys.maxsize is
   passed to bytearray.
 
-- Issue #7072: isspace(0xa0) is true on Mac OS X
+- Issue #7072: ``isspace(0xa0)`` is true on Mac OS X.
 
-- Issue #8404: Fixed set operations on dictionary views.
+- Issue #8404: Fix set operations on dictionary views.
 
-- Issue #8084: PEP 370 now conforms to system conventions for framework
+- Issue #8084: PEP 370 now conforms to system conventions for framework builds
-  builds on MacOS X. That is, "python setup.py install --user" will install
+  on MacOS X. That is, ``python setup.py install --user`` will install into
-  into "~/Library/Python/2.7" instead of "~/.local".
+  ``~/Library/Python/2.7`` instead of ``~/.local``.
 
 Library
 -------
 
-- Issue #8681: Make the zlib module's error messages more informative when
+- Issue #8681: Make the zlib module's error messages more informative when the
-  the zlib itself doesn't give any detailed explanation.
+  zlib itself doesn't give any detailed explanation.
 
-- Issue #8571: Fix an internal error when compressing or decompressing a
+- Issue #8571: Fix an internal error when compressing or decompressing a chunk
-  chunk larger than 1GB with the zlib module's compressor and decompressor
+  larger than 1GB with the zlib module's compressor and decompressor objects.
-  objects.
 
-- Issue #8573: asyncore _strerror() function might throw ValueError.
+- Issue #8573: asyncore ``_strerror()`` function might throw ValueError.
 
-- Issue #8483: asyncore.dispatcher's __getattr__ method produced confusing
+- Issue #8483: asyncore.dispatcher's __getattr__ method produced confusing error
-  error messages when accessing undefined class attributes because of the cheap
+  messages when accessing undefined class attributes because of the cheap
-  inheritance with the underlying socket object.
+  inheritance with the underlying socket object.  The cheap inheritance has been
-  The cheap inheritance has been deprecated.
+  deprecated.
 
-- Issue #4265: shutil.copyfile() was leaking file descriptors when disk fills.
+- Issue #4265: ``shutil.copyfile()`` was leaking file descriptors when disk
-  Patch by Tres Seaver.
+  fills.  Patch by Tres Seaver.
 
 - Issue #7755: Use an unencumbered audio file for tests.
 
-- Issue #8621: uuid.uuid4() returned the same sequence of values in the
+- Issue #8621: ``uuid.uuid4()`` returned the same sequence of values in the
-  parent and any children created using ``os.fork`` on MacOS X 10.6.
+  parent and any children created using ``os.fork`` on Mac OS X 10.6.
 
-- Issue #8313: traceback.format_exception_only() encodes unicode message to
+- Issue #8313: ``traceback.format_exception_only()`` encodes unicode message to
-  ASCII with backslashreplace error handler if str(value) failed
+  ASCII with backslashreplace error handler if ``str(value)`` failed.
 
-- Issue #8567: Fix precedence of signals in Decimal module: when a
+- Issue #8567: Fix precedence of signals in Decimal module: when a Decimal
-  Decimal operation raises multiple signals and more than one of those
+  operation raises multiple signals and more than one of those signals is
-  signals is trapped, the specification determines the order in which
+  trapped, the specification determines the order in which the signals should be
-  the signals should be handled.  In many cases this order wasn't
+  handled.  In many cases this order wasn't being followed, leading to the wrong
-  being followed, leading to the wrong Python exception being raised.
+  Python exception being raised.
 
 - Issue #7865: The close() method of :mod:`io` objects should not swallow
-  exceptions raised by the implicit flush().  Also ensure that calling
+  exceptions raised by the implicit flush().  Also ensure that calling close()
-  close() several times is supported.  Patch by Pascal Chambon.
+  several times is supported.  Patch by Pascal Chambon.
 
 - Issue #8576: logging updated to remove usage of find_unused_port().
 
 - Issue #4687: Fix accuracy of garbage collection runtimes displayed with
   gc.DEBUG_STATS.
 
-- Issue #8354: The siginterrupt setting is now preserved for all signals,
+- Issue #8354: The siginterrupt setting is now preserved for all signals, not
-  not just SIGCHLD.
+  just SIGCHLD.
 
-- Issue #7192: webbrowser.get("firefox") now works on Mac OS X, as does
+- Issue #7192: ``webbrowser.get("firefox")`` now works on Mac OS X, as does
-  webbrowser.get("safari").
+  ``webbrowser.get("safari")``.
 
-- Issue #8577: distutils.sysconfig.get_python_inc() now makes a difference
+- Issue #8577: ``distutils.sysconfig.get_python_inc()`` now makes a difference
   between the build dir and the source dir when looking for "python.h" or
   "Include".
 
-- Issue #8464: tarfile no longer creates files with execute permissions set
+- Issue #8464: tarfile no longer creates files with execute permissions set when
-  when mode="w|" is used.
+  mode="w|" is used.
 
-- Issue #7834: Fix connect() of Bluetooth L2CAP sockets with recent versions
+- Issue #7834: Fix connect() of Bluetooth L2CAP sockets with recent versions of
-  of the Linux kernel.  Patch by Yaniv Aknin.
+  the Linux kernel.  Patch by Yaniv Aknin.
 
-- Issue #6312: Fixed http HEAD request when the transfer encoding is chunked.
+- Issue #6312: Fix http HEAD request when the transfer encoding is chunked.  It
-  It should correctly return an empty response now.
+  should correctly return an empty response now.
 
-- Issue #7490: to facilitate sharing of doctests between 2.x and 3.x test
+- Issue #7490: To facilitate sharing of doctests between 2.x and 3.x test
-  suites, the IGNORE_EXCEPTION_DETAIL directive now also ignores the module
+  suites, the ``IGNORE_EXCEPTION_DETAIL`` directive now also ignores the module
-  location of the raised exception. Based on initial patch by Lennart
+  location of the raised exception.  Based on initial patch by Lennart Regebro.
-  Regebro.
 
-- Issue #8086: In :func:`ssl.DER_cert_to_PEM_cert()`, fix missing newline
+- Issue #8086: In :func:`ssl.DER_cert_to_PEM_cert()`, fix missing newline before
-  before the certificate footer.  Patch by Kyle VanderBeek.
+  the certificate footer.  Patch by Kyle VanderBeek.
 
-- Issue #8546: Reject None given as the buffering argument to _pyio.open.
+- Issue #8546: Reject None given as the buffering argument to ``_pyio.open()``.
 
-- Issue #8549: Fix compiling the _ssl extension under AIX.  Patch by
+- Issue #8549: Fix compiling the _ssl extension under AIX.  Patch by Sridhar
-  Sridhar Ratnakumar.
+  Ratnakumar.
 
-- Issue #6656: fix locale.format_string to handle escaped percents
+- Issue #6656: Fix locale.format_string to handle escaped percents and mappings.
-  and mappings.
 
-- Issue #2302: Fix a race condition in SocketServer.BaseServer.shutdown,
+- Issue #2302: Fix a race condition in SocketServer.BaseServer.shutdown, where
-  where the method could block indefinitely if called just before the
+  the method could block indefinitely if called just before the event loop
-  event loop started running.  This also fixes the occasional freezes
+  started running.  This also fixes the occasional freezes witnessed in
-  witnessed in test_httpservers.
+  test_httpservers.
 
 - Issue #5103: SSL handshake would ignore the socket timeout and block
   indefinitely if the other end didn't respond.
 
-- The do_handshake() method of SSL objects now adjusts the blocking mode of
+- The do_handshake() method of SSL objects now adjusts the blocking mode of the
-  the SSL structure if necessary (as other methods already do).
+  SSL structure if necessary (as other methods already do).
 
 - Issue #7507: Quote "!" in pipes.quote(); it is special to some shells.
 
-- Issue #5238: Calling makefile() on an SSL object would prevent the
+- Issue #5238: Calling makefile() on an SSL object would prevent the underlying
-  underlying socket from being closed until all objects get truely destroyed.
+  socket from being closed until all objects get truely destroyed.
 
-- Issue #7943: Fix circular reference created when instantiating an SSL
+- Issue #7943: Fix circular reference created when instantiating an SSL socket.
-  socket.  Initial patch by Péter Szabó.
+  Initial patch by Péter Szabó.
 
-- Issue #8451: Syslog module now uses basename(sys.argv[0]) instead of
+- Issue #8451: Syslog module now uses basename(sys.argv[0]) instead of the
-  the string "python" as the *ident*.  openlog() arguments are all optional
+  string "python" as the *ident*.  openlog() arguments are all optional and
-  and keywords.
+  keywords.
 
-- Issue #8108: Fix the unwrap() method of SSL objects when the socket has
+- Issue #8108: Fix the unwrap() method of SSL objects when the socket has a
-  a non-infinite timeout.  Also make that method friendlier with applications
+  non-infinite timeout.  Also make that method friendlier with applications
   wanting to continue using the socket in clear-text mode, by disabling
   OpenSSL's internal readahead.  Thanks to Darryl Miles for guidance.
 
-- Issue #8484: Load all ciphers and digest algorithms when initializing
+- Issue #8484: Load all ciphers and digest algorithms when initializing the _ssl
-  the _ssl extension, such that verification of some SSL certificates
+  extension, such that verification of some SSL certificates doesn't fail
-  doesn't fail because of an "unknown algorithm".
+  because of an "unknown algorithm".
 
 - Issue #8437: Fix test_gdb failures, patch written by Dave Malcolm
 
-- Issue #4814: timeout parameter is now applied also for connections resulting
+- Issue #4814: The timeout parameter is now applied also for connections
-  from PORT/EPRT commands.
+  resulting from PORT/EPRT commands.
 
-- Issue #8463: added missing reference to bztar in shutil's documentation.
+- Issue #8463: Add missing reference to bztar in shutil's documentation.
 
-- Issue #8438: Remove reference to the missing "surrogateescape" encoding
+- Issue #8438: Remove reference to the missing "surrogateescape" encoding error
-  error handler from the new IO library.
+  handler from the new IO library.
 
-- Issue #3817: ftplib.FTP.abort() method now considers 225 a valid response
+- Issue #3817: ftplib.FTP.abort() method now considers 225 a valid response code
-  code as stated in RFC-959 at chapter 5.4.
+  as stated in RFC-959 at chapter 5.4.
 
 - Issue #8279: Fix test_gdb failures.
 
 - Issue #8322: Add a *ciphers* argument to SSL sockets, so as to change the
   available cipher list.  Helps fix test_ssl with OpenSSL 1.0.0.
 
-- Issue #2987: RFC2732 support for urlparse (IPv6 addresses). Patch by Tony
+- Issue #2987: RFC 2732 support for urlparse (IPv6 addresses).  Patch by Tony
   Locke and Hans Ulrich Niedermann.
 
 - Issue #7585: difflib context and unified diffs now place a tab between
-  filename and date, conforming to the 'standards' they were originally
+  filename and date, conforming to the 'standards' they were originally designed
-  designed to follow.  This improves compatibility with patch tools.
+  to follow.  This improves compatibility with patch tools.
 
 - Issue #7472: Fixed typo in email.encoders module; messages using ISO-2022
-  character sets will now consistently use a Content-Transfer-Encoding of
+  character sets will now consistently use a Content-Transfer-Encoding of 7bit
-  7bit rather than sometimes being marked as 8bit.
+  rather than sometimes being marked as 8bit.
 
 - Issue #8330: Fix expected output in test_gdb.
 
-- Issue #8374: Update the internal alias table in the :mod:`locale` module
+- Issue #8374: Update the internal alias table in the :mod:`locale` module to
-  to cover recent locale changes and additions.
+  cover recent locale changes and additions.
 
 Extension Modules
 -----------------
 
-- Issue #8644: Improved accuracy of timedelta.total_seconds().
+- Issue #8644: Improved accuracy of ``timedelta.total_seconds()``.
 
 - Use Clang 2.7's static analyzer to find places to clean up some code.
 
 - Build the ossaudio extension on GNU/kFreeBSD.
 
-- On Windows, ctypes does no longer check the stack before and after
+- On Windows, ctypes does no longer check the stack before and after calling a
-  calling a foreign function.  This allows to use the unmodified
+  foreign function.  This allows to use the unmodified libffi library.
-  libffi library.
 
 Tests
 -----
 
-- Issue #8672: Add a zlib test ensuring that an incomplete stream can be
+- Issue #8672: Add a zlib test ensuring that an incomplete stream can be handled
-  handled by a decompressor object without errors (it returns incomplete
+  by a decompressor object without errors (it returns incomplete uncompressed
-  uncompressed data).
+  data).
 
-- Issue #8490: asyncore now has a more solid test suite which actually tests
+- Issue #8490: asyncore now has a more solid test suite which actually tests its
-  its API.
+  API.
 
 - Issue #8576: Remove use of find_unused_port() in test_smtplib and
   test_multiprocessing.  Patch by Paul Moore.
 
-- Issue #7449: Fix many tests to support Python compiled without thread
+- Issue #7449: Fix many tests to support Python compiled without thread support.
-  support. Patches written by Jerry Seutter.
+  Patches written by Jerry Seutter.
 
-- Issue #8108: test_ftplib's non-blocking SSL server now has proper handling
+- Issue #8108: test_ftplib's non-blocking SSL server now has proper handling of
-  of SSL shutdowns.
+  SSL shutdowns.
 
 Build
 -----
 
-- Issue #8625: Turn off optimization in --with-pydebug builds with gcc.
+- Issue #8625: Turn off optimization in ``--with-pydebug`` builds with gcc.
   (Optimization was unintentionally turned on in gcc --with-pydebug builds in
   2.7 beta1 as a result of the issue #1628484 fix, combined with autoconf's
   strange choice of default CFLAGS produced by AC_PROG_CC for gcc.)
 
 - Issue #8509: Fix quoting in help strings and code snippets in configure.in.
 
-- Issue #3646: It is now easily possible to install a Python framework into
+- Issue #3646: It is now easily possible to install a Python framework into your
-  your home directory on MacOSX, see Mac/README for more information.
+  home directory on Mac OS X, see Mac/README for more information.
 
-- Issue #8510: Update to autoconf2.65.
+- Issue #8510: Update to autoconf 2.65.
 
 Misc
 ----
@@ -316,29 +312,28 @@ Core and Builtins
 - Issue #8329: Don't return the same lists from select.select when no fds are
   changed.
 
-- Issue #8259: 1L << (2**31) no longer produces an 'outrageous shift error'
+- Issue #8259: ``1L << (2**31)`` no longer produces an 'outrageous shift error'
   on 64-bit machines.  The shift count for either left or right shift is
   permitted to be up to sys.maxsize.
 
 - Ensure that tokenization of identifiers is not affected by locale.
 
-- Issue #1222585: Added LDCXXSHARED for C++ support. Patch by Arfrever.
+- Issue #1222585: Added LDCXXSHARED for C++ support.  Patch by Arfrever.
 
 - Raise a TypeError when trying to delete a T_STRING_INPLACE struct member.
 
-- Issue #7994: Issue a PendingDeprecationWarning if object.__format__
+- Issue #7994: Issue a PendingDeprecationWarning if object.__format__ is called
-  is called with a non-empty format string. This is an effort to
+  with a non-empty format string. This is an effort to future-proof user
-  future-proof user code. If a derived class does not currently
+  code. If a derived class does not currently implement __format__ but later
-  implement __format__ but later adds its own __format__, it would
+  adds its own __format__, it would most likely break user code that had
-  most likely break user code that had supplied a format string. This
+  supplied a format string. This will be changed to a DeprecationWaring in
-  will be changed to a DeprecationWaring in Python 3.3 and it will be
+  Python 3.3 and it will be an error in Python 3.4.
-  an error in Python 3.4.
 
 - Issue #8268: Old-style classes (not just instances) now support weak
   references.
 
-- Issue #8211: Save/restore CFLAGS around AC_PROG_CC in configure.in, in
+- Issue #8211: Save/restore CFLAGS around AC_PROG_CC in configure.in, in case it
-  case it is set.
+  is set.
 
 - Issue #1583863: An unicode subclass can now override the __unicode__ method
 
@@ -360,55 +355,54 @@ Library
 - Issue #5277: Fix quote counting when parsing RFC 2231 encoded parameters.
 
 - Issue #8321: Give access to OpenSSL version numbers from the `ssl` module,
-  using the new attributes `ssl.OPENSSL_VERSION`, `ssl.OPENSSL_VERSION_INFO`
+  using the new attributes `ssl.OPENSSL_VERSION`, `ssl.OPENSSL_VERSION_INFO` and
-  and `ssl.OPENSSL_VERSION_NUMBER`.
+  `ssl.OPENSSL_VERSION_NUMBER`.
 
 - Issue #8310: Allow dis to examine new style classes.
 
-- Issue #8257: The Decimal construct now accepts a float instance
+- Issue #8257: The Decimal construct now accepts a float instance directly,
-  directly, converting that float to a Decimal of equal value:
+  converting that float to a Decimal of equal value:
 
      >>> Decimal(1.1)
      Decimal('1.100000000000000088817841970012523233890533447265625')
 
 - collections.Counter() now supports a subtract() method.
 
-- the functools module now has a total_ordering() class decorator
+- The functools module now has a total_ordering() class decorator to simplify
-  to simplify the specification of rich comparisons.
+  the specification of rich comparisons.
 
-- The functools module also adds cmp_to_key() as a tool to transition
+- The functools module also adds cmp_to_key() as a tool to transition old-style
-  old-style comparison functions to new-style key-functions.
+  comparison functions to new-style key-functions.
 
-- Issue #8294: The Fraction constructor now accepts Decimal and float
+- Issue #8294: The Fraction constructor now accepts Decimal and float instances
-  instances directly.
+  directly.
 
-- Issue #7279: Comparisons involving a Decimal signaling NaN now
+- Issue #7279: Comparisons involving a Decimal signaling NaN now signal
-  signal InvalidOperation instead of returning False.  (Comparisons
+  InvalidOperation instead of returning False.  (Comparisons involving a quiet
-  involving a quiet NaN are unchanged.)  Also, Decimal quiet NaNs
+  NaN are unchanged.)  Also, Decimal quiet NaNs are now hashable; Decimal
-  are now hashable;  Decimal signaling NaNs remain unhashable.
+  signaling NaNs remain unhashable.
 
-- Issue #2531: Comparison operations between floats and Decimal
+- Issue #2531: Comparison operations between floats and Decimal instances now
-  instances now return a result based on the numeric values of the
+  return a result based on the numeric values of the operands; previously they
-  operands;  previously they returned an arbitrary result based on
+  returned an arbitrary result based on the relative ordering of id(float) and
-  the relative ordering of id(float) and id(Decimal).
+  id(Decimal).
 
 - Issue #8233: When run as a script, py_compile.py optionally takes a single
-  argument `-` which tells it to read files to compile from stdin.  Each line
+  argument `-` which tells it to read files to compile from stdin.  Each line is
-  is read on demand and the named file is compiled immediately.  (Original
+  read on demand and the named file is compiled immediately.  (Original patch by
-  patch by Piotr Ożarowski).
+  Piotr Ożarowski).
 
-- Issue #3135: Add inspect.getcallargs, which binds arguments to a function
+- Issue #3135: Add ``inspect.getcallargs()``, which binds arguments to a
-  like a normal call.
+  function like a normal call.
 
 - Backwards incompatible change: Unicode codepoints line tabulation (0x0B) and
   form feed (0x0C) are now considered linebreaks, as specified in Unicode
-  Standard Annex #14.  See issue #7643.
+  Standard Annex #14.  See issue #7643.  http://www.unicode.org/reports/tr14/
-  http://www.unicode.org/reports/tr14/
 
-- Comparisons using one of <, <=, >, >= between a complex instance and
+- Comparisons using one of <, <=, >, >= between a complex instance and a
-  a Fractions instance now raise TypeError instead of returning
+  Fractions instance now raise TypeError instead of returning True/False.  This
-  True/False.  This makes Fraction <=> complex comparisons consistent with
+  makes Fraction <=> complex comparisons consistent with int <=> complex, float
-  int <=> complex, float <=> complex, and complex <=> complex comparisons.
+  <=> complex, and complex <=> complex comparisons.
 
 - Addition of ``WeakSet`` to the ``weakref`` module.
 
@@ -420,24 +414,24 @@ Library
 - Issue #7667: Fix doctest failures with non-ASCII paths.
 
 - Issue #7512: shutil.copystat() could raise an OSError when the filesystem
-  didn't support chflags() (for example ZFS under FreeBSD).  The error is
+  didn't support chflags() (for example ZFS under FreeBSD).  The error is now
-  now silenced.
+  silenced.
 
 - Issue #7703: ctypes supports both buffer() and memoryview().  The former is
   deprecated.
 
-- Issue #7860: platform.uname now reports the correct 'machine' type
+- Issue #7860: platform.uname now reports the correct 'machine' type when Python
-  when Python is running in WOW64 mode on 64 bit Windows.
+  is running in WOW64 mode on 64 bit Windows.
 
-- logging: Added getChild utility method to Logger and added isEnabledFor
+- logging: Added getChild utility method to Logger and added isEnabledFor method
-  method to LoggerAdapter.
+  to LoggerAdapter.
 
-- Issue #8201: logging: Handle situation of non-ASCII and Unicode
+- Issue #8201: logging: Handle situation of non-ASCII and Unicode logger names
-  logger names existing at the same time, causing a Unicode error
+  existing at the same time, causing a Unicode error when configuration code
-  when configuration code attempted to sort the existing loggers.
+  attempted to sort the existing loggers.
 
-- Issue #8200: logging: Handle errors when multiprocessing is not
+- Issue #8200: logging: Handle errors when multiprocessing is not fully loaded
-  fully loaded when logging occurs.
+  when logging occurs.
 
 - Issue #3890, #8222: Fix recv() and recv_into() on non-blocking SSL sockets.
   Also, enable the SSL_MODE_AUTO_RETRY flag on SSL sockets, so that blocking
@@ -447,26 +441,26 @@ Library
 
 - Issue #8024: Update the Unicode database to 5.2.
 
-- Issue #8104: socket.recv_into() and socket.recvfrom_into() now support
+- Issue #8104: socket.recv_into() and socket.recvfrom_into() now support writing
-  writing into objects supporting the new buffer API, for example bytearrays
+  into objects supporting the new buffer API, for example bytearrays or
-  or memoryviews.
+  memoryviews.
 
 - Issue #4961: Inconsistent/wrong result of askyesno function in tkMessageBox
   with Tcl/Tk-8.5.
 
-- Issue #8140: extend compileall to compile single files. Add -i option.
+- Issue #8140: Extend compileall to compile single files.  Add -i option.
 
-- Issue #7356: ctypes.util: Make parsing of ldconfig output independent of
+- Issue #7356: ctypes.util: Make parsing of ldconfig output independent of the
-  the locale.
+  locale.
 
-- Issue #7774: Set sys.executable to an empty string if ``argv[0]`` has been
+- Issue #7774: Set sys.executable to an empty string if ``argv[0]`` has been set
-  set to an non existent program name and Python is unable to retrieve the real
+  to an non existent program name and Python is unable to retrieve the real
   program name.
 
 - Issue #8117: logging: Improved algorithm for computing initial rollover time
-  for ``TimedRotatingFileHandler`` by using the modification time of an
+  for ``TimedRotatingFileHandler`` by using the modification time of an existing
-  existing log file to compute the next rollover time.  If the log file does
+  log file to compute the next rollover time.  If the log file does not exist,
-  not exist, the current time is used as the basis for the computation.
+  the current time is used as the basis for the computation.
 
 - Issue #6472: The ``xml.etree`` package is updated to ElementTree 1.3.  The
   cElementTree module is updated too.
@@ -500,8 +494,8 @@ Extension Modules
 - Issue #1039, #8154: Fix os.execlp() crash with missing 2nd argument.
 
 - Issue #8156: bsddb module updated to version 4.8.4.
-  http://www.jcea.es/programacion/pybsddb.htm#bsddb3-4.8.4.
+  http://www.jcea.es/programacion/pybsddb.htm#bsddb3-4.8.4.  This update drops
-  This update drops support for Berkeley DB 4.0, and adds support for 4.8.
+  support for Berkeley DB 4.0, and adds support for 4.8.
 
 - Issue #3928: os.mknod() now available in Solaris, also.
 
@@ -515,13 +509,13 @@ Extension Modules
 - Issue #1530559: When passing a non-integer argument to struct.pack with *any*
   integer format code (one of 'bBhHiIlLqQ'), struct.pack attempts to use the
   argument's __int__ method to convert to an integer before packing.  It also
-  produces a DeprecationWarning in this case.  (In Python 2.6, the behaviour
+  produces a DeprecationWarning in this case.  (In Python 2.6, the behaviour was
-  was inconsistent: __int__ was used for some integer codes but not for others,
+  inconsistent: __int__ was used for some integer codes but not for others, and
-  and the set of integer codes for which it was used differed between native
+  the set of integer codes for which it was used differed between native packing
-  packing and standard packing.)
+  and standard packing.)
 
-- Issue #7347: _winreg: Add CreateKeyEx and DeleteKeyEx, as well as fix a
+- Issue #7347: _winreg: Add CreateKeyEx and DeleteKeyEx, as well as fix a bug in
-  bug in the return value of QueryReflectionKey.
+  the return value of QueryReflectionKey.
 
 Tools/Demos
 -----------
@@ -535,12 +529,12 @@ Tools/Demos
 Build
 -----
 
-- Issue #8032: For gdb7, a python-gdb.py file is added to the build,
+- Issue #8032: For gdb7, a python-gdb.py file is added to the build, allowing to
-  allowing to use advanced gdb features when debugging Python.
+  use advanced gdb features when debugging Python.
 
-- Issue #1628484: The Makefile doesn't ignore the CFLAGS environment
+- Issue #1628484: The Makefile doesn't ignore the CFLAGS environment variable
-  variable anymore.  It also forwards the LDFLAGS settings to the linker
+  anymore.  It also forwards the LDFLAGS settings to the linker when building a
-  when building a shared library.
+  shared library.
 
 - Issue #6716: Quote -x arguments of compileall in MSI installer.
 
@@ -553,19 +547,19 @@ C-API
 -----
 
 - Issue #8276: PyEval_CallObject() is now only available in macro form.  The
-  function declaration, which was kept for backwards compatibility reasons,
+  function declaration, which was kept for backwards compatibility reasons, is
-  is now removed (the macro was introduced in 1997!).
+  now removed (the macro was introduced in 1997!).
 
-- Issue #7992: A replacement PyCObject API, PyCapsule, has been backported
+- Issue #7992: A replacement PyCObject API, PyCapsule, has been backported from
-  from Python 3.1.  All existing Python CObjects in the main distribution
+  Python 3.1.  All existing Python CObjects in the main distribution have been
-  have been converted to capsules.  To address backwards-compatibility
+  converted to capsules.  To address backwards-compatibility concerns,
-  concerns, PyCObject_AsVoidPtr() was changed to understand capsules.
+  PyCObject_AsVoidPtr() was changed to understand capsules.
 
 Tests
 -----
 
-- Issue #3864: Skip three test_signal tests on freebsd6 because they fail
+- Issue #3864: Skip three test_signal tests on freebsd6 because they fail if any
-  if any thread was previously started, most likely due to a platform bug.
+  thread was previously started, most likely due to a platform bug.
 
 - Issue #8348: Fix test ftp url in test_urllib2net.
 
@@ -583,8 +577,8 @@ Tests
 - Issue #8180 and #8207: Fix test_pep277 on OS X and add more tests for special
   Unicode normalization cases.
 
-- Issue #7783: test.test_support.open_urlresource invalidates the outdated
+- Issue #7783: test.test_support.open_urlresource invalidates the outdated files
-  files from the local cache.
+  from the local cache.
 
 
 What's New in Python 2.7 alpha 4?