Merge branch 'xep-0313' into premerge

This commit is contained in:
Jonas Schäfer 2021-08-31 17:29:17 +02:00
commit 8280a72a43
1 changed files with 36 additions and 1 deletions

View File

@ -29,6 +29,14 @@
</schemaloc>
&mwild;
&ksmith;
<revision>
<version>0.7.4</version>
<date>2021-08-23</date>
<initials>ssw</initials>
<remark>
<p>Add implementation note about before/after and before-id/after-id</p>
</remark>
</revision>
<revision>
<version>0.7.3</version>
<date>2021-03-02</date>
@ -403,7 +411,11 @@
<section3 topic='Limiting results by id' anchor='query-limit-id'>
<p>If the client has already seen some messages, it may choose to restrict its query to
before and/or after messages it already knows about. This may be done through the 'before-id'
and 'after-id' fields.</p>
and 'after-id' fields.
In some cases 'before-id' and 'after-id' are the same as using RSM's
'before' and 'after' parameters. For more information, see the
<link url='#impl'>Implementation Considerations</link> section.
</p>
<example caption='Querying the archive for all messages after a certain message'><![CDATA[
<iq type='set' id='juliet1'>
<query xmlns='urn:xmpp:mam:2'>
@ -886,6 +898,29 @@
</section2>
</section1>
<section1 topic='Implementation Considerations' anchor='impl'>
<p>
Queries in the 'urn:xmpp:mam:2' namespace can be limited using the RSM
'before' and 'after' parameters.
Normally these are opaque identifiers that are not known until the results
of the first query are returned at which point they can be used to fetch
subsequent pages.
However, MAM specifically defines them as being equal to the archive ID,
meaning that an acceptable value can be known and used in the initial query.
This makes them equivalent to 'before-id' and 'after-id' defined in the
'urn:xmpp:mam:2#extended' namespace except for the following differences:
</p>
<ol>
<li>
The behavior of using RSM's 'before' and 'after' together is undefined,
</li>
<li>
And using 'before' implies paging backwards through the result set while
using 'before-id' does not.
</li>
</ol>
</section1>
<section1 topic='XMPP Registrar Considerations' anchor='registrar'>
<section2 topic='Protocol Namespaces' anchor='registrar-ns'>
<p>This specification defines the following XML namespace:</p>