Add clarifications in the documentation of the query
command
- Add a statement that the result is always for the latest patch set, even if the query matched on an earlier patch set - Add a link to the change attribute documentation from the JSON format option description. - Add clarification in the change attribute documentation that the commit message is of the latest patch set. - Correct a minor typo Change-Id: Ie6a825d1d183994926662c0ad8c42ec15f687e51
This commit is contained in:
parent
ac87b1318b
commit
93a4ae6cb0
@ -28,7 +28,9 @@ DESCRIPTION
|
||||
Queries the change database and returns results describing changes
|
||||
that match the input query. More recently updated changes appear
|
||||
before older changes, which is the same order presented in the
|
||||
web interface.
|
||||
web interface. For each matching change, the result contains data
|
||||
for the change's latest patch set, even if the query matched on an
|
||||
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
|
||||
@ -41,7 +43,7 @@ Non-option arguments to this command are joined with spaces and
|
||||
then parsed as a query. This simplifies calling conventions over
|
||||
SSH by permitting operators to appear in different arguments.
|
||||
|
||||
Query operators may quote values using matched curly braches
|
||||
Query operators may quote values using matched curly braces
|
||||
(e.g. `reviewerin:{Developer Group}`) to sidestep issues with 2
|
||||
levels of shell quoting (caller shell invoking SSH, and the SSH
|
||||
command line parser in the server).
|
||||
@ -49,8 +51,9 @@ command line parser in the server).
|
||||
OPTIONS
|
||||
-------
|
||||
--format::
|
||||
Formatting method for the results. TEXT is the default,
|
||||
presenting a human readable display. JSON creates one line
|
||||
Formatting method for the results. `TEXT` is the default,
|
||||
presenting a human readable display. `JSON` returns
|
||||
link:json.html#change[change attributes], one line
|
||||
per matching record, with embedded LFs escaped.
|
||||
|
||||
--current-patch-set::
|
||||
|
@ -28,7 +28,8 @@ owner:: Owner in <<account,account attribute>>.
|
||||
|
||||
url:: Canonical URL to reach this change.
|
||||
|
||||
commitMessage:: The full commit message for the change.
|
||||
commitMessage:: The full commit message for the change's current patch
|
||||
set.
|
||||
|
||||
createdOn:: Time in seconds since the UNIX epoch when this change
|
||||
was created.
|
||||
|
Loading…
Reference in New Issue
Block a user