1
0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-23 01:32:22 -05:00

Merge branch 'fix/metadata' into premerge

This commit is contained in:
Jonas Schäfer 2021-08-03 18:22:39 +02:00
commit 42a9b95cb8
3 changed files with 32 additions and 14 deletions

View File

@ -49,6 +49,12 @@
&pgmillard; &pgmillard;
&stpeter; &stpeter;
&ralphm; &ralphm;
<revision>
<version>1.21.0</version>
<date>2021-08-03</date>
<initials>pep</initials>
<remark><p>Revert change from version 1.15.5 which changed meta-data to metadata in wire protocol. That was an unintended breaking change which has now been reverted.</p></remark>
</revision>
<revision> <revision>
<version>1.20.0</version> <version>1.20.0</version>
<date>2021-06-08</date> <date>2021-06-08</date>
@ -385,7 +391,7 @@
<version>1.6</version> <version>1.6</version>
<date>2004-07-13</date> <date>2004-07-13</date>
<initials>pgm/psa</initials> <initials>pgm/psa</initials>
<remark><p>Added service discovery features for pubsub#metadata, and pubsub#retrieve-items. Added pubsub#subscription_depth configuration option. Specified pubsub-specific error condition elements qualified by pubsub#errors namespace.</p></remark> <remark><p>Added service discovery features for pubsub#meta-data, and pubsub#retrieve-items. Added pubsub#subscription_depth configuration option. Specified pubsub-specific error condition elements qualified by pubsub#errors namespace.</p></remark>
</revision> </revision>
<revision> <revision>
<version>1.5</version> <version>1.5</version>
@ -1065,7 +1071,7 @@ And by opposing end them?
]]></example> ]]></example>
</section2> </section2>
<section2 topic='Discover Node Metadata' anchor='entity-metadata'> <section2 topic='Discover Node Metadata' anchor='entity-metadata'>
<p>The "disco#info" result MAY include detailed metadata about the node, encapsulated in the &xep0004; format as described in &xep0128;, where the data form context is specified by including a FORM_TYPE of "http://jabber.org/protocol/pubsub#metadata" in accordance with &xep0068;. If metadata is provided, it SHOULD include values for all configured options as well as "automatic" information such as the node creation date, a list of publishers, and the like.</p> <p>The "disco#info" result MAY include detailed metadata about the node, encapsulated in the &xep0004; format as described in &xep0128;, where the data form context is specified by including a FORM_TYPE of "http://jabber.org/protocol/pubsub#meta-data" in accordance with &xep0068;. If metadata is provided, it SHOULD include values for all configured options as well as "automatic" information such as the node creation date, a list of publishers, and the like.</p>
<example caption='Entity queries a node for information'><![CDATA[ <example caption='Entity queries a node for information'><![CDATA[
<iq type='get' <iq type='get'
from='francisco@denmark.lit/barracks' from='francisco@denmark.lit/barracks'
@ -1086,7 +1092,7 @@ And by opposing end them?
<feature var='http://jabber.org/protocol/pubsub'/> <feature var='http://jabber.org/protocol/pubsub'/>
<x xmlns='jabber:x:data' type='result'> <x xmlns='jabber:x:data' type='result'>
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
<value>http://jabber.org/protocol/pubsub#metadata</value> <value>http://jabber.org/protocol/pubsub#meta-data</value>
</field> </field>
<field var='pubsub#type' label='Payload type' type='text-single'> <field var='pubsub#type' label='Payload type' type='text-single'>
<value>http://www.w3.org/2005/Atom</value> <value>http://www.w3.org/2005/Atom</value>
@ -5220,7 +5226,7 @@ And by opposing end them?
<td><link url='#affiliations'>Affiliations</link></td> <td><link url='#affiliations'>Affiliations</link></td>
</tr> </tr>
<tr> <tr>
<td>metadata</td> <td>meta-data</td>
<td>Node metadata is supported.</td> <td>Node metadata is supported.</td>
<td>RECOMMENDED</td> <td>RECOMMENDED</td>
<td>&#160;</td> <td>&#160;</td>
@ -6143,7 +6149,7 @@ xmpp:pubsub.shakespeare.lit?pubsub;action=retrieve;node=princely_musings;item=ae
<doc>XEP-0060</doc> <doc>XEP-0060</doc>
</var> </var>
<var> <var>
<name>http://jabber.org/protocol/pubsub#metadata</name> <name>http://jabber.org/protocol/pubsub#meta-data</name>
<desc>Node metadata is supported.</desc> <desc>Node metadata is supported.</desc>
<doc>XEP-0060</doc> <doc>XEP-0060</doc>
</var> </var>
@ -6266,7 +6272,7 @@ xmpp:pubsub.shakespeare.lit?pubsub;action=retrieve;node=princely_musings;item=ae
<li>Authorization of subscriptions using the 'http://jabber.org/protocol/pubsub#subscribe_authorization' namespace.</li> <li>Authorization of subscriptions using the 'http://jabber.org/protocol/pubsub#subscribe_authorization' namespace.</li>
<li>Configuration of subscription options using the 'http://jabber.org/protocol/pubsub#subscribe_options' namespace.</li> <li>Configuration of subscription options using the 'http://jabber.org/protocol/pubsub#subscribe_options' namespace.</li>
<li>Configuration of a node using the 'http://jabber.org/protocol/pubsub#node_config' namespace.</li> <li>Configuration of a node using the 'http://jabber.org/protocol/pubsub#node_config' namespace.</li>
<li>Setting of metadata information using the 'http://jabber.org/protocol/pubsub#metadata' namespace.</li> <li>Setting of metadata information using the 'http://jabber.org/protocol/pubsub#meta-data' namespace.</li>
</ol> </ol>
<p>The registry submissions associated with these namespaces are defined below.</p> <p>The registry submissions associated with these namespaces are defined below.</p>
<p>Note: There is no requirement that configuration fields need to be registered with the XMPP Registrar. However, as specified in Section 3.4 of <cite>XEP-0068</cite>, names of custom (unregistered) fields MUST begin with the characters "x-" if the form itself is scoped by a registered FORM_TYPE.</p> <p>Note: There is no requirement that configuration fields need to be registered with the XMPP Registrar. However, as specified in Section 3.4 of <cite>XEP-0068</cite>, names of custom (unregistered) fields MUST begin with the characters "x-" if the form itself is scoped by a registered FORM_TYPE.</p>
@ -6370,10 +6376,10 @@ xmpp:pubsub.shakespeare.lit?pubsub;action=retrieve;node=princely_musings;item=ae
</form_type> </form_type>
]]></code> ]]></code>
</section3> </section3>
<section3 topic='pubsub#metadata FORM_TYPE' anchor='registrar-formtypes-metadata'> <section3 topic='pubsub#meta-data FORM_TYPE' anchor='registrar-formtypes-metadata'>
<code><![CDATA[ <code><![CDATA[
<form_type> <form_type>
<name>http://jabber.org/protocol/pubsub#metadata</name> <name>http://jabber.org/protocol/pubsub#meta-data</name>
<doc>XEP-0060</doc> <doc>XEP-0060</doc>
<desc>Forms enabling setting of metadata information about pubsub nodes</desc> <desc>Forms enabling setting of metadata information about pubsub nodes</desc>
<field var='pubsub#contact' <field var='pubsub#contact'
@ -7022,7 +7028,7 @@ xmpp:pubsub.shakespeare.lit?pubsub;action=retrieve;node=princely_musings
<xs:enumeration value='leased-subscription'/> <xs:enumeration value='leased-subscription'/>
<xs:enumeration value='manage-subscriptions'/> <xs:enumeration value='manage-subscriptions'/>
<xs:enumeration value='member-affiliation'/> <xs:enumeration value='member-affiliation'/>
<xs:enumeration value='metadata'/> <xs:enumeration value='meta-data'/>
<xs:enumeration value='modify-affiliations'/> <xs:enumeration value='modify-affiliations'/>
<xs:enumeration value='multi-collection'/> <xs:enumeration value='multi-collection'/>
<xs:enumeration value='multi-items'/> <xs:enumeration value='multi-items'/>

View File

@ -31,6 +31,12 @@
<email>nickbp@gmail.com</email> <email>nickbp@gmail.com</email>
<jid>nickp@jabber.org</jid> <jid>nickp@jabber.org</jid>
</author> </author>
<revision>
<version>0.3.0</version>
<date>2021-08-03</date>
<initials>rm</initials>
<remark><p>Revert change from version 0.2.1 which changed meta-data to metadata in wire protocol. That was an unintended breaking change which has now been reverted.</p></remark>
</revision>
<revision> <revision>
<version>0.2.1</version> <version>0.2.1</version>
<date>2018-11-03</date> <date>2018-11-03</date>
@ -133,7 +139,7 @@
<configure node='juliets_sonnets'/> <configure node='juliets_sonnets'/>
<x xmlns='jabber:x:data' type='submit'> <x xmlns='jabber:x:data' type='submit'>
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
<value>http://jabber.org/protocol/pubsub#metadata</value> <value>http://jabber.org/protocol/pubsub#meta-data</value>
</field> </field>
<field var='pubsub#title'><value>Juliet's Sonnets</value></field> <field var='pubsub#title'><value>Juliet's Sonnets</value></field>
<field var='pubsub#description'><value>Optional Description</value></field> <field var='pubsub#description'><value>Optional Description</value></field>
@ -169,7 +175,7 @@
<configure node='35227eec194a4f3971a5f3771e9c2271'/> <configure node='35227eec194a4f3971a5f3771e9c2271'/>
<x xmlns='jabber:x:data' type='submit'> <x xmlns='jabber:x:data' type='submit'>
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
<value>http://jabber.org/protocol/pubsub#metadata</value> <value>http://jabber.org/protocol/pubsub#meta-data</value>
</field> </field>
<field var='pubsub#title'><value>Sonnets About Romeo</value></field> <field var='pubsub#title'><value>Sonnets About Romeo</value></field>
<field var='pubsub#description'><value>Optional Description</value></field> <field var='pubsub#description'><value>Optional Description</value></field>
@ -224,7 +230,7 @@
<configure node='a6190c5d38e22452041d1c5798eff3f5'> <configure node='a6190c5d38e22452041d1c5798eff3f5'>
<x xmlns='jabber:x:data' type='submit'> <x xmlns='jabber:x:data' type='submit'>
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
<value>http://jabber.org/protocol/pubsub#metadata</value> <value>http://jabber.org/protocol/pubsub#meta-data</value>
</field> </field>
<field var='pubsub#title'><value>sonnet.txt</value></field> <field var='pubsub#title'><value>sonnet.txt</value></field>
<field var='pubsub#description'><value>Sonnet 42</value></field> <field var='pubsub#description'><value>Sonnet 42</value></field>
@ -338,7 +344,7 @@
<configuration node='a6190c5d38e22452041d1c5798eff3f5'> <configuration node='a6190c5d38e22452041d1c5798eff3f5'>
<x xmlns='jabber:x:data' type='result'> <x xmlns='jabber:x:data' type='result'>
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
<value>http://jabber.org/protocol/pubsub#metadata</value> <value>http://jabber.org/protocol/pubsub#meta-data</value>
</field> </field>
<field var='pubsub#description'><var>Sonnet 42</var></field> <field var='pubsub#description'><var>Sonnet 42</var></field>
<field var='pubsub#title'><var>sonnet.txt</var></field> <field var='pubsub#title'><var>sonnet.txt</var></field>

View File

@ -31,6 +31,12 @@
<email>bjc@kublai.com</email> <email>bjc@kublai.com</email>
<jid>bjc@kublai.com</jid> <jid>bjc@kublai.com</jid>
</author> </author>
<revision>
<version>0.3.0</version>
<date>2021-08-03</date>
<initials>rm</initials>
<remark>Revert change from version 0.2.1 which changed meta-data to metadata in wire protocol. That was an unintended breaking change which has now been reverted.</remark>
</revision>
<revision> <revision>
<version>0.2.1</version> <version>0.2.1</version>
<date>2018-11-03</date> <date>2018-11-03</date>
@ -265,7 +271,7 @@
<associate node='new-node-id'> <associate node='new-node-id'>
<x xmlns='jabber:x:data' type='result'> <x xmlns='jabber:x:data' type='result'>
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
<value>http://jabber.org/protocol/pubsub#metadata</value> <value>http://jabber.org/protocol/pubsub#meta-data</value>
</field> </field>
<field var='pubsub#creation_date'> <field var='pubsub#creation_date'>
<value>2003-07-29T22:56Z</value> <value>2003-07-29T22:56Z</value>