| gerrit review | |
| ============== | |
| NAME | |
| ---- | |
| gerrit review - Verify, approve and/or submit one or more patch sets | |
| SYNOPSIS | |
| -------- | |
| [verse] | |
| 'ssh' -p <port> <host> 'gerrit review' | |
| [--project <PROJECT> | -p <PROJECT>] | |
| [--message <MESSAGE> | -m <MESSAGE>] | |
| [--submit | -s] | |
| [--abandon | --restore] | |
| [--publish] | |
| [--delete] | |
| [--verified <N>] [--code-review <N>] | |
| [--label Label-Name=<N>] | |
| {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 may be specified in 'CHANGEID,PATCHSET' format, such as | |
| '8242,2', or 'COMMIT' format. | |
| If a patch set is specified with the 'COMMIT' format, the complete | |
| or abbreviated commit SHA-1 may be used. 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. | |
| 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. | |
| --abandon:: | |
| Abandon the specified change(s). | |
| (option is mutually exclusive with --submit and --restore) | |
| --restore:: | |
| Restore the specified abandoned change(s). | |
| (option is mutually exclusive with --abandon) | |
| --submit:: | |
| -s:: | |
| Submit the specified patch set(s) for merging. | |
| (option is mutually exclusive with --abandon) | |
| --publish:: | |
| Publish the specified draft patch set(s). | |
| (option is mutually exclusive with --submit, --restore, --abandon, and --delete) | |
| --delete:: | |
| Delete the specified draft patch set(s). | |
| (option is mutually exclusive with --submit, --restore, --abandon, and --publish) | |
| --code-review:: | |
| --verified:: | |
| Set the label 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. These options are only available for these | |
| built-in labels; for other labels, see --label. | |
| --label:: | |
| Set a label by name to the value 'N'. | |
| 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"' c0ff33 | |
| ===== | |
| 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) | |
| ==== | |
| Abandon an active change: | |
| ==== | |
| $ ssh -p 29418 review.example.com gerrit review --abandon c0ff33 | |
| ==== | |
| SEE ALSO | |
| -------- | |
| * link:access-control.html[Access Controls] | |
| GERRIT | |
| ------ | |
| Part of link:index.html[Gerrit Code Review] |