[Telepathy-commits] [telepathy-spec/master] Remove x-search-offset.

Will Thompson will.thompson at collabora.co.uk
Fri Mar 20 09:55:32 PDT 2009


This should have been a requestable property, not a pseudo-term. Also,
it's not very useful: you can't be sure that a second search with a
higher offset will actually be indexing the same list of results. If we
want to support protocols which do support paged retrieval of results,
we could add a Paged property, whose value is the number of items per
page, and a NextPage() method, callable while the search is In_Progress,
to ask for the next page. Or something.
---
 spec/Channel_Type_Contact_Search.xml |   18 ------------------
 1 files changed, 0 insertions(+), 18 deletions(-)

diff --git a/spec/Channel_Type_Contact_Search.xml b/spec/Channel_Type_Contact_Search.xml
index 204ecf1..3ec2a42 100644
--- a/spec/Channel_Type_Contact_Search.xml
+++ b/spec/Channel_Type_Contact_Search.xml
@@ -216,24 +216,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
             </tp:rationale>
           </dd>
 
-          <dt><code>x-search-offset</code></dt>
-          <dd>
-            <p>For protocols that support paging results, the offset from the
-              start of the results that should be returned, i.e. the number of
-              contacts from the beginning that should be omitted.</p>
-
-            <p>For example, if the search terms match 50 contacts, this key
-              is set to <code>"20"</code> and <code>x-search-limit</code>
-              is set to <code>"10"</code>, then the ten contacts from the 21st
-              to the 30th should be returned.</p>
-
-            <p>Connection managers for protocols which do not natively support
-              restricting the number of results returned MUST NOT support
-              either this term or <code>x-search-limit</code>: all results
-              should be signalled, and the client can provide its own paging as
-              desired.</p>
-          </dd>
-
           <dt><code>x-search-limit</code></dt>
           <dd>For protocols that support limiting results, the maximum number
             of results that should be returned.  For example, if the search
-- 
1.5.6.5




More information about the telepathy-commits mailing list