Changes between and of Initial VersionVersion 2Ticket #5775

Show
Ignore:
Timestamp:
07/13/2012 02:13:01 AM (10 months ago)
Author:
cyli
Comment:

Legend:

Unmodified
Added
Removed
Modified

  • Ticket #5775

    • Property keywords documentation added

  • Ticket #5775 – description

    initial v2  
    11[http://twistedmatrix.com/documents/current/api/twisted.internet.defer.DeferredList.html `The documentation for DeferredList`] makes mention of the DeferredList changing what callbacks/errbacks on the individual Deferreds can see, but fails to elaborate on why. 
    22 
    3 The `consumeErrors` paramter description is also confusingly worded, with alternating usage of the terms "included Deferreds" and "individual Deferreds".  In addition, some examples (or given the different parameters `DeferredList` takes, perhaps a table) would help readers understand the behaviour better. 
     3The `consumeErrors` parameter's description is also confusingly worded, with alternating usage of the terms "included Deferreds" and "individual Deferreds".  Some examples (or given the different parameters `DeferredList` takes, perhaps a table) would help readers understand the behaviour better. 
    44 
    5 [http://twistedmatrix.com/documents/current/api/twisted.internet.defer.html#gatherResults The documentation for gatherResults`] is just as bad, but in addition, it does not mention that `gatherResults` is implemented with `DeferredList` with `fireOnFirstError` set to True, and thus the `Failure` that is returned will be a `FirstError`. 
     5[http://twistedmatrix.com/documents/current/api/twisted.internet.defer.html#gatherResults The documentation for `gatherResults`] has the wording.  In addition, it does not mention that `gatherResults` is implemented with `DeferredList` with `fireOnFirstError` set to True, and thus that the `Failure` that is returned will be a `FirstError`.