[PROTON-2060] [docs] The documentation for the sender auto-settle option needs clarification

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: documentation
• Assignee: Unassigned
• Reporter: Andrew Stitcher
• Created: 03/Jun/19 21:27
• Updated: 23/Feb/22 17:58

Description

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.

Issue Links

• relates to: PROTON-2056 [proton-python] on_settled callback not called when disposition arrives in 2 frames