full JIDs

git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@1586 4b5297f7-1745-476d-ba37-a9c6900126ab
This commit is contained in:
Peter Saint-Andre 2008-01-17 16:23:12 +00:00
parent fffa7a1468
commit 7d2def7915
1 changed files with 5 additions and 5 deletions

View File

@ -612,7 +612,7 @@
<p>The server handling rules defined in <cite>XMPP IM</cite> require that the server itself reply on behalf of the user if the 'to' attribute of an IQ get or set is of the form &lt;user@host&gt;. This functionality is currently employed so that the user can "publish" information (e.g., vCard information as specified in &xep0054;) in a way that makes it possible for other entities to retrieve that information even if the user is unavailable. The service discovery specification defined herein builds on that notion by enabling a user to publish some of its service discovery information to the server, which shall store that information in persistent storage and return that information when other entities request it from the user's "bare JID" (user@host), either alone or in combination with a particular node.</p>
<p>Implementations of service discovery that are built into instant messaging servers SHOULD allow users to publish items in this fashion, although they are not required to do so in order to conform to the service discovery specification. In order to discover whether his or her server supports this publish functionality, the user SHOULD send a disco#info request to his or her server:</p>
<example caption="User sends disco#info request to server"><![CDATA[
<iq from='kinglear@shakespeare.lit'
<iq from='kinglear@shakespeare.lit/throne'
id='pubinfo'
to='shakespeare.lit'
type='get'>
@ -623,7 +623,7 @@
<example caption="Server responds with identity and feature information"><![CDATA[
<iq from='shakespeare.lit'
id='pubinfo'
to='kinglear@shakespeare.lit'
to='kinglear@shakespeare.lit/throne'
type='result'>
<query xmlns='http://jabber.org/protocol/disco#info'>
<identity category='server' type='im'/>
@ -647,7 +647,7 @@
<p>The allowable values for the 'action' attribute are "update" and "remove"). If the action is "update", the server MUST either create a new entry (if the node and jid combination does not already exist) or overwrite an existing entry. If the action is "remove", the item MUST be removed from persistent storage.</p>
<p>The following example shows a user publishing a list of his biological children to a well-known (but fictitious) service discovery node.</p>
<example caption='Publishing items'><![CDATA[
<iq from='kinglear@shakespeare.lit'
<iq from='kinglear@shakespeare.lit/throne'
id='publish1'
type='set'>
<query xmlns='http://jabber.org/protocol/disco#items'
@ -667,7 +667,7 @@
<example caption="Server responds with success"><![CDATA[
<iq id='publish1'
to='kinglear@shakespeare.lit'
to='kinglear@shakespeare.lit/throne'
type='result'/>
]]></example>
@ -677,7 +677,7 @@
<example caption='Persistent storage is not available'><![CDATA[
<iq id='publish1'
to='kinglear@shakespeare.lit'
to='kinglear@shakespeare.lit/throne'
type='error'>
<query xmlns='http://jabber.org/protocol/disco#items'
node='jabber:iq:kids'>