Add join

xep-0369.xml

@@ -950,7 +950,7 @@
       </p>
     </section3>
     <section3 topic='Joining a Channel' anchor='usecase-user-join'>
-      <p>A user joins a channel by sending a MIX "join" command from one of the user's clients, which will be relayed to the server as specified in MIX-PAM. There is no default set of nodes, so the user MUST specify the set of nodes to be subscribed to. To achieve the equivalent service to MUC, a user would subscribe to both messages and presence nodes.  A user will typically subscribe to at least the message and/or presence nodes but MAY join and not subscribe to any nodes.  Note that the presence node is specified in MIX-PRESENCE.  The &lt;join/&gt; is a child element of &lt;iq/&gt; element.     The &lt;join/&gt; element is qualified by the 'urn:xmpp:mix:core:0' namespace.    The requested nodes are encoded as &lt;subscribe/&gt; child elements of the &lt;join/&gt; element.</p>
+      <p>A user joins a channel by sending a MIX "join" command from one of the user's clients, which will be relayed to the server as specified in MIX-PAM. There is no default set of nodes, so the user MUST specify the set of nodes to be subscribed to. To achieve the equivalent service to MUC, a user would subscribe to both messages and presence nodes.  A user will typically subscribe to at least the message and/or presence nodes but MAY join and not subscribe to any nodes.  Note that the presence node is specified in MIX-PRESENCE.  The &lt;join/&gt; is a child element of &lt;iq/&gt; element.     The &lt;join/&gt; element is qualified by the 'urn:xmpp:mix:core:0' namespace.    The requested nodes are encoded as &lt;subscribe/&gt; child elements of the &lt;join/&gt; element.  A nick MAY be specified as a &lt;nick/&gt; child elements of the &lt;join/&gt; element. </p>
       <p>The join leads to the server subscribing the user to each of the requested nodes associated with the channel. The MIX service will also add the user to the participant list by injecting a new item into the "urn:xmpp:mix:nodes:participants" node automatically.</p>
       <p>The default MIX model is that only channel participants are allowed to subscribe to nodes.    A MIX channel MAY allow non-participant subscription to some nodes.   This will be handled by clients directly subscribing to the desired PubSub nodes.</p>
       <p>The user's server needs to make roster changes as part of the join functionality, as specified in MIX-PAM.   This means that the join request to the MIX service will come from the user's server from the user's bare JID.</p>
@@ -964,6 +964,7 @@
     <subscribe node='urn:xmpp:mix:nodes:presence'/>
     <subscribe node='urn:xmpp:mix:nodes:participants'/>
     <subscribe node='urn:xmpp:mix:nodes:info'/>
+    <nick>third witch</nick>
   </join>
 </iq>
 ]]></example>
@@ -981,6 +982,7 @@
     <subscribe node='urn:xmpp:mix:nodes:presence'/>
     <subscribe node='urn:xmpp:mix:nodes:participants'/>
     <subscribe node='urn:xmpp:mix:nodes:info'/>
+    <nick>third witch</nick>
   </join>
 </iq>
 ]]></example>
@@ -1001,6 +1003,7 @@
     <subscribe node='urn:xmpp:mix:nodes:messages'/>
     <subscribe node='urn:xmpp:mix:nodes:participants'/>
     <subscribe node='urn:xmpp:mix:nodes:info'/>
+    <nick>third witch</nick>
   </join>
 </iq>
 ]]></example>
@@ -1016,6 +1019,7 @@
       <item id='123456'>
         <participant xmlns='urn:xmpp:mix:core:0'>
           <jid>hag66@shakespeare.example</jid>
+           <nick>third witch</nick>
         </participant>
       </item>
     </items>
@@ -1048,6 +1052,9 @@
   </update-subscription>
 </iq>
 ]]></example>
+      <p>
+        A user MAY specify a nick when joining the channel.   Channels MAY have mandatory nicks, which is default behavior.   Therefore it is will generally be necessary to include a nick when joining an channel.   If nick is missing on a channel where nick is mandatory, the join MUST be rejected.   Other error cases are dealt with below with the nick management commands.  Where a nick is specified, the join will only complete if the nick is accepted.   The nick used MUST be reported back in the join result.
+      </p>
     </section3>
     <section3 topic='Leaving a Channel' anchor='usecase-user-leaving'>
       <p>Users generally remain in a channel for an extended period of time.  In particular the user remains as a participant the channel when the user goes offline.  Note that this is different to  &xep0045;, where the client leaves a room when going offline. So, leaving a MIX channel is a permanent action for a user across all clients.  In order to  leave a channel, the user's server sends a MIX "leave" command to the channel, as specified in MIX-PAM.  The leave command is encoded as a &lt;leave/&gt; child element of &lt;iq/&gt; element.  The &lt;leave/&gt; element is qualified by the 'urn:xmpp:mix:core:0' namespace.  The following example shows a leave request to a MIX channel.  </p>