summaryrefslogtreecommitdiffstats
path: root/Documentation/cmd-set-reviewers.txt
blob: 5e367c6df460db8bc0a75f6151056d412de6573b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
= 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, as well as with the commit SHA-1 (at least the 7 first characters).

== 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
----

Add all project owners as reviewers to commit 13dff08acca571b22542ebd2e31acf4572ea0b86.
----
$ ssh -p 29418 review.example.com gerrit set-reviewers \
  -a "'Project Owners'" \
  13dff08acca571b22542ebd2e31acf4572ea0b86
----

GERRIT
------
Part of link:index.html[Gerrit Code Review]

SEARCHBOX
---------