9c0cfc22f6
Bug: issue 800 Change-Id: I39c30c0ac148bc6bc86b618b8e3936512ce47683 Signed-off-by: Shawn O. Pearce <sop@google.com>
112 lines
3.1 KiB
Plaintext
112 lines
3.1 KiB
Plaintext
gerrit review
|
|
==============
|
|
|
|
NAME
|
|
----
|
|
gerrit review - Verify, approve and/or submit one or more patch sets
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'ssh' -p <port> <host> 'gerrit approve' [\--project <PROJECT>] [\--message <MESSAGE>] [\--verified <N>] [\--code-review <N>] [\--abandon] [\--restore] [\--submit] {COMMIT | CHANGEID,PATCHSET}...
|
|
'ssh' -p <port> <host> 'gerrit review' [\--project <PROJECT>] [\--message <MESSAGE>] [\--verified <N>] [\--code-review <N>] [\--abandon] [\--restore] [\--submit] {COMMIT | CHANGEID,PATCHSET}...
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Updates the current user's approval status of the specified patch
|
|
sets and/or submits them for merging, sending out email
|
|
notifications and updating the database.
|
|
|
|
Patch sets should be specified as complete or abbreviated commit
|
|
SHA-1s. If the same commit is available in multiple projects the
|
|
\--project option may be used to limit where Gerrit searches for
|
|
the change to only the contents of the specified project.
|
|
|
|
For current backward compatibility with user tools patch sets may
|
|
also be specified in the legacy 'CHANGEID,PATCHSET' format, such as
|
|
'8242,2'. Support for this legacy format is planned to be removed
|
|
in a future edition of Gerrit Code Review. Use of commit SHA-1s
|
|
is strongly encouraged.
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
\--project::
|
|
-p::
|
|
Name of the project the intended changes are contained
|
|
within. This option must be supplied before the commit
|
|
SHA-1 in order to take effect.
|
|
|
|
\--message::
|
|
-m::
|
|
Optional cover letter to include as part of the message
|
|
sent to reviewers when the approval states are updated.
|
|
|
|
\--help::
|
|
-h::
|
|
Display site-specific usage information, including the
|
|
complete listing of supported approval categories and values.
|
|
|
|
\--code-review::
|
|
\--verified::
|
|
Set the approval category to the value 'N'. The exact
|
|
option names supported and the range of values permitted
|
|
differs per site, check the output of \--help, or contact
|
|
your site administrator for further details.
|
|
|
|
\--abandon::
|
|
Abandon the specified patch set(s).
|
|
(option is mutually exclusive with --submit and --restore)
|
|
|
|
\--restore::
|
|
Restore the specified abandonned patch set(s).
|
|
(option is mutually exclusive with --abandon)
|
|
|
|
\--submit::
|
|
-s::
|
|
Submit the specified patch set(s) for merging.
|
|
(option is mutually exclusive with --abandon)
|
|
|
|
ACCESS
|
|
------
|
|
Any user who has configured an SSH key.
|
|
|
|
SCRIPTING
|
|
---------
|
|
This command is intended to be used in scripts.
|
|
|
|
EXAMPLES
|
|
--------
|
|
|
|
Approve the change with commit c0ff33 as "Verified +1"
|
|
=====
|
|
$ ssh -p 29418 review.example.com gerrit review --verified=+1 c0ff33
|
|
=====
|
|
|
|
Append the message "Build Successful". Notice two levels of quoting is
|
|
required, one for the local shell, and another for the argument parser
|
|
inside the Gerrit server:
|
|
=====
|
|
$ ssh -p 29418 review.example.com gerrit review -m '"Build Successful"'
|
|
=====
|
|
|
|
Mark the unmerged commits both "Verified +1" and "Code Review +2" and
|
|
submit them for merging:
|
|
====
|
|
$ ssh -p 29418 review.example.com gerrit review \
|
|
--verified=+1 \
|
|
--code-review=+2 \
|
|
--submit \
|
|
--project=this/project \
|
|
$(git rev-list origin/master..HEAD)
|
|
====
|
|
|
|
SEE ALSO
|
|
--------
|
|
|
|
* link:access-control.html[Access Controls]
|
|
|
|
GERRIT
|
|
------
|
|
Part of link:index.html[Gerrit Code Review]
|