Refactor wait_for_reactor tests so they can be reused with similar APIs.
Start providing a wait_for(timeout) decorator.
Timeout functionality of wait_for() decorator.
Deprecate APIs that block indefinitely: wait_for_reactor and EventualResult.wait(timeout=None).
Switch examples to new API.
Merge remote-tracking branch 'origin/master' into timeouts-by-default-36
Update documentation with the new API.
Document new API in the changelog.
Remove explanations about how to implement high-level timeouts, since that's now built-in.
Get rid of timeouts example, choose initial example that benefits more from Twisted and the new wait_for API.
Typo in docstring.
Better run_in_reactor explanation.
Merge pull request #40 from itamarst/timeouts-by-default-36

wait_for() decorator, replacing wait_for_reactor().

Fixes #36.