add missing parameter doc

Re-add google webmaster tools site verification code.

Set version number to 3.0.1

Make the websocket_connect error handling more comprehensive.

Now covers successful http responses that return a non-websocket body
and network errors that prevent a body from being returned.

Added a connect_timeout parameter to websocket_connect.

Merge pull request #707 from protoss-player/master

websocket_connect should not hang on HTTP errors

Update debug mode docs.

Add 3.0.1 release notes.

Merge pull request #704 from chrislea/master

Add check for ssl.CertificateError in netutil.py

HTTPResponse.request should always be an HTTPRequest, never a _RequestProxy.

Closes #718.

Merge pull request #720 from wsantos/facebook_future

Add future interface to FacebookGraphMixin

Add future interface to FacebookGraphMixin

Add an ioloop command line flag to the benchmark script.

Update pyuv test for latest version of pyuv and tornado-pyuv

Fix precedence of StringIO imports for LogTrapTestCase.

io.StringIO doesn't allow byte strings even on python 2, which causes
it to fail with the standard log formatter (but not tornado's "pretty
logging").

Closes #708.

tests: test for websocket_connect failure

Set the __test__ attribute on gen_test to False.

Without this, if a nose-using project imported gen_test nose would try
to run it as a test.

websocket_connect: don't hang on HTTP errors

Fix exceptions in the gen module to work correctly with tuple keys.

Previously this would result in a TypeError instead of the intended exception.

Merge branch 'branch3.0'

Copy the notice about dict-style access to options to the backwards-compat section.

add check for ssl.CertificateError

Include readme in the setup.py long_description field.

This should let pypi pick it up automatically on upload.

Bump version number in the master branch

Pypi's rst rendering doesn't like it when the same anchortext is reused
for different targets.

Set version number to 3.0

Finalize 3.0 release notes.

Downloads are now hosted on pypi instead of github.

Fix another broken link on readme.

Fix rst markup in readme

Replace the outdated README.md with a lightly-edited version of docs/index.rst

Update pypi description field.

Fix options.parse_config_file on Python 3.

Add a test for this function.

Closes #702.

Bump version to 3.0b2

Delete HTTPConnection._close_callback in between requests.

Previously the close callback would cause a reference to the previous
RequestHandler to be retained while waiting for the next request.

Fix error handling with the combination of @asynchronous and @gen.coroutine.

Also make self.finish() optional for coroutines since we can finish
if the future resolves successfully.

Fix draft76 websocket protocol; fix websocket demo for python 3.

Document tornado.concurrent.Future.

All internal links now point there instead of to concurrent.future.Futures.

Bump version number to 3.0b1

Convert auth demo to coroutines.

Move gen from "utilities" to "asynchronous networking"

Add/update docs for twisted, caresresolver, and util modules

Doc updates: modules starting with W.

Skip ThreadedResolver tests on pypy.

There seem to be problems with thread/signal interactions.

Doc updates, modules N-T.

Doc updates, modules H-L

Turn on dangling-reference warning in sphinx for local builds.

Reformat the HTTPFile docs where were causing odd reference errors.

Fix dangling references in old release notes.

Fix docstring for locale.load_translations.

When unicode strings started using the u() function, this string
was no longer considered a docstring.

Fix most of the rest of the dangling references.

Update chat demo to be more exemplary.

Use gen.coroutine in auth handler (but not in wait_for_messages
because it makes things less clear and we don't have good cancellation
support).  No more mixin.  Python 3 compatible.

Rewrite gen docs to make coroutine the primary decorator.

Fix dangling links in next.rst

Fix dangling references in recently-revised docs.

Turn on intersphinx support for links to the standard library.

Minor doc updates for modules A-E

Convert auth module code samples to use gen.coroutine.

Doc updates for the auth module.

Rename WebSocketConnect to websocket_connect.

Add docs for undocumented functions and modules.

Add new methods to docs, found by sphinx coverage extension.

Fix bad merge

Merge remote-tracking branch 'norman-labs/branch2.4'

Conflicts:
tornado/httputil.py

Merge pull request #695 from evanj/master

httpserver: If no X-Scheme header, use the normal request value.

httpserver: If no X-Scheme header, use the normal request value.

Previously, if xheaders is True and there are no X headers passed (e.g. when
developing locally), scheme was always "http". This makes in "http" or
"https", based on what was actually used for the request.

Add tests for the X-Scheme and X-Forwarded-Proto headers.

Rewrite text on index page.

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.