Documentation: clarify that callback() may return before callback chain is complete
|Reported by:||jrennie||Owned by:|
(diff, github, buildbot, log)
This ticket simply requests that documentation for the callback and errback methods of twisted.internet.defer.Deferred clarify when they will return. As currently written, a programmer might assume that these methods will not return until the chain has completed. In fact, the methods will return as soon as they run into a Deferred-returning function in the chain. 'course, it's probably best to provide no guarantees as to when these functions will return in case the Twisted implementation changes.