Update next-release notes

diff --git a/docs/releases/next.rst b/docs/releases/next.rst
index 8cf004d8a599c182bec0903124ff4a1d10c360ba..28353b4969fa935097d3f8e4338f4ad16991a0d5 100644 (file)
--- a/docs/releases/next.rst
+++ b/docs/releases/next.rst
@@ -14,7 +14,13 @@ Backwards-compatibility notes
   `.IOStream` and ``simple_httpclient``, but not ``curl_httpclient``.
 * The default SSL configuration has become stricter, using
   `ssl.create_default_context` where available.
+* The deprecated classes in the `tornado.auth` module, ``GoogleMixin``,
+  ``FacebookMixin``, and ``FriendFeedMixin`` have been removed.
 
+`tornado.autoreload`
+~~~~~~~~~~~~~~~~~~~~
+
+* Improved compatibility with Windows.
 
 `tornado.gen`
 ~~~~~~~~~~~~~
@@ -22,6 +28,17 @@ Backwards-compatibility notes
 * On Python 3, catching an exception in a coroutine no longer leads to
   leaks via ``Exception.__context__``.
 
+`tornado.httpclient`
+~~~~~~~~~~~~~~~~~~~~
+
+* The ``raise_error`` argument now works correctly with the synchronous
+  `.HTTPClient`.
+
+`tornado.httpserver`
+~~~~~~~~~~~~~~~~~~~~
+
+* `.HTTPServer` is now a subclass of `tornado.util.Configurable`.
+
 `tornado.ioloop`
 ~~~~~~~~~~~~~~~~
 
@@ -33,6 +50,28 @@ Backwards-compatibility notes
 
 * ``SSLIOStream.connect`` and `.IOStream.start_tls` now validate certificates
   by default.
+* New method `.SSLIOStream.wait_for_handshake` allows server-side applications
+  to wait for the handshake to complete in order to verify client certificates
+  or use NPN/ALPN.
+* The `.Future` returned by ``SSLIOStream.connect`` now resolves after the
+  handshake is complete instead of as soon as the TCP connection is
+  established.
+* Reduced logging of SSL errors.
+* `.BaseIOStream.read_until_close` now works correctly when a
+  ``streaming_callback`` is given but ``callback`` is None (i.e. when
+  it returns a `.Future`)
+
+`tornado.locale`
+~~~~~~~~~~~~~~~~
+
+* New method `.GettextLocale.pgettext` allows additional context to be
+  supplied for gettext translations.
+
+`tornado.locks`
+~~~~~~~~~~~~~~~
+
+* New module contains locking and synchronization functionality imported
+  from `Toro <http://toro.readthedocs.org>`_.
 
 `tornado.log`
 ~~~~~~~~~~~~~
@@ -40,15 +79,34 @@ Backwards-compatibility notes
 * `.define_logging_options` now works correctly when given a non-default
   ``options`` object.
 
+`tornado.process`
+~~~~~~~~~~~~~~~~~
+
+* New method `.Subprocess.wait_for_exit` is a coroutine-friendly
+  version of `.Subprocess.set_exit_callback`.
+
 ``tornado.simple_httpclient``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 * Improved performance on Python 3 by reusing a single `ssl.SSLContext`.
 
+`tornado.queues`
+~~~~~~~~~~~~~~~~
+
+* New module contains queues imported from `Toro
+  <http://toro.readthedocs.org>`_.
+
+`tornado.tcpserver`
+~~~~~~~~~~~~~~~~~~~
+
+* `.TCPServer.handle_stream` may be a coroutine (so that any exceptions
+  it raises will be logged).
+
 `tornado.util`
 ~~~~~~~~~~~~~~
 
 * `.import_object` now supports unicode strings on Python 2.
+* `.Configurable.initialize` now supports positional arguments.
 
 `tornado.web`
 ~~~~~~~~~~~~~
@@ -56,6 +114,16 @@ Backwards-compatibility notes
 * Passing ``secure=False`` or ``httponly=False`` to
   `.RequestHandler.set_cookie` now works as expected (previously only the
   presence of the argument was considered and its value was ignored).
+* Parsing of the ``If-None-Match`` header now follows the RFC and supports
+  weak validators.
+* `.RequestHandler.get_arguments` now requires that its ``strip`` argument
+  be of type bool. This helps prevent errors caused by the slightly dissimilar
+  interfaces between the singular and plural methods.
+* Errors raised in ``_handle_request_exception`` are now logged more reliably.
+* `.RequestHandler.redirect` now works correctly when called from a handler
+  whose path begins with two slashes.
+* Passing messages containing ``%`` characters to `tornado.web.HTTPError`
+  no longer causes broken error messages.
 
 `tornado.websocket`
 ~~~~~~~~~~~~~~~~~~~

diff --git a/tornado/locale.py b/tornado/locale.py
index 57faa295abf5439a1d27fb8138422400bc8b6f87..a668765bbc4c6a57f8fd24120a63f03bad8f84d8 100644 (file)
--- a/tornado/locale.py
+++ b/tornado/locale.py
@@ -471,6 +471,8 @@ class GettextLocale(Locale):
         of `load_gettext_translations` sequence::
 
             xgettext [basic options] --keyword=pgettext:1c,2 --keyword=pgettext:1c,2,3
+
+        .. versionadded:: 4.2
         """
         if plural_message is not None:
             assert count is not None