From 6285ac97654fc72bddf24928981d52fd2fcacf80 Mon Sep 17 00:00:00 2001
From: Ben Darnell <ben@bendarnell.com>
Date: Sun, 5 Jul 2015 00:07:50 -0400
Subject: [PATCH] Start next-release notes

---
 docs/releases.rst      |  1 +
 docs/releases/next.rst | 63 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 64 insertions(+)
 create mode 100644 docs/releases/next.rst

diff --git a/docs/releases.rst b/docs/releases.rst
index dd6c54f9e..43c61887c 100644
--- a/docs/releases.rst
+++ b/docs/releases.rst
@@ -4,6 +4,7 @@ Release notes
 .. toctree::
    :maxdepth: 2
 
+   releases/next
    releases/v4.2.0
    releases/v4.1.0
    releases/v4.0.2
diff --git a/docs/releases/next.rst b/docs/releases/next.rst
new file mode 100644
index 000000000..a86588513
--- /dev/null
+++ b/docs/releases/next.rst
@@ -0,0 +1,63 @@
+What's new in the next version of Tornado
+=========================================
+
+In progress
+-----------
+
+Highlights
+~~~~~~~~~~
+
+* The new async/await keywords in Python 3.5 are supported. TODO: say more.
+
+`tornado.auth`
+~~~~~~~~~~~~~~
+
+* New method `.OAuth2Mixin.oauth2_request` can be used to make authenticated
+  requests with an access token.
+
+`tornado.autoreload`
+~~~~~~~~~~~~~~~~~~~~
+
+* Fixed an issue with the autoreload command-line wrapper in which
+  imports would be incorrectly interpreted as relative.
+
+`tornado.httputil`
+~~~~~~~~~~~~~~~~~~
+
+* `.HTTPHeaders` can now be pickled and unpickled.
+
+`tornado.iostream`
+~~~~~~~~~~~~~~~~~~
+
+* Coroutine-style usage of `.IOStream` now converts most errors into
+  `.StreamClosedError`, which has the effect of reducing log noise from
+  exceptions that are outside the application's control (especially
+  SSL errors).
+* `.StreamClosedError` now has a ``real_error`` attribute which indicates
+  why the stream was closed. It is the same as the ``error`` attribute of
+  `.IOStream` but may be more easily accessible than the `.IOStream` itself.
+
+`tornado.locale`
+~~~~~~~~~~~~~~~~
+
+* `tornado.locale.load_translations` now accepts encodings other than
+  UTF-8. UTF-16 and UTF-8 will be detected automatically if a BOM is
+  present; for other encodings `.load_translations` has an ``encoding``
+  parameter.
+
+`tornado.options`
+~~~~~~~~~~~~~~~~~
+
+* Dashes and underscores are now fully interchangeable in option names.
+
+`tornado.template`
+~~~~~~~~~~~~~~~~~~
+
+* `tornado.template.ParseError` now includes the filename in addition to
+  line number.
+
+`tornado.testing`
+~~~~~~~~~~~~~~~~~
+
+* `.ExpectLog` objects now have a boolean ``logged_stack`` attribute to
+  make it easier to test whether an exception stack trace was logged.
-- 
2.47.3