XEP-0402: Actually add retraction notifications.

PubSub §7.2.2.1 says “If no error occurs and the <retract/> element
included a 'notify' attribute with a value of "true" or "1", then the
service MUST delete the item and MUST notify all subscribers as shown
below.”

This means the publishing entity, not the server or the subscription
state, is responsible for properly enabling notifications to other
resources, which makes no sense.

See https://xmpp.org/extensions/xep-0060.xml#publisher-delete-success-notify
This commit is contained in:
Emmanuel Gil Peyrot 2019-09-28 00:12:41 +02:00
parent 0e4f8b72ac
commit 77e0b01c92
1 changed files with 2 additions and 1 deletions

View File

@ -194,11 +194,12 @@
<section2 topic='Removing a bookmark' anchor='removing-a-bookmark'>
<p>Removing a bookmark means retracting an existing item, identified by the bookmark's JID, form the '&namespace;' node.</p>
<p>This implies that server support for the "delete-items" pubsub feature is REQUIRED.</p>
<p>A 'notify' attribute SHOULD be included on the &lt;retract/&gt; element in order to inform other online clients of the deletion.</p>
<example caption='Client removes a new bookmark'><![CDATA[
<iq from='juliet@capulet.lit/balcony' type='set' id='remove-bookmark1'>
<pubsub xmlns='http://jabber.org/protocol/pubsub'>
<retract node='urn:xmpp:bookmarks:0'>
<retract node='urn:xmpp:bookmarks:0' notify='true'>
<item id='theplay@conference.shakespeare.lit'/>
</retract>
</pubsub>