[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