kennethreitz/requests — pull request #2187 by kevinburke (2014-08-29 18:36:44+00:00)
Title: Document Timeout behavior

Adds better documentation of `timeout` behavior

- "How long to wait for the server to send data before giving up, as a float, or a (connect timeout, read timeout) tuple." was as short as I could get to accurately describe the behavior.

- Sphinx puts the description of timeouts on the line below the parameter name, but this is not true for other parameters. I'm curious why this is but I can't see any differences.

- We don't use the `stream` parameter anywhere in the `adapters.send` method, so I removed the "Behavior" section that described the behavior of requests incorrectly.