update the statement of testing if a handler is a list or tuple

Build pdfs from documentation.rst, not index.rst

Just skip all timing-sensitive tests on travis-ci.

Fix internal links for pdf output.

Fix sphinx config in its new home, restore Makefile and custom css.

Move website/sphinx/ to docs/, remove rest of appengine website dir.

Merge branch 'branch2.4'

Add favicon to sphinx config

Merge branch 'branch2.4'

Add a max-width for body text to match the appengine site

Get the tricky parts of the sphinx conversion working.

Add a sphinx/rst version of the tornadoweb.org index page. (WIP)

sphinx: Set the html_theme variable explicitly.

This should let our custom css show on readthedocs.org.

Relax a timing sensitive test that fails occasionally on travis-ci

Update release notes

sphinx: Set the html_theme variable explicitly.

This should let our custom css show on readthedocs.org.

travis.yml: skip caresresolver test on pypy.

Fix the inevitable typos in .travis.yml.

Fix TwistedIOLoop on python 2.6.

Rewrite travis.yml to make it simpler and more comprehensive.

Unlike tox, travis never reuses virtualenvs so setup/install time dominates.
Each test configuration only takes a few seconds once everything is
installed, so it's better to run fewer environments with lots of tests
in each.

This reduces the configuration to 10 environments (two for each python version,
with and without dependencies installed).  All tests are run in every
environment where they can run (unlike the tox config, which has many
variants that only run under py27)

On python 3, json_encode no longer supports byte strings as input.

This matches the behavior of the underlying json library.
recursive_unicode was more expensive than the actual json encoding for
complex structures, and was useless on python 2.

Use native strings instead of byte strings for oauth responses.

Capture the stack context of gen callbacks as they are generated.

This guards against functions that add their own stack context
without wrapping their callbacks.

Use _try_inline_read instead of _read_from_buffer in read_until_close.

Closes #686.

Update and expand travis.yml.

This should cover everything from tox.ini

Re-apply autopep8.

Update import_test.

(although I think autoreload is the last module left with no real test
coverage)

Pyflakes cleanups.

Fix type check that pep8 complains about.

Organize release notes and add highlights section.

Introduce TracebackFuture and use it where applicable.

This allows for better tracebacks when using Futures on Python 2.

When @return_future's callback is run with no args, don't pass an arg to client callback.

Allow the callback in @return_future to be run with no arguments.

Bump version to 2.4.post4

return_future and friends now pass the result, not the Future, to the callback.

Functions and decorators that take an optional callback and return
a future (return_future, gen.concurrent, and run_executor) no longer pass
the Future object to the callback.  This results in somewhat less flexible
error handling, but is more consistent with prevailing practice without
Futures.

Use autoescape in websocket chat demo.

Autoescaping is now the default, so remove the explicit setting in chatdemo.

Use distinct cookie names across all the demo apps.

Use autoescape in blog demo.

Remove embedded copy of markdown.py from blog demo.

Use autoescape in appengine blog demo.

Remove markdown support from app engine blog demo.

Modernize app engine demo: py27, non-CGI interface, get_template_namespace.

Upgrade requirement packages.

Upgrades are available for tox and virtualenv, but don't work for me
because of https://github.com/pypa/virtualenv/issues/366 (to be fixed
in virtualenv 1.9).

Release note updates

All functions that take an IOLoop default to current() instead of instance().

This means among other things that it's no longer necessary to pass
IOLoops explicitly in tests.

Add IOLoop.run_sync convenience method.

Test the IOLoop.current method and add it to TwistedIOLoop.

Make DummyFuture class private.

It's now only exposed and used when concurrent.futures is not available.

Fix twisted version check.

Merge pull request #686 from omribahumi/master

Flushing the buffer when calling IOStream.read_until_close()

Fix resolver test script.

Convert resolvers to @gen.coroutine.

This adds a requirement that there be a "current" IOLoop, which introduced
a few ripples.

Test twisted and cares resolvers in netutil_test.

Convert auth methods from return_future plus gen.engine to gen.coroutine.

Add @gen.coroutine and gen.Return for future-based (and py33-style) coroutines.

Python3 compatibility for test_streaming_callback_with_data_in_buffer

Added test_streaming_callback_with_data_in_buffer to iostream_test.py

Flushing the buffer when calling IOStream.read_until_close()

Ran into this when calling IOStream.read_until_close() after calling
IOStream.read_until("\r\n"), leaving data in the buffer.

Accumulated release note updates.

Simplify the Resolver interface.

Most callers do not need the full generality of getaddrinfo, and
most alternative resolver implementations cannot provide it.

Add a resolver test script for external queries that cannot be unittested.

Note an issue with CaresResolver (it cannot resolve www.dropbox.com when
family==AF_UNSPEC)

Add a c-ares-based resolver implementation.

Move HTTPServer's valid_ip function to netutil.

Add a test that runs TwistedIOLoop on top of TornadoReactor.

This exposed a few more small bugs.

Add TwistedResolver for non-threaded async DNS resolution.

If a @return_future function raises immediately, don't run the callback.

stack_context.wrap() the callback passed in to a @return_future function.

Move fallback exception raising in AsyncTestCase from run() to tearDown().

This allows the exception to be reported as a test failure instead of
making the test run blow up.

Add a test case for the synchronous HTTPClient.

Clean up more timeouts when shutting down HTTP clients or finishing tests.

Merge pull request #684 from vkosh/master

Remove timeout callback on errors during connect or request.

Remove timeout callback on errors during connect or request.

Test the @return_future return value assertion and move it again.

Exceptions in a @return_future function go to both the caller and the Future.

Add a test for the UnboundLocal error seen here and remove the
no-longer-needed initialization.  I'm not 100% sure we want to do both
(due to the risk of callback-doubling), but the old way where the caller
saw one error and the future resolved to a different error was clearly
incorrect, and leaving the future unresolved doesn't seem right either.

Merge pull request #683 from vkosh/master

Unshadow list built-in in httputil.HTTPHeaders.get_all()

Fix docstrings quoting.

Rename local var so it doesn't shadow the "list" built-in.

Add pypi classifiers so we'll show up on python3-compatible lists.

Ensure the result variable is initialized even when an exception is handled.

Make Resolver's callback argument optional when the Future result is used.

Make Resolver Configurable and test with a threaded resolver.

Add a future-based interface to AsyncHTTPClient.fetch.

simple_httpclient._HTTPConnection now takes a resolver directly.

This makes the "client" parameter optional for websocket connections.

Make simple_httpclient's hostname_mapping a Resolver wrapper.

Add a test for simple_httpclient's hostname_mapping.

Centralize some shared logic bewteen HTTPClient implementations.

Use the future interface internally for _oauth_get_user.

Added a new method _oauth_get_user_future because the old method was
de facto public for third-party auth plugins.

Add future interface to most of the rest of the auth module.

_oauth_get_user still uses callbacks internally, and I haven't
changed the old deprecated FacebookMixin.

Add a Future-based interface to tornado.auth's twitter_request.

This allows new clients to receive exception messages from failed
requests, without breaking compatibility with existing callback-based
clients.

Factor argument replacement logic out of @return_future

Add autobahn tests for client side of websockets.

Add a simple websocket client and unittest

Add a test for subprocess with stderr as a separate stream

Merge pull request #682 from martynsmith/patch-1

Fix typo in stream setup for stderr

Use xrange instead of range on python 2.

Closes #681.

Fix typo in stream setup for stderr

s/xrange/range/ for python 3.

Closes #681.

Add an assertion for inconsistent StackContexts when used with generators.

Add a tox config for testing with the pyuv-based IOLoop.