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>
[limit:<n>]
[resume_sortkey:<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:<n>::
than one limit: operator is provided, the smallest limit
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
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}