Update docs for v0.15.x

Author: edschofield

docs/standard_library_imports.rst

@@ -86,14 +86,22 @@ Aliased imports
 ~~~~~~~~~~~~~~~
 
 The following 14 modules were refactored or extended from Python 2.6/2.7 to 3.x
-but were neither renamed nor were the new APIs backported. The ``future``
-package makes the Python 3.x APIs available on Python 2.x as follows::
+but were neither renamed in Py3.x nor were the new APIs backported to Py2.x.
+This precludes compatibility interfaces that work out-of-the-box. Instead, the
+``future`` package makes the Python 3.x APIs available on Python 2.x as
+follows::
 
     from future.standard_library import install_aliases
     install_aliases()
 
     from collections import UserDict, UserList, UserString
 
+    import urllib.parse
+    import urllib.request
+    import urllib.response
+    import urllib.robotparser
+    import urllib.error
+
     import dbm
     import dbm.dumb
     import dbm.gnu                # requires Python dbm support
@@ -107,12 +115,10 @@ package makes the Python 3.x APIs available on Python 2.x as follows::
 
     import test.support
 
-    import urllib.error
-    import urllib.parse
-    import urllib.request
-    import urllib.response
-    import urllib.robotparser
 
+The newly exposed ``urllib`` submodules are full backports of those from Py3.x.
+This means, for example, that ``urllib.parse.unquote()`` now exists and takes
+an optional ``encoding`` argument on Py2.x as it does on Py3.x.
 
 Backports also exist of the following features from Python 3.4:
 
@@ -122,7 +128,7 @@ Backports also exist of the following features from Python 3.4:
 - ``collections.ChainMap``     (for all versions prior to Python 3.3)
 - ``itertools.count``          (for Python 2.6, with step parameter)
 - ``subprocess.check_output``  (for Python 2.6)
-- ``reprlib.recursive_repr``
+- ``reprlib.recursive_repr``   (for Python 2.6 and 2.7)
 
 These can then be imported on Python 2.6+ as follows::
 

docs/whatsnew.rst

@@ -5,20 +5,26 @@ What's New
 
 .. _whats-new-0.14.x:
 
-What's new in version 0.14.4 (2015-07-25)
+What's new in version 0.15.0 (2015-07-25)
 =========================================
 
-This is primarily a bug-fix release. It adds some minor new backward-compatible features and
-fixes several bugs.
+This release fixes compatibility bugs with CherryPy's Py2/3 compat layer and
+the latest version of the ``urllib3`` package. It also adds some additional
+backports for Py2.6 and Py2.7 from Py3.4's standard library.
 
-Minor features:
+New features:
 
+- ``install_aliases()`` now exposes full backports of the Py3 urllib submodules
+  (``parse``, ``request`` etc.) from ``future.backports.urllib`` as submodules
+  of ``urllib`` on Py2.  This implies, for example, that
+  ``urllib.parse.unquote`` now takes an optional encoding argument as it does
+  on Py3. This improves compatibility with CherryPy's Py2/3 compat layer (issue
+  #158).
 - ``tkinter.ttk`` support (issue #151)
-- ``collections.ChainMap`` backport (issue #150)
-- ``itertools.count`` backport for Py2.6 (issue #152)
+- Backport of ``collections.ChainMap`` (issue #150)
+- Backport of ``itertools.count`` for Py2.6 (issue #152)
 - Add constants to ``http.client`` such as ``HTTP_PORT`` and ``BAD_REQUEST`` (issue #137)
-- ``reprlib.recursive_repr`` backport for Py2
-- Update backports of ``Counter`` and ``OrderedDict`` to use Py3.4 implementations. This fixes ``.copy()`` for subclasses etc.
+- Backport of ``reprlib.recursive_repr`` to Py2
 
 Bug fixes:
 
@@ -28,6 +34,8 @@ Bug fixes:
 - Fix newrange slicing for some slice/range combos (issue #132, thanks to Brad Walker)
 - Small doc fixes (thanks to Michael Joseph and Tim Tröndle)
 - Improve robustness of test suite against opening .pyc files as text on Py2
+- Update backports of ``Counter`` and ``OrderedDict`` to use the newer
+  implementations from Py3.4. This fixes ``.copy()`` preserving subclasses etc.
 
 
 What's new in version 0.14.3 (2014-12-15)