Files
gerrit/Documentation/cmd-set-reviewers.txt
Gert van Dijk dc4f8d1723 Documentation: Also consider the use of kerberos authentication over SSH
Most documentation assumed the use of SSH public key authentication. This
change removes that assumption and adds some hints on client configuration
with OpenSSH and kerberos.

Change-Id: I4d5654a088a68afd740d3e4e91eaf15d0bbf58b1
2017-08-28 01:44:52 +02:00

86 lines
2.0 KiB
Plaintext

= gerrit set-reviewers
== NAME
gerrit set-reviewers - Add or remove reviewers to a change
== SYNOPSIS
[verse]
--
_ssh_ -p <port> <host> _gerrit set-reviewers_
[--project <PROJECT> | -p <PROJECT>]
[--add <REVIEWER> ... | -a <REVIEWER> ...]
[--remove <REVIEWER> ... | -r <REVIEWER> ...]
[--]
{CHANGE-ID}...
--
== DESCRIPTION
Adds or removes reviewers to the specified change, sending email
notifications when changes are made.
Changes can be specified in the
link:rest-api-changes.html#change-id[same format] supported by the REST
API.
== OPTIONS
--project::
-p::
Name of the project the intended change is contained within. This
option must be supplied before Change-Id in order to take effect.
--add::
-a::
A user that should be added as reviewer to the change or a group
for which all members should be added as reviewers to the change.
Multiple users and groups can be added at once as reviewers by
using this option multiple times.
--remove::
-r::
Remove this user from the reviewer list of the change. Multiple
users can be removed at once from the reviewer list by using this
option multiple times.
--help::
-h::
Display site-specific usage information
== ACCESS
Any user who has SSH access to Gerrit.
== SCRIPTING
This command is intended to be used in scripts.
== EXAMPLES
Add reviewers alice and bob, but remove eve from change Iac6b2ac2.
----
$ ssh -p 29418 review.example.com gerrit set-reviewers \
-a alice@example.com -a bob@example.com \
-r eve@example.com \
Iac6b2ac2
----
Add reviewer elvis to old-style change id 1935 specifying that the change is in project "graceland"
----
$ ssh -p 29418 review.example.com gerrit set-reviewers \
--project graceland \
-a elvis@example.com \
1935
----
Add all project owners as reviewers to change Iac6b2ac2.
----
$ ssh -p 29418 review.example.com gerrit set-reviewers \
-a "'Project Owners'" \
Iac6b2ac2
----
GERRIT
------
Part of link:index.html[Gerrit Code Review]
SEARCHBOX
---------