[Telepathy-commits] [telepathy-spec/master] Add pseudo-search terms for paging results.

[Will Thompson]

---
 spec/Channel_Type_Contact_Search.xml |   20 ++++++++++++++++++++
 1 files changed, 20 insertions(+), 0 deletions(-)

diff --git a/spec/Channel_Type_Contact_Search.xml b/spec/Channel_Type_Contact_Search.xml
index 77fa79b..a954479 100644
--- a/spec/Channel_Type_Contact_Search.xml
+++ b/spec/Channel_Type_Contact_Search.xml
@@ -203,6 +203,26 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
               Gadu-Gadu and TOC appear to support this.
             </tp:rationale>
           </dd>
+
+          <dt><code>x-search-offset</code></dt>
+          <dd>For protocols that support paging results, the offset from the
+            start of the results that should be returned. For example, if the
+            search terms match <i>Antonius</i>, <i>Bridget</i> and
+            <i>Charles</i> and this key is set to <code>"2"</code>, the search
+            service SHOULD only return <i>Charles</i>.</dd>
+
+          <dd>Connection managers for protocols which do not natively support
+            restricting the number of results returned MUST NOT support this
+            term (or <code>x-search-limit</code>): all results should be
+            signalled, and the client can provide its own paging as
+            desired.</dd>
+
+          <dt><code>x-search-limit</code></dt>
+          <dd>For protocols that support paging results, the maximum number of
+            results that should be returned.  For example, if the search terms
+            match <i>Antonius</i>, <i>Bridget</i> and <i>Charles</i> and this
+            key is set to <code>"2"</code>, the search service SHOULD only
+            return <i>Antonius</i> and <i>Bridget</i>.</dd>
         </dl>
       </tp:docstring>
     </tp:simple-type>
-- 
1.5.6.5