From 098272e6be7846fab57961270a181316341ecafa Mon Sep 17 00:00:00 2001 From: Alan Tokaev Date: Fri, 8 Aug 2014 23:22:01 +0200 Subject: [PATCH] SSH query command: Remove resume_sortkey query operator Remove resume_sortkey from query command documentation that was missed in I6a82965db. Change-Id: Iecc1c4638322b8d74ed3ab84e5792b3c2b3c7da7 --- Documentation/cmd-query.txt | 16 ++++------------ 1 file changed, 4 insertions(+), 12 deletions(-) diff --git a/Documentation/cmd-query.txt b/Documentation/cmd-query.txt index 0a04441204..538b6ed4fd 100644 --- a/Documentation/cmd-query.txt +++ b/Documentation/cmd-query.txt @@ -19,7 +19,6 @@ gerrit query - Query the change database [--] [limit:] - [resume_sortkey:] -- == DESCRIPTION @@ -34,9 +33,8 @@ older patch set (for example an older patch set's sha1 revision). A query may be limited on the number of results it returns with the 'limit:' operator. If no limit is supplied an internal default limit is used to prevent explosion of the result set. To obtain -results beyond the limit, the 'resume_sortkey:' operator can be used -to resume the query at the change that follows the last change of -the prior result set. +results beyond the limit, the '--start' flag can be used to resume +the query after skipping a certain number of results. Non-option arguments to this command are joined with spaces and then parsed as a query. This simplifies calling conventions over @@ -106,12 +104,6 @@ limit::: than one limit: operator is provided, the smallest limit will be used to cut the result set. -resume_sortkey::: - Resume results from this sort key. Callers should pass - the sortKey of the last change of the prior result set to - resume a prior query. This is actually a query operator, - and not a command line option. - == ACCESS Any user who has configured an SSH key. @@ -128,9 +120,9 @@ Find the 2 most recent open changes in the tools/gerrit project: {"type":"stats","rowCount":2,"runningTimeMilliseconds:15} ==== -Resume the same query and obtain the final results: +Skip number of changes: ==== - $ ssh -p 29418 review.example.com gerrit query --format=JSON status:open project:tools/gerrit limit:2 resume_sortkey:000e6aee00003e26 + $ ssh -p 29418 review.example.com gerrit query --format=JSON --start 42 status:open project:tools/gerrit limit:2 {"project":"tools/gerrit", ...} {"project":"tools/gerrit", ...} {"type":"stats","rowCount":1,"runningTimeMilliseconds:15}