1
0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-21 08:45:04 -05:00

XEP-0045: Typo and whitespace fixes

This commit is contained in:
Sam Whited 2016-12-03 10:18:14 -06:00
parent ff0ef6d212
commit 337e41f925

View File

@ -45,6 +45,14 @@
</schemaloc> </schemaloc>
<registry/> <registry/>
&stpeter; &stpeter;
<revision>
<version>1.27.1</version>
<date>2016-12-03</date>
<initials>XEP Editor: ssw</initials>
<remark>
<p>Editorial typo and whitespace fixes.</p>
</remark>
</revision>
<revision> <revision>
<version>1.27</version> <version>1.27</version>
<date>2016-10-29</date> <date>2016-10-29</date>
@ -52,7 +60,6 @@
<remark> <remark>
<ul> <ul>
<li>Clarify behavior on MUC join.</li> <li>Clarify behavior on MUC join.</li>
<li></li>
</ul> </ul>
</remark> </remark>
</revision> </revision>
@ -1173,39 +1180,39 @@
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
<value>http://jabber.org/protocol/muc#roominfo</value> <value>http://jabber.org/protocol/muc#roominfo</value>
</field> </field>
<field var='muc#roominfo_description' <field var='muc#roominfo_description'
label='Description'> label='Description'>
<value>The place for all good witches!</value> <value>The place for all good witches!</value>
</field> </field>
<field var='muc#roominfo_changesubject' <field var='muc#roominfo_changesubject'
label='Occupants May Change the Subject'> label='Occupants May Change the Subject'>
<value>true</value> <value>true</value>
</field> </field>
<field var='muc#roominfo_contactjid' <field var='muc#roominfo_contactjid'
label='Contact Addresses'> label='Contact Addresses'>
<value>crone1@shakespeare.lit</value> <value>crone1@shakespeare.lit</value>
</field> </field>
<field var='muc#roominfo_subject' <field var='muc#roominfo_subject'
label='Current Discussion Topic'> label='Current Discussion Topic'>
<value>Spells</value> <value>Spells</value>
</field> </field>
<field var='muc#roomconfig_changesubject' <field var='muc#roomconfig_changesubject'
label='Subject can be modified'> label='Subject can be modified'>
<value>true</value> <value>true</value>
</field> </field>
<field var='muc#roominfo_occupants' <field var='muc#roominfo_occupants'
label='Number of occupants'> label='Number of occupants'>
<value>3</value> <value>3</value>
</field> </field>
<field var='muc#roominfo_ldapgroup' <field var='muc#roominfo_ldapgroup'
label='Associated LDAP Group'> label='Associated LDAP Group'>
<value>cn=witches,dc=shakespeare,dc=lit</value> <value>cn=witches,dc=shakespeare,dc=lit</value>
</field> </field>
<field var='muc#roominfo_lang' <field var='muc#roominfo_lang'
label='Language of discussion'> label='Language of discussion'>
<value>en</value> <value>en</value>
</field> </field>
<field var='muc#roominfo_logs' <field var='muc#roominfo_logs'
label='URL for discussion logs'> label='URL for discussion logs'>
<value>http://www.shakespeare.lit/chatlogs/coven/</value> <value>http://www.shakespeare.lit/chatlogs/coven/</value>
</field> </field>
@ -1213,7 +1220,7 @@
label='Maximum Number of History Messages Returned by Room'> label='Maximum Number of History Messages Returned by Room'>
<value>50</value> <value>50</value>
</field> </field>
<field var='muc#roominfo_pubsub' <field var='muc#roominfo_pubsub'
label='Associated pubsub node'> label='Associated pubsub node'>
<value>xmpp:pubsub.shakespeare.lit?;node=the-coven-node</value> <value>xmpp:pubsub.shakespeare.lit?;node=the-coven-node</value>
</field> </field>
@ -1449,7 +1456,7 @@
</error> </error>
</presence> </presence>
]]></example> ]]></example>
<p>If the user has connected using a MUC client (as indicated on joining the room by inclusino of the MUC extension), then the service MUST allow the client to enter the room, modify the nick in accordance with the lockdown policy, and include a status code of "210" in the presence broadcast that it sends to the new occupant.</p> <p>If the user has connected using a MUC client (as indicated on joining the room by inclusion of the MUC extension), then the service MUST allow the client to enter the room, modify the nick in accordance with the lockdown policy, and include a status code of "210" in the presence broadcast that it sends to the new occupant.</p>
<example caption="Service Sends New Occupant's Presence to New Occupant"><![CDATA[ <example caption="Service Sends New Occupant's Presence to New Occupant"><![CDATA[
<presence <presence
from='coven@chat.shakespeare.lit/thirdwitch' from='coven@chat.shakespeare.lit/thirdwitch'
@ -1848,7 +1855,7 @@
</tr> </tr>
</table> </table>
</section3> </section3>
</section2> </section2>
<section2 topic='Occupant Modification of the Room Subject' anchor='subject-occupant'> <section2 topic='Occupant Modification of the Room Subject' anchor='subject-occupant'>
@ -2212,7 +2219,7 @@
<ol start='1'> <ol start='1'>
<li>Creates a new multi-user chatroom</li> <li>Creates a new multi-user chatroom</li>
<li>Sends history of the one-to-one chat to the room (this is purely discretionary; however, because it might cause information leakage, the client ought to warn the user before doing so)</li> <li>Sends history of the one-to-one chat to the room (this is purely discretionary; however, because it might cause information leakage, the client ought to warn the user before doing so)</li>
<li>Sends an invitation to the second person and the third person, including a &lt;continue/&gt; element (optionally including a 'thread' attribute).</li> <li>Sends an invitation to the second person and the third person, including a &lt;continue/&gt; element (optionally including a 'thread' attribute).</li>
</ol> </ol>
<p>Note: The new room SHOULD be non-anonymous and MAY be an instant room as specified in the <link url='#createroom-instant'>Creating an Instant Room</link> section of this document.</p> <p>Note: The new room SHOULD be non-anonymous and MAY be an instant room as specified in the <link url='#createroom-instant'>Creating an Instant Room</link> section of this document.</p>
<p>Note: If the one-to-one chat messages included a &THREAD; element, the person who creates the room SHOULD include the ThreadID with the history messages, specify the ThreadID in the invitations as the value of the &lt;continue/&gt; element's 'thread' attribute, and include the ThreadID in any new messages sent to the room. Use of ThreadIDs is RECOMMENDED because it helps to provide continuity between the one-to-one chat and the multi-user chat.</p> <p>Note: If the one-to-one chat messages included a &THREAD; element, the person who creates the room SHOULD include the ThreadID with the history messages, specify the ThreadID in the invitations as the value of the &lt;continue/&gt; element's 'thread' attribute, and include the ThreadID in any new messages sent to the room. Use of ThreadIDs is RECOMMENDED because it helps to provide continuity between the one-to-one chat and the multi-user chat.</p>
@ -2615,7 +2622,7 @@
to='hag66@shakespeare.lit/pda' to='hag66@shakespeare.lit/pda'
type='unavailable'> type='unavailable'>
<x xmlns='http://jabber.org/protocol/muc#user'> <x xmlns='http://jabber.org/protocol/muc#user'>
<item affiliation='member' <item affiliation='member'
jid='hag66@shakespeare.lit/pda' jid='hag66@shakespeare.lit/pda'
role='none'/> role='none'/>
<status code='110'/> <status code='110'/>
@ -2630,7 +2637,7 @@
to='hag66@shakespeare.lit/pda' to='hag66@shakespeare.lit/pda'
type='unavailable'> type='unavailable'>
<x xmlns='http://jabber.org/protocol/muc#user'> <x xmlns='http://jabber.org/protocol/muc#user'>
<item affiliation='member' <item affiliation='member'
jid='hag66@shakespeare.lit/pda' jid='hag66@shakespeare.lit/pda'
role='none'/> role='none'/>
<status code='110'/> <status code='110'/>
@ -2641,7 +2648,7 @@
to='crone1@shakespeare.lit/desktop' to='crone1@shakespeare.lit/desktop'
type='unavailable'> type='unavailable'>
<x xmlns='http://jabber.org/protocol/muc#user'> <x xmlns='http://jabber.org/protocol/muc#user'>
<item affiliation='member' <item affiliation='member'
jid='hag66@shakespeare.lit/pda' jid='hag66@shakespeare.lit/pda'
role='none'/> role='none'/>
</x> </x>
@ -2651,7 +2658,7 @@
to='wiccarocks@shakespeare.lit/laptop' to='wiccarocks@shakespeare.lit/laptop'
type='unavailable'> type='unavailable'>
<x xmlns='http://jabber.org/protocol/muc#user'> <x xmlns='http://jabber.org/protocol/muc#user'>
<item affiliation='member' <item affiliation='member'
jid='hag66@shakespeare.lit/pda' jid='hag66@shakespeare.lit/pda'
role='none'/> role='none'/>
</x> </x>
@ -3004,9 +3011,9 @@
<x xmlns='jabber:x:data' type='form'> <x xmlns='jabber:x:data' type='form'>
<title>Voice request</title> <title>Voice request</title>
<instructions> <instructions>
To approve this request for voice, select To approve this request for voice, select
the &quot;Grant voice to this person?&quot; the &quot;Grant voice to this person?&quot;
checkbox and click OK. To skip this request, checkbox and click OK. To skip this request,
click the cancel button. click the cancel button.
</instructions> </instructions>
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
@ -3292,7 +3299,7 @@
<query xmlns='http://jabber.org/protocol/muc#admin'> <query xmlns='http://jabber.org/protocol/muc#admin'>
<item affiliation='none' <item affiliation='none'
jid='hag66@shakespeare.lit'> jid='hag66@shakespeare.lit'>
<reason>Not so worthy after all!</reason> <reason>Not so worthy after all!</reason>
</item> </item>
</query> </query>
</iq> </iq>
@ -3482,7 +3489,7 @@
<query xmlns='http://jabber.org/protocol/muc#admin'> <query xmlns='http://jabber.org/protocol/muc#admin'>
<item nick='thirdwitch' <item nick='thirdwitch'
role='moderator'> role='moderator'>
<reason>A worthy witch indeed!</reason> <reason>A worthy witch indeed!</reason>
</item> </item>
</query> </query>
</iq> </iq>
@ -3532,7 +3539,7 @@
<query xmlns='http://jabber.org/protocol/muc#admin'> <query xmlns='http://jabber.org/protocol/muc#admin'>
<item nick='thirdwitch' <item nick='thirdwitch'
role='participant'> role='participant'>
<reason>Not so worthy after all!</reason> <reason>Not so worthy after all!</reason>
</item> </item>
</query> </query>
</iq> </iq>
@ -3643,7 +3650,7 @@
<instructions> <instructions>
To approve this registration request, select the To approve this registration request, select the
&quot;Allow this person to register with the room?&quot; &quot;Allow this person to register with the room?&quot;
checkbox and click OK. To skip this request, click the checkbox and click OK. To skip this request, click the
cancel button. cancel button.
</instructions> </instructions>
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
@ -4472,7 +4479,7 @@
<query xmlns='http://jabber.org/protocol/muc#admin'> <query xmlns='http://jabber.org/protocol/muc#admin'>
<item affiliation='admin' <item affiliation='admin'
jid='hecate@shakespeare.lit'> jid='hecate@shakespeare.lit'>
<reason>Not so worthy after all!</reason> <reason>Not so worthy after all!</reason>
</item> </item>
</query> </query>
</iq> </iq>
@ -4649,7 +4656,7 @@
<query xmlns='http://jabber.org/protocol/muc#admin'> <query xmlns='http://jabber.org/protocol/muc#admin'>
<item affiliation='none' <item affiliation='none'
jid='wiccarocks@shakespeare.lit'> jid='wiccarocks@shakespeare.lit'>
<reason>Not so worthy after all!</reason> <reason>Not so worthy after all!</reason>
</item> </item>
</query> </query>
</iq> </iq>
@ -4871,7 +4878,7 @@
<section2 topic='Information Leaks' anchor='security-leaks'> <section2 topic='Information Leaks' anchor='security-leaks'>
<p>The "roominfo" data form used in extended service discovery can result in information leaks, e.g., the current discussion topic (via the "roominfo_subject" field). The same is true of service discovery items (disco#items) requests from outside the room (which could be used to discover the list of room occupants).</p> <p>The "roominfo" data form used in extended service discovery can result in information leaks, e.g., the current discussion topic (via the "roominfo_subject" field). The same is true of service discovery items (disco#items) requests from outside the room (which could be used to discover the list of room occupants).</p>
<p>Implementations and deployments are advised to carefully consider the possibility that this information might be leaked, and to turn off information sharing by default for sensitive data.</p> <p>Implementations and deployments are advised to carefully consider the possibility that this information might be leaked, and to turn off information sharing by default for sensitive data.</p>
</section2> </section2>
<section2 topic='Anonymity' anchor='security-anon'> <section2 topic='Anonymity' anchor='security-anon'>
@ -5023,7 +5030,7 @@
Multi-User Chat (MUC) room or admin approval Multi-User Chat (MUC) room or admin approval
of user registration requests. of user registration requests.
</desc> </desc>
<field <field
var='muc#register_allow' var='muc#register_allow'
type='boolean' type='boolean'
label='Allow this person to register with the room?'/> label='Allow this person to register with the room?'/>
@ -5061,7 +5068,7 @@
<name>http://jabber.org/protocol/muc#request</name> <name>http://jabber.org/protocol/muc#request</name>
<doc>XEP-0045</doc> <doc>XEP-0045</doc>
<desc> <desc>
Forms enabling voice requests in a Forms enabling voice requests in a
Multi-User Chat (MUC) room or admin Multi-User Chat (MUC) room or admin
approval of such requests. approval of such requests.
</desc> </desc>
@ -5206,11 +5213,11 @@
<field <field
var='muc#roominfo_ldapgroup' var='muc#roominfo_ldapgroup'
type='text-single' type='text-single'
label='An associated LDAP group that defines label='An associated LDAP group that defines
room membership; this should be an LDAP room membership; this should be an LDAP
Distinguished Name according to an Distinguished Name according to an
implementation-specific or implementation-specific or
deployment-specific definition of a deployment-specific definition of a
group.'/> group.'/>
<field <field
var='muc#roominfo_logs' var='muc#roominfo_logs'
@ -5388,7 +5395,7 @@
<stanza>presence</stanza> <stanza>presence</stanza>
<context>Removal from room</context> <context>Removal from room</context>
<purpose> <purpose>
Inform user that he or she is being removed from the room Inform user that he or she is being removed from the room
because of an affiliation change because of an affiliation change
</purpose> </purpose>
</statuscode> </statuscode>
@ -5397,7 +5404,7 @@
<stanza>presence</stanza> <stanza>presence</stanza>
<context>Removal from room</context> <context>Removal from room</context>
<purpose> <purpose>
Inform user that he or she is being removed from the room Inform user that he or she is being removed from the room
because the room has been changed to members-only and the because the room has been changed to members-only and the
user is not a member user is not a member
</purpose> </purpose>
@ -5407,7 +5414,7 @@
<stanza>presence</stanza> <stanza>presence</stanza>
<context>Removal from room</context> <context>Removal from room</context>
<purpose> <purpose>
Inform user that he or she is being removed from the room Inform user that he or she is being removed from the room
because the MUC service is being shut down because the MUC service is being shut down
</purpose> </purpose>
</statuscode> </statuscode>
@ -5423,7 +5430,7 @@
<example caption='Join Action: IRI/URI'><![CDATA[ <example caption='Join Action: IRI/URI'><![CDATA[
xmpp:coven@chat.shakespeare.lit?join xmpp:coven@chat.shakespeare.lit?join
]]></example> ]]></example>
<p>The application MUST either present an interface enabling the user to provide a room nickname or populate the room nickname based on configured preferences or nickname discovery.</p> <p>The application MUST either present an interface enabling the user to provide a room nickname or populate the room nickname based on configured preferences or nickname discovery.</p>
<example caption='Join Action: Resulting Stanza'><![CDATA[ <example caption='Join Action: Resulting Stanza'><![CDATA[
<presence to='coven@chat.shakespeare.lit/thirdwitch'> <presence to='coven@chat.shakespeare.lit/thirdwitch'>
<x xmlns='http://jabber.org/protocol/muc'/> <x xmlns='http://jabber.org/protocol/muc'/>
@ -5586,7 +5593,7 @@ xmpp:coven@chat.shakespeare.lit?invite;jid=hecate@shakespeare.lit;password=cauld
<li><p>A MUC service MAY choose to make available a special in-room resource that provides an interface to administrative functionality (e.g., a "user" named "ChatBot"), which occupants could interact with directly, thus enabling admins to type <tt>'/command parameter'</tt> in a private message to that "user". Obviously this kind of implementation would require the service to add a 'ChatBot' user to the room when it is created, and to prevent any occupant from having the nickname 'ChatBot' in the room. This might be difficult to ensure in some implementations or deployments. In any case, any such interface is OPTIONAL.</p></li> <li><p>A MUC service MAY choose to make available a special in-room resource that provides an interface to administrative functionality (e.g., a "user" named "ChatBot"), which occupants could interact with directly, thus enabling admins to type <tt>'/command parameter'</tt> in a private message to that "user". Obviously this kind of implementation would require the service to add a 'ChatBot' user to the room when it is created, and to prevent any occupant from having the nickname 'ChatBot' in the room. This might be difficult to ensure in some implementations or deployments. In any case, any such interface is OPTIONAL.</p></li>
<li><p>A MUC service MAY choose to discard extended presence information that is attached to a &PRESENCE; stanza before reflecting the presence change to the occupants of a room. That is, an implementation MAY choose to reflect only the &lt;show/&gt;, &lt;status/&gt;, and &lt;priority/&gt; child elements of the presence element as specified in the XML schema for the 'jabber:client' namespace, with the result that presence "changes" in extended namespaces (e.g., gabber:x:music:info) are not passed through to occupants. If a service prohibits certain extended namespaces, it SHOULD provide a description of allowable traffic at the well-known Service Discovery node 'http://jabber.org/protocol/muc#traffic' as described in the <link url='#impl-service-traffic'>Allowable Traffic</link> section of this document.</p></li> <li><p>A MUC service MAY choose to discard extended presence information that is attached to a &PRESENCE; stanza before reflecting the presence change to the occupants of a room. That is, an implementation MAY choose to reflect only the &lt;show/&gt;, &lt;status/&gt;, and &lt;priority/&gt; child elements of the presence element as specified in the XML schema for the 'jabber:client' namespace, with the result that presence "changes" in extended namespaces (e.g., gabber:x:music:info) are not passed through to occupants. If a service prohibits certain extended namespaces, it SHOULD provide a description of allowable traffic at the well-known Service Discovery node 'http://jabber.org/protocol/muc#traffic' as described in the <link url='#impl-service-traffic'>Allowable Traffic</link> section of this document.</p></li>
<li><p>A MUC service MAY choose to discard extended information attached to a &MESSAGE; stanza before reflecting the message to the occupants of a room. An example of such extended information is the lightweight text markup specified by &xep0071;. If a service prohibits certain extended namespaces, it SHOULD provide a description of allowable traffic at the well-known Service Discovery node 'http://jabber.org/protocol/muc#traffic' as described in the <link url='#impl-service-traffic'>Allowable Traffic</link> section of this document.</p></li> <li><p>A MUC service MAY choose to discard extended information attached to a &MESSAGE; stanza before reflecting the message to the occupants of a room. An example of such extended information is the lightweight text markup specified by &xep0071;. If a service prohibits certain extended namespaces, it SHOULD provide a description of allowable traffic at the well-known Service Discovery node 'http://jabber.org/protocol/muc#traffic' as described in the <link url='#impl-service-traffic'>Allowable Traffic</link> section of this document.</p></li>
<li><p>A MUC service MAY choose to "lock down" room nicknames (e.g., hardcoding the room nickname to the bare JID of the occupant). If so, the service MUST treat the locked nickname as a reserved room nickname and MUST support the protocol specified in the <link url='#reservednick'>Discovering Reserved Room Nickname</link> section of this document.</p></li> <li><p>A MUC service MAY choose to "lock down" room nicknames (e.g., hardcoding the room nickname to the bare JID of the occupant). If so, the service MUST treat the locked nickname as a reserved room nickname and MUST support the protocol specified in the <link url='#reservednick'>Discovering Reserved Room Nickname</link> section of this document.</p></li>
</ol> </ol>
<section3 topic='Allowable Traffic' anchor='impl-service-traffic'> <section3 topic='Allowable Traffic' anchor='impl-service-traffic'>
@ -6033,7 +6040,7 @@ xmpp:coven@chat.shakespeare.lit?invite;jid=hecate@shakespeare.lit;password=cauld
</xs:documentation> </xs:documentation>
</xs:annotation> </xs:annotation>
<xs:import <xs:import
namespace='jabber:x:data' namespace='jabber:x:data'
schemaLocation='http://www.xmpp.org/schemas/x-data.xsd'/> schemaLocation='http://www.xmpp.org/schemas/x-data.xsd'/>