XEP-0402: Specify what clients should do if autojoin='0' in bookmark …

…notifications
guusdk · Aug 23, 2024 · c1a1c84 · c1a1c84
1 parent 90c887a
commit c1a1c84
Showing 1 changed file with 23 additions and 0 deletions.
diff --git a/xep-0402.xml b/xep-0402.xml
@@ -29,6 +29,12 @@
         <discuss>standards</discuss>
         &dcridland;
         &jcbrand;
+        <revision>
+          <version>1.2.0</version>
+          <date>2024-08-15</date>
+          <initials>mye</initials>
+          <remark><p>Encourage clients to immediately leave the room if they receive a bookmark notification with autojoin set to false</p></remark>
+        </revision>
         <revision>
           <version>1.1.4</version>
           <date>2023-04-02</date>
@@ -380,6 +386,23 @@
     </items>
   </event>
 </message>
+]]></example>
+
+        <p>If the bookmark notification's 'autojoin' attribute is set to false, the client SHOULD leave the room immediately.</p>
+
+        <example caption='Client receives a bookmark notification with autojoin=&#39;false&#39; (its default value)'><![CDATA[
+<message from='[email protected]' to='[email protected]/balcony' type='headline' id='unjoined-room1'>
+  <event xmlns='http://jabber.org/protocol/pubsub#event'>
+    <items node=']]>&namespace;<![CDATA['>
+      <item id='[email protected]'>
+        <conference xmlns=']]>&namespace;<![CDATA['
+                    name='The Play&apos;s the Thing'>
+          <nick>JC</nick>
+        </conference>
+      </item>
+    </items>
+  </event>
+</message>
 ]]></example>
 
         <p>On the other hand, if the event is a retract notification, the client SHOULD leave the room immediately.</p>