[OASIS Issue Tracker] (MQTT-491) Wording of 3.3.1.3 RETAIN

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ https://issues.oasis-open.org/browse/MQTT-491?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=66800#comment-66800 ] 

Ken Borgendale commented on MQTT-491:
-------------------------------------

a) The (are/is) is fixed in wd15.  You are expected to read the entire paragraph which goes on to say: "Which retained messages are sent is controlled by the Retain Handling Subscription Option" which is a modifier of the previous statement.  The statement that all such messages are sent with Retain=1 is still true.

b) The reference is to how the Subscription Options are specified, the bulleted list afterwards is about how the the retained message is processed.

c) Already fixed in wd15

d) Again, I would say the statement is clear in context.  The entire list is about which retained messages are sent when a subscription is made.  Certainly other retained messages are sent as the result of the subscription.

3) I agree that paragraph 2 in 3.2.2.3.4 (and its echo in Appendix B) should use the term retained messages as is used in paragraph 1 of the same section.


> Wording of 3.3.1.3 RETAIN
> -------------------------
>
>                 Key: MQTT-491
>                 URL: https://issues.oasis-open.org/browse/MQTT-491
>             Project: OASIS Message Queuing Telemetry Transport (MQTT) TC
>          Issue Type: Improvement
>          Components: edits
>    Affects Versions: wd14
>            Reporter: Peter Niblett
>            Priority: Minor
>
> The wording of some of the paragraphs in this section is a bit confusing (and has grammar errors)
> a) There are sentences which say "When a new Non-Shared Subscription is established, the last retained message, if any, on each matching topic name are sent to the Client.  These messages are sent with the RETAIN flag set to 1."  Neither of these statements is necessarily true as the behaviour now depends on the value of Retain Handling. Also "are sent" should be "is sent"
> b) These sentences are followed by  "Which retained messages are sent is controlled by the Retain Handling Subscription Option. Refer to section 3.8.3.1 for a definition of the Subscription Options." This is ok, except that they are immediately followed by a bulleted list describing the Retain Handling Subscription Option. It would flow better if "Refer to section 3.8.3.1 for a definition of the Subscription Options." were moved to after the bulletted list
> c) Second item in the bulleted list is "•	If Retain Handling is set to 1 and the subscription did not already exist, the Server MUST send all retained message matching the Topic Filter of the subscription to the Client [MQTT-3.3.1-10]." In this sentence "message" should be "messages".
> d) Third item in the bulleted list is "•	If Retain Handling is set to 2, the Server MUST NOT send retained messages at the time of the subscribe [MQTT-3.3.1-11]."  This is ambiguous. I think what it is trying to say is "MUST NOT send retained messages as a result of the subscription" or something like that.
> e) Also in 3.3.3.2.4 it says "If a Server receives a CONNECT packet containing a Will Message with the Will Retain 1, and it does not support retained publications..."  In most other places we talk about "retained messages" not "retained publications".



--
This message was sent by Atlassian JIRA
(v6.2.2#6258)