From: Ben Darnell <ben@bendarnell.com>
Date: Sun, 21 Sep 2014 16:06:00 +0000 (-0400)
Subject: Document Tornado's incompatibility with asyncio.ProactorEventLoop.
X-Git-Tag: v4.1.0b1~82
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9e5430d6fa177e8bab1c225ac52e71e1697ae16f;p=thirdparty%2Ftornado.git

Document Tornado's incompatibility with asyncio.ProactorEventLoop.

Closes #1201.
---

diff --git a/docs/asyncio.rst b/docs/asyncio.rst
index d09650661..06dc44c32 100644
--- a/docs/asyncio.rst
+++ b/docs/asyncio.rst
@@ -15,6 +15,12 @@ default ``asyncio`` event loop.  Applications that need to run event
 loops on multiple threads may use `AsyncIOLoop` to create multiple
 loops.
 
+.. note::
+
+   Tornado requires the `~asyncio.BaseEventLoop.add_reader` family of methods,
+   so it is not compatible with the `~asyncio.ProactorEventLoop` on Windows.
+   Use the `~asyncio.SelectorEventLoop` instead.
+
 .. py:class:: AsyncIOMainLoop
 
     ``AsyncIOMainLoop`` creates an `.IOLoop` that corresponds to the