Skip to content

Commit

Permalink
XEP-0060: Explicitely say that items are returned in chronological or…
Browse files Browse the repository at this point in the history
…der.
  • Loading branch information
goffi-contrib committed Nov 6, 2021
1 parent 766ed2e commit 10bda8f
Showing 1 changed file with 8 additions and 0 deletions.
8 changes: 8 additions & 0 deletions xep-0060.xml
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,12 @@
&pgmillard;
&stpeter;
&ralphm;
<revision>
<version>1.22.1</version>
<date>2021-11-06</date>
<initials>jp</initials>
<remark><p>Explicitely say that items are returned in chronological order.</p></remark>
</revision>
<revision>
<version>1.22.0</version>
<date>2021-09-07</date>
Expand Down Expand Up @@ -2215,6 +2221,7 @@ And by opposing end them?
</section3>
<section3 topic='Returning All Items' anchor='subscriber-retrieve-returnall'>
<p>The service then SHOULD return all available items at the node, although it MAY truncate the result set if a large number of items has been published (see next section) and naturally it cannot return items that have been deleted, expired, etc.</p>
<p>By default, items are returned in chronological order. This order can be explicitely modified by an extensions like &xep0413;.</p>
<example caption='Service returns all items'><![CDATA[
<iq type='result'
from='pubsub.shakespeare.lit'
Expand Down Expand Up @@ -2291,6 +2298,7 @@ And by opposing end them?
<section3 topic='Returning Some Items' anchor='subscriber-retrieve-returnsome'>
<p>A node may have a large number of items associated with it, in which case it may be problematic to return all of the items in response to an items request. In this case, the service SHOULD return some of the items and note that the list of items has been truncated by including a &xep0059; notation.</p>
<p>A Pubsub entity supporting &xep0059; SHOULD include a feature of "http://jabber.org/protocol/pubsub#rsm" in its disco#info response, to make it clear that the RSM feature is for PubSub, and not for e.g., &xep0313;.</p>
<p>In the same way as for <link url="#subscriber-retrieve-returnal">Returning All Items</link>, items are by default returned in chronological order globally and inside pages. This order can be modified by extensions such as &xep0413;.</p>
<example caption='Service returns some items via result set management'><![CDATA[
<iq type='result'
from='pubsub.shakespeare.lit'
Expand Down

0 comments on commit 10bda8f

Please sign in to comment.