Organize next-release notes.

diff --git a/website/sphinx/releases/next.rst b/website/sphinx/releases/next.rst
index 383a2004272f7a8fa3ceb6c0abbf560a5dd1b102..4cb967fd7c16306d3aad8abe57d1d6aaa3d6a2fb 100644 (file)
--- a/website/sphinx/releases/next.rst
+++ b/website/sphinx/releases/next.rst
@@ -4,43 +4,70 @@ What's new in the next release of Tornado
 In progress
 -----------
 
-* New class `tornado.testing.AsyncHTTPSTestCase` is like `AsyncHTTPTestCase`.
-  but enables SSL for the testing server (by default using a self-signed
-  testing certificate).
+General
+~~~~~~~
+
 * Fixed Python 3 bugs in `tornado.auth`, `tornado.locale`, and `tornado.wsgi`.
-* `tornado.locale` module now works on Python 3.
-* `RequestHandler.add_header` now works with `WSGIApplication`.
-* Fixed some Python 3 bugs in `tornado.wsgi` module.
-* ``{% break %}`` and ``{% continue %}`` can now be used in templates.
-* The logging configuration used in `tornado.options` is now more tolerant
-  of non-ascii byte strings.
-* Improved error handling in `SSLIOStream` and SSL-enabled `TCPServer`.
-* On Windows, `TCPServer` uses `SO_EXCLUSIVEADDRUSER` instead of `SO_REUSEADDR`.
-* `IOLoop.add_handler` cannot be called more than once with the same file
-  descriptor.  This was always true for ``epoll``, but now the other
-  implementations enforce it too.
-* `tornado.testing.main` now accepts additional keyword arguments and forwards
-  them to `unittest.main`.
-* `RequestHandler.get_secure_cookie` now handles a potential error case.
-* Fixed a bug introduced in 2.3 that would cause `IOStream` close callbacks
-  to not run if there were pending reads.
-* `RequestHandler.__init__` now calls ``super().__init__`` to ensure that
-  all constructors are called when multiple inheritance is used.
-* `OAuthMixin` now accepts ``"oob"`` as a ``callback_uri``.
-* `tornado.platform.twisted` shutdown sequence is now more compatible.
+
+HTTP clients
+~~~~~~~~~~~~
+
 * Removed ``max_simultaneous_connections`` argument from `tornado.httpclient`
   (both implementations).  This argument hasn't been useful for some time
   (if you were using it you probably want ``max_clients`` instead)
 * `tornado.simple_httpclient` now accepts and ignores HTTP 1xx status
   responses.
+
+`tornado.ioloop` and `tornado.iostream`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* Fixed a bug introduced in 2.3 that would cause `IOStream` close callbacks
+  to not run if there were pending reads.
+* Improved error handling in `SSLIOStream` and SSL-enabled `TCPServer`.
 * `SSLIOStream.get_ssl_certificate` now has a ``binary_form`` argument
   which is passed to ``SSLSocket.getpeercert``.
 * `SSLIOStream.write` can now be called while the connection is in progress,
   same as non-SSL `IOStream` (but be careful not to send sensitive data until
   the connection has completed and the certificate has been verified).
-* `OpenIDMixin` now also returns the ``claimed_id`` field for the user.
+* `IOLoop.add_handler` cannot be called more than once with the same file
+  descriptor.  This was always true for ``epoll``, but now the other
+  implementations enforce it too.
+* On Windows, `TCPServer` uses `SO_EXCLUSIVEADDRUSER` instead of `SO_REUSEADDR`.
+
+`tornado.template`
+~~~~~~~~~~~~~~~~~~
+
+* ``{% break %}`` and ``{% continue %}`` can now be used looping constructs
+  in templates.
+* It is no longer an error for an if/else/for/etc block in a template to
+  have an empty body.
+
+`tornado.testing`
+~~~~~~~~~~~~~~~~~
+
+* New class `tornado.testing.AsyncHTTPSTestCase` is like `AsyncHTTPTestCase`.
+  but enables SSL for the testing server (by default using a self-signed
+  testing certificate).
+* `tornado.testing.main` now accepts additional keyword arguments and forwards
+  them to `unittest.main`.
+
+`tornado.web`
+~~~~~~~~~~~~~
+
 * New method `RequestHandler.get_template_namespace` can be overridden to
   add additional variables without modifying keyword arguments to
   `render_string`.
-* It is no longer an error for an if/else/for/etc block in a template to
-  have an empty body.
+* `RequestHandler.add_header` now works with `WSGIApplication`.
+* `RequestHandler.get_secure_cookie` now handles a potential error case.
+* `RequestHandler.__init__` now calls ``super().__init__`` to ensure that
+  all constructors are called when multiple inheritance is used.
+
+
+Other modules
+~~~~~~~~~~~~~
+
+* `OAuthMixin` now accepts ``"oob"`` as a ``callback_uri``.
+* `OpenIDMixin` now also returns the ``claimed_id`` field for the user.
+* `tornado.platform.twisted` shutdown sequence is now more compatible.
+* The logging configuration used in `tornado.options` is now more tolerant
+  of non-ascii byte strings.