From c4413f5b636da2ac00d1d4d56805bc38d65ba47c Mon Sep 17 00:00:00 2001 From: Ben Darnell Date: Thu, 26 Aug 2010 11:31:54 -0700 Subject: [PATCH] Document the fact that add_handlers should only be called once for each host_pattern. --- tornado/web.py | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/tornado/web.py b/tornado/web.py index f0bfaaff..a8e1b6c7 100644 --- a/tornado/web.py +++ b/tornado/web.py @@ -1018,7 +1018,13 @@ class Application(object): autoreload.start() def add_handlers(self, host_pattern, host_handlers): - """Appends the given handlers to our handler list.""" + """Appends the given handlers to our handler list. + + Note that host patterns are processed sequentially in the + order they were added, and only the first matching pattern is + used. This means that all handlers for a given host must be + added in a single add_handlers call. + """ if not host_pattern.endswith("$"): host_pattern += "$" handlers = []