opendev/gerrit
Code Issues Proposed changes

SSH query command: Remove resume_sortkey query operator

Browse Source 
Remove resume_sortkey from query command documentation that
was missed in I6a82965db.

Change-Id: Iecc1c4638322b8d74ed3ab84e5792b3c2b3c7da7
This commit is contained in:
Alan Tokaev 2014-08-08 23:22:01 +02:00 committed by Dave Borowitz
parent 6855018bb3
commit 098272e6be
1 changed files with 4 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
Documentation/cmd-query.txt
View File

@ -19,7 +19,6 @@ gerrit query - Query the change database
[--] [--]
<query> <query>
[limit:<n>] [limit:<n>]
[resume_sortkey:<sortKey>]
-- --
== DESCRIPTION == 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 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:' operator. If no limit is supplied an internal default
limit is used to prevent explosion of the result set. To obtain limit is used to prevent explosion of the result set. To obtain
results beyond the limit, the 'resume_sortkey:' operator can be used results beyond the limit, the '--start' flag can be used to resume
to resume the query at the change that follows the last change of the query after skipping a certain number of results.
the prior result set.
Non-option arguments to this command are joined with spaces and Non-option arguments to this command are joined with spaces and
then parsed as a query. This simplifies calling conventions over then parsed as a query. This simplifies calling conventions over
@ -106,12 +104,6 @@ limit:<n>::
than one limit: operator is provided, the smallest limit than one limit: operator is provided, the smallest limit
will be used to cut the result set. will be used to cut the result set.
resume_sortkey:<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 == ACCESS
Any user who has configured an SSH key. 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} {"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", ...}
{"project":"tools/gerrit", ...} {"project":"tools/gerrit", ...}
{"type":"stats","rowCount":1,"runningTimeMilliseconds:15} {"type":"stats","rowCount":1,"runningTimeMilliseconds:15}