blob: 32fd35e63a981637fb1492e82c19f4184737b91c [file] [log] [blame]
Edwin Kempin33e92d02011-07-11 22:00:57 +02001gerrit set-reviewers
Conley Owens3f41a0a2011-08-03 14:59:04 -07002====================
Conley Owensf3ea0ab2011-06-10 11:34:34 -07003
4NAME
5----
Edwin Kempin33e92d02011-07-11 22:00:57 +02006gerrit set-reviewers - Add or remove reviewers to a change
Conley Owensf3ea0ab2011-06-10 11:34:34 -07007
8SYNOPSIS
9--------
10[verse]
Edwin Kempin33e92d02011-07-11 22:00:57 +020011'ssh' -p <port> <host> 'gerrit set-reviewers'
Edwin Kempin73b26982012-07-16 13:53:22 +020012 [--project <PROJECT> | -p <PROJECT>]
13 [--add <REVIEWER> ... | -a <REVIEWER> ...]
14 [--remove <REVIEWER> ... | -r <REVIEWER> ...]
Conley Owensf3ea0ab2011-06-10 11:34:34 -070015 [--]
16 {COMMIT | CHANGE-ID}...
17
18DESCRIPTION
19-----------
20Adds or removes reviewers to the specified change, sending email
21notifications when changes are made.
22
23Changes should be specified as complete or abbreviated Change-Ids
24such as 'Iac6b2ac2'. They may also be specified by numeric change
25identifiers, such as '8242' or by complete or abbreviated commit
26SHA-1s.
27
28OPTIONS
29-------
30
31--project::
32-p::
33 Name of the project the intended change is contained within. This
34 option must be supplied before Change-ID in order to take effect.
35
36--add::
37-a::
Edwin Kempin5e65d9b2011-07-08 07:35:48 +020038 A user that should be added as reviewer to the change or a group
39 for which all members should be added as reviewers to the change.
40 Multiple users and groups can be added at once as reviewers by
41 using this option multiple times.
Conley Owensf3ea0ab2011-06-10 11:34:34 -070042
43--remove::
44-r::
Edwin Kempin5e65d9b2011-07-08 07:35:48 +020045 Remove this user from the reviewer list of the change. Multiple
46 users can be removed at once from the reviewer list by using this
47 option multiple times.
Conley Owensf3ea0ab2011-06-10 11:34:34 -070048
49--help::
50-h::
51 Display site-specific usage information
52
53ACCESS
54------
55Any user who has configured an SSH key.
56
57SCRIPTING
58---------
59This command is intended to be used in scripts.
60
61EXAMPLES
62--------
63
64Add reviewers alice and bob, but remove eve from change Iac6b2ac2.
65=====
Edwin Kempin33e92d02011-07-11 22:00:57 +020066 $ ssh -p 29418 review.example.com gerrit set-reviewers \
Conley Owensf3ea0ab2011-06-10 11:34:34 -070067 -a alice@example.com -a bob@example.com \
68 -r eve@example.com \
69 Iac6b2ac2
70=====
71
72Add reviewer elvis to old-style change id 1935 specifying that the change is in project "graceland"
73=====
Edwin Kempin33e92d02011-07-11 22:00:57 +020074 $ ssh -p 29418 review.example.com gerrit set-reviewers \
Conley Owensf3ea0ab2011-06-10 11:34:34 -070075 --project graceland \
76 -a elvis@example.com \
77 1935
78=====
79
Edwin Kempin5e65d9b2011-07-08 07:35:48 +020080Add all project owners as reviewers to change Iac6b2ac2.
81=====
Edwin Kempin33e92d02011-07-11 22:00:57 +020082 $ ssh -p 29418 review.example.com gerrit set-reviewers \
Edwin Kempin5e65d9b2011-07-08 07:35:48 +020083 -a "'Project Owners'" \
84 Iac6b2ac2
85=====
86
Conley Owensf3ea0ab2011-06-10 11:34:34 -070087GERRIT
88------
89Part of link:index.html[Gerrit Code Review]