Document websocket error handling change (and StreamClosedError).

diff --git a/docs/iostream.rst b/docs/iostream.rst
index a2933a8f24b71396aac047784258ec6cb74eabe1..a5e3869e355ee85cc506b8022447294007094fcf 100644 (file)
--- a/docs/iostream.rst
+++ b/docs/iostream.rst
@@ -43,3 +43,8 @@
 
    .. autoclass:: PipeIOStream
       :members:
+
+   Exceptions
+   ----------
+
+   .. autoexception:: StreamClosedError

diff --git a/docs/releases/next.rst b/docs/releases/next.rst
index 05ea57d65bbcfed090d5c9c612b61a569e9f2c32..a8d384b91b2893e68037eb1ab5926b4dd2aee6ae 100644 (file)
--- a/docs/releases/next.rst
+++ b/docs/releases/next.rst
@@ -229,6 +229,9 @@ Multiple modules
 `tornado.websocket`
 ~~~~~~~~~~~~~~~~~~~
 
+* `.WebSocketHandler` now catches `.StreamClosedError` and runs
+  `~.WebSocketHandler.on_close` immediately instead of logging a
+  stack trace.
 * New method `.WebSocketHandler.set_nodelay` can be used to set the
   ``TCP_NODELAY`` flag.
 

diff --git a/tornado/iostream.py b/tornado/iostream.py
index 9f9a1e60d87921bbfcf58d2ed3c670e54cdf3bb0..079012c9e41e67ea9173ab4bbf4ea9d94bdbb737 100644 (file)
--- a/tornado/iostream.py
+++ b/tornado/iostream.py
@@ -48,6 +48,12 @@ except ImportError:
 
 
 class StreamClosedError(IOError):
+    """Exception raised by `IOStream` methods when the stream is closed.
+
+    Note that the close callback is scheduled to run *after* other
+    callbacks on the stream (to allow for buffered data to be processed),
+    so you may see this error before you see the close callback.
+    """
     pass