git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@2276 4b5297f7-1745-476d-ba37-a9c6900126ab
This commit is contained in:
Peter Saint-Andre 2008-09-26 01:30:07 +00:00
parent 2680d46a80
commit 6a6218bbdf
1 changed files with 14 additions and 25 deletions

View File

@ -37,6 +37,12 @@
&pgmillard;
&temas;
&xvirge;
<revision>
<version>1.1rc1</version>
<date>in progress, last updated 2008-09-25</date>
<initials>psa</initials>
<remark><p>For consistency with other PEP payload formats, changed stop semantics to use an empty &lt;metadata/&gt; element rather than a &lt;stop/&gt; child element.</p></remark>
</revision>
<revision>
<version>1.0</version>
<date>2007-11-07</date>
@ -268,16 +274,14 @@
]]></example>
<p>If the &lt;info/&gt; element sent to the metadata node possesses a 'url' attribute, the avatar data is hosted at a URL. Therefore, in order to retrieve the avatar image data for that content-type, the requesting entity MUST send an HTTP request to the specified URL. Methods for doing so are out of scope for this specification (see <cite>RFC 2616</cite>).</p>
</section2>
<section2 topic='Publisher Disables Avatar Publishing' anchor='pub-stop'>
<p>In order to temporarily disable avatar publishing, the user publishes an empty &lt;stop/&gt; element to the metadata node (this item SHOULD NOT possess an ItemID).</p>
<example caption='Temporarily disabling an avatar'><![CDATA[
<section2 topic='Publisher Disables Avatar Publishing' anchor='pub-disable'>
<p>In order to temporarily disable avatar publishing, the user publishes an empty &lt;metadata/&gt; element to the metadata node.</p>
<example caption='Temporarily disabling avatar publishing'><![CDATA[
<iq type='set' from='juliet@capulet.lit/chamber' id='publish3'>
<pubsub xmlns='http://jabber.org/protocol/pubsub'>
<publish node='urn:xmpp:avatar:data'>
<item>
<metadata xmlns='urn:xmpp:avatar:metadata'>
<stop/>
</metadata>
<metadata xmlns='urn:xmpp:avatar:metadata'/>
</item>
</publish>
</pubsub>
@ -289,17 +293,13 @@
<event xmlns='http://jabber.org/protocol/pubsub#event'>
<items node='urn:xmpp:avatar:metadata'>
<item>
<metadata xmlns='urn:xmpp:avatar:metadata'>
<stop/>
</metadata>
<metadata xmlns='urn:xmpp:avatar:metadata'/>
</item>
</items>
</event>
<addresses xmlns='http://jabber.org/protocol/address'>
<address type='replyto' jid='juliet@capulet.lit/chamber'/>
</addresses>
</message>
]]></example>
<p>Note: In an earlier version of this specification, the user indicated that it wanted to disable publishing by sending a &lt;metadata/&gt; element containing a &lt;stop/&gt; child element. For consistency with other PEP payload formats, support for the &lt;stop/&gt; element is <em>deprecated</em>.</p>
</section2>
</section1>
<section1 topic='Protocol Syntax' anchor='proto'>
@ -321,13 +321,13 @@
<p>Support for the &lt;data/&gt; element is REQUIRED.</p>
</section2>
<section2 topic='Metadata Element' anchor='proto-meta'>
<p>The &lt;metadata/&gt; element is used to communicate information about the avatar. There are three allowable children of the &lt;metadata/&gt; element:</p>
<p>The &lt;metadata/&gt; element is used to communicate information about the avatar. There are two allowable children of the &lt;metadata/&gt; element:</p>
<ul>
<li>&lt;info/&gt;</li>
<li>&lt;pointer/&gt;</li>
<li>&lt;stop/&gt;</li>
</ul>
<p>These are further specified below.</p>
<p>In addition, the &lt;metadata/&gt; element MAY be empty (i.e., contain no child elements); this form is used to disable avatar publishing.</p>
<section3 topic='Info Element' anchor='proto-info'>
<p>The &lt;info/&gt; child element is used to communicate avatar metadata. Support for the &lt;info/&gt; element is REQUIRED.</p>
<code><![CDATA[
@ -402,16 +402,6 @@
<p>Even if the &lt;pointer&gt; element is included, it MUST be preceded by at least one instance of the &lt;info/&gt; element so that implementations that do not support the &lt;pointer/&gt; element can display a "fallback" format of the avatar (at a minimum, "image/png").</p>
<p>Support for the &lt;pointer/&gt; element is OPTIONAL.</p>
</section3>
<section3 topic='Stop Element' anchor='proto-stop'>
<p>The &lt;stop/&gt; child element is used to signal that avatar publishing has been disabled.</p>
<code><![CDATA[
<metadata xmlns='urn:xmpp:avatar:metadata'>
<stop/>
</metadata>
]]></code>
<p>The &lt;stop/&gt; element MUST be empty and MUST NOT possess any attributes.</p>
<p>Support for the &lt;stop/&gt; element is REQUIRED.</p>
</section3>
</section2>
</section1>
<section1 topic='Additional Examples' anchor='examples'>
@ -579,7 +569,6 @@
<xs:element ref='info' minOccurs='1' maxOccurs='unbounded'/>
<xs:element ref='pointer' minOccurs='0' maxOccurs='unbounded'/>
</xs:sequence>
<xs:element name='stop' type='empty'/>
</xs:choice>
</xs:complexType>
</xs:element>