Uploaded image for project: 'Qpid Proton'
  1. Qpid Proton
  2. PROTON-2060

[Documentation] The documentation for the sender auto-settle option needs clarification

    XMLWordPrintableJSON

    Details

    • Type: Improvement
    • Status: Open
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: None
    • Labels:
      None

      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.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                Unassigned
                Reporter:
                astitcher Andrew Stitcher
              • Votes:
                0 Vote for this issue
                Watchers:
                1 Start watching this issue

                Dates

                • Created:
                  Updated: