SIGNALS: document app.deferred? caveat for graceful shutdown

There doesn't appear to be a good/easy way to do this with
the built-in EventMachine thread pool :/

1 files changed, 5 insertions, 1 deletions

diff --git a/SIGNALS b/SIGNALS
index 14f2184..7b61172 100644
--- a/SIGNALS
+++ b/SIGNALS
@@ -14,7 +14,9 @@ between \Rainbows!, Unicorn and nginx.
 * INT/TERM - quick shutdown, kills all workers immediately
 
 * QUIT - graceful shutdown, waits for workers to finish their
-  current request before finishing.
+  current request before finishing.  This currently does not
+  wait for requests deferred to a separate thread when using
+  EventMachine (when app.deferred?(env) => true)
 
 * USR1 - reopen all logs owned by the master and all workers
   See Unicorn::Util.reopen_logs for what is considered a log.
@@ -43,6 +45,8 @@ automatically respawned.
 * QUIT - Gracefully exit after finishing the current request.
   Unless WINCH has been sent to the master (or the master is killed),
   the master process will respawn a worker to replace this one.
+  This currently does not wait for requests deferred to a separate
+  thread when using EventMachine (when app.deferred?(env) => true)
 
 * USR1 - Reopen all logs owned by the worker process.
   See Unicorn::Util.reopen_logs for what is considered a log.