[jira] [Created] (PROTON-2060) [Documentation] The documentation for the sender auto-settle option needs clarification

["Andrew Stitcher (JIRA)" <ji...@apache.org>]

Andrew Stitcher created PROTON-2060:
---------------------------------------

             Summary: [Documentation] The documentation for the sender auto-settle option needs clarification
                 Key: PROTON-2060
                 URL: https://issues.apache.org/jira/browse/PROTON-2060
             Project: Qpid Proton
          Issue Type: Improvement
            Reporter: Andrew Stitcher


The current documentation is silent about the details of when the sender automatically settles. It is significant that sender settlement only happens when the sender receives a receiver settle.

The sender *should not* settle after only receiving a terminal status disposition with no settle flag, as then there would then be no way to receive any further events for that delivery (such as the subsequent on_settle message that might be expected when the receiver finally settles the message).

So the documentation for each language binding (and for the Proton API itself) should specify that  sender auto-settlement only occurs for a delivery after the sender receives a settled disposition for that delivery.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org