XEP-0402: Add a section on how to subscribe to notifications, as per XEP-0163.

This commit is contained in:
Emmanuel Gil Peyrot 2019-09-28 19:28:37 +02:00
parent b2cfc92a6f
commit 67457dd40e
1 changed files with 16 additions and 1 deletions

View File

@ -115,6 +115,21 @@
<section1 topic='Workflow' anchor='workflow'>
<section2 topic='Registering to notifications' anchor='enable-updates'>
<p>A client interested in bookmarks SHOULD include the 'urn:xmpp:bookmarks:0+notify' feature in its &xep0115;, as per &xep0163;, so that it receives notifications for updates done by other clients of the user, and react accordingly. The actual notifications are explained in the <link url='#notifications'>Bookmark Notifications</link> section of this specification.</p>
<example caption='Client replies with +notify to a XEP-0030 query from its server'><![CDATA[
<iq from='juliet@capulet.lit/balcony' to='capulet.lit' type='result' id='disco1'>
<query xmlns='http://jabber.org/protocol/disco#info'>
<identity category='client' type='pc' name='poezio'/>
<feature var='http://jabber.org/protocol/disco#info'/>
<feature var='urn:xmpp:bookmarks:0+notify'/>
<!---->
</query>
</iq>
]]></example>
</section2>
<section2 topic='Retrieving all bookmarks' anchor='retrieving-bookmarks'>
<example caption='Client retrieves all bookmarks'><![CDATA[
<iq from='juliet@capulet.lit/balcony' type='get' id='retrieve1'>
@ -213,7 +228,7 @@
</section1>
<section1 topic="Bookmark Notifications">
<section1 topic="Bookmark Notifications" anchor='notifications'>
<p>When a client is sent an event from the Pubsub service for the '&namespace;' node, it MUST check the 'autojoin' attribute if present, and join the room immediately if the attribute is both present and true.</p>
<example caption='Client receives a new bookmark notification'><![CDATA[