1
0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-24 10:12:19 -05:00

Merge branch 'premerge' into 'main'

Premerge

See merge request xsf/xeps!14
This commit is contained in:
Jonas Schäfer 2020-08-11 20:02:04 +00:00
commit f26d322d35

View File

@ -45,6 +45,12 @@
</schemaloc> </schemaloc>
<registry/> <registry/>
&stpeter; &stpeter;
<revision>
<version>1.33.0</version>
<date>2020-04-15</date>
<initials>mw</initials>
<remark><p>Clarify that the 307 status code should not be used alongside 333 for user disconnects.</p></remark>
</revision>
<revision> <revision>
<version>1.32.0</version> <version>1.32.0</version>
<date>2019-05-15</date> <date>2019-05-15</date>
@ -4930,7 +4936,8 @@
<section1 topic='Service Use Cases' anchor='service'> <section1 topic='Service Use Cases' anchor='service'>
<section2 topic='Service removes user because of error response' anchor='service-error-kick'> <section2 topic='Service removes user because of error response' anchor='service-error-kick'>
<p>A MUC service MAY support adding the 333 status code to presences when a user gets removed by the service due to a technical problem (e.g. s2s link failure).</p> <p>A MUC service MAY support adding the 333 status code to presences when a user gets removed by the service due to a technical problem (e.g. s2s link failure).
This can, for example, be used as a hint for clients to distinguish between an occupant getting disconnected and them intentionally leaving the room.</p>
<p>If a MUC service supports this OPTIONAL feature, it MUST include the 333 status code in the resulting presence:</p> <p>If a MUC service supports this OPTIONAL feature, it MUST include the 333 status code in the resulting presence:</p>
<example caption='MUC service removes user because of error'><![CDATA[ <example caption='MUC service removes user because of error'><![CDATA[
<presence <presence
@ -4940,7 +4947,6 @@
<x xmlns='http://jabber.org/protocol/muc#user'> <x xmlns='http://jabber.org/protocol/muc#user'>
<item affiliation='none' role='none' /> <item affiliation='none' role='none' />
<status code='110'/> <status code='110'/>
<status code='307'/>
<status code='333'/> <status code='333'/>
</x> </x>
</presence> </presence>
@ -4953,11 +4959,14 @@
type='unavailable'> type='unavailable'>
<x xmlns='http://jabber.org/protocol/muc#user'> <x xmlns='http://jabber.org/protocol/muc#user'>
<item affiliation='none' role='none'/> <item affiliation='none' role='none'/>
<status code='307'/>
<status code='333'/> <status code='333'/>
</x> </x>
</presence> </presence>
]]></example> ]]></example>
<p>Note: Some server implementations additionally include a 307 status code (signifying a 'kick', i.e. a forced ejection from the
room). This is generally not advisable, as these types of disconnects may be frequent in the presence of poor network conditions
and they are not linked to any user (e.g. moderator) action that the 307 code usually indicates. It is therefore recommended for the
client to ignore the 307 code if a 333 status code is present.</p>
</section2> </section2>
</section1> </section1>