Tweak the 'complete' wording to reflect intent

This commit is contained in:
Kevin Smith 2018-07-16 11:10:16 +01:00
parent b1a5beb96b
commit fc81b38d47
1 changed files with 7 additions and 1 deletions

View File

@ -28,6 +28,12 @@
</schemaloc>
&mwild;
&ksmith;
<revision>
<version>0.6.3</version>
<date>2018-07-16</date>
<initials>ks</initials>
<remark>Tweak the 'complete' wording to more clearly reflect original intent</remark>
</revision>
<revision>
<version>0.6.2</version>
<date>2018-07-05</date>
@ -422,7 +428,7 @@
]]></example>
<p>Note: There is no concept of an "open query", and servers MUST be prepared to receive arbitrary page requests at any time.</p>
<p>If the UID contained within an &lt;after&gt; or &lt;before&gt; element is not present in the archive, the server MUST return an item-not-found error in response to the query.</p>
<p>When the results returned by the server are complete (that is: when they are the last page of the result set), the server MUST include a 'complete' attribute on the &lt;fin&gt; element, with a value of 'true'. If it is not the last page of the result set, the server MUST either omit the 'complete' attribute, or give it a value of 'false'.</p>
<p>When the results returned by the server are complete (that is: when they have not been limited by the maximum size of the result page (either as specified or enforced by the server)), the server MUST include a 'complete' attribute on the &lt;fin&gt; element, with a value of 'true'; this informs the client that it doesn't need to perform further paging to retreive the requested data. If it is not the last page of the result set, the server MUST either omit the 'complete' attribute, or give it a value of 'false'.</p>
<example caption='Server completes a result with the last page of messages'><![CDATA[
<!-- result messages -->
<iq type='result' id='u29303'>