Document the limitations of multi-process mode.

Closes #65.

diff --git a/tornado/httpserver.py b/tornado/httpserver.py
index dc61382981f8b6d85b2caf9fddef9670a7cf16d1..f5d5da67f065edb3da5e8bce49a0c93f450a76cc 100644 (file)
--- a/tornado/httpserver.py
+++ b/tornado/httpserver.py
@@ -184,6 +184,11 @@ class HTTPServer(object):
 
         Since we use processes and not threads, there is no shared memory
         between any server code.
+
+        Note that multiple processes are not compatible with the autoreload
+        module (or the debug=True option to tornado.web.Application).
+        When using multiple processes, no IOLoops can be created or
+        referenced until after the call to HTTPServer.start(n).
         """
         assert not self._started
         self._started = True