Google Git
Sign in
gerrit / gerrit / 905f15c9552de9cfe531745b0a0ac0eb15248939 / . / Documentation / cmd-set-reviewers.txt
blob: 79f7651f53c852478ad93d106c00c3619f6dcd6c [file] [log] [blame]
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -0800[diff] [blame]1= gerrit set-reviewers
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]2
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -0800[diff] [blame]3== NAME
Edwin Kempin33e92d02011-07-11 22:00:57 +0200[diff] [blame]4gerrit set-reviewers - Add or remove reviewers to a change
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]5
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -0800[diff] [blame]6== SYNOPSIS
Yuxuan 'fishy' Wangd85b6872013-11-15 11:47:46 -0800[diff] [blame]7--
Edwin Kempin33e92d02011-07-11 22:00:57 +0200[diff] [blame]8'ssh' -p <port> <host> 'gerrit set-reviewers'
Edwin Kempin73b26982012-07-16 13:53:22 +0200[diff] [blame]9 [--project <PROJECT> | -p <PROJECT>]
10 [--add <REVIEWER> ... | -a <REVIEWER> ...]
11 [--remove <REVIEWER> ... | -r <REVIEWER> ...]
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]12 [--]
13 {COMMIT | CHANGE-ID}...
Yuxuan 'fishy' Wangd85b6872013-11-15 11:47:46 -0800[diff] [blame]14--
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]15
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -0800[diff] [blame]16== DESCRIPTION
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]17Adds or removes reviewers to the specified change, sending email
18notifications when changes are made.
19
20Changes should be specified as complete or abbreviated Change-Ids
21such as 'Iac6b2ac2'. They may also be specified by numeric change
22identifiers, such as '8242' or by complete or abbreviated commit
23SHA-1s.
24
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -0800[diff] [blame]25== OPTIONS
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]26
27--project::
28-p::
29 Name of the project the intended change is contained within. This
David Pursehouse2c6f6382014-09-04 13:06:19 +0900[diff] [blame]30 option must be supplied before Change-Id in order to take effect.
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]31
32--add::
33-a::
Edwin Kempin5e65d9b2011-07-08 07:35:48 +0200[diff] [blame]34 A user that should be added as reviewer to the change or a group
35 for which all members should be added as reviewers to the change.
36 Multiple users and groups can be added at once as reviewers by
37 using this option multiple times.
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]38
39--remove::
40-r::
Edwin Kempin5e65d9b2011-07-08 07:35:48 +0200[diff] [blame]41 Remove this user from the reviewer list of the change. Multiple
42 users can be removed at once from the reviewer list by using this
43 option multiple times.
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]44
45--help::
46-h::
47 Display site-specific usage information
48
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -0800[diff] [blame]49== ACCESS
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]50Any user who has configured an SSH key.
51
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -0800[diff] [blame]52== SCRIPTING
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]53This command is intended to be used in scripts.
54
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -0800[diff] [blame]55== EXAMPLES
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]56
57Add reviewers alice and bob, but remove eve from change Iac6b2ac2.
58=====
Edwin Kempin33e92d02011-07-11 22:00:57 +0200[diff] [blame]59 $ ssh -p 29418 review.example.com gerrit set-reviewers \
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]60 -a alice@example.com -a bob@example.com \
61 -r eve@example.com \
62 Iac6b2ac2
63=====
64
65Add reviewer elvis to old-style change id 1935 specifying that the change is in project "graceland"
66=====
Edwin Kempin33e92d02011-07-11 22:00:57 +0200[diff] [blame]67 $ ssh -p 29418 review.example.com gerrit set-reviewers \
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]68 --project graceland \
69 -a elvis@example.com \
70 1935
71=====
72
Edwin Kempin5e65d9b2011-07-08 07:35:48 +0200[diff] [blame]73Add all project owners as reviewers to change Iac6b2ac2.
74=====
Edwin Kempin33e92d02011-07-11 22:00:57 +0200[diff] [blame]75 $ ssh -p 29418 review.example.com gerrit set-reviewers \
Edwin Kempin5e65d9b2011-07-08 07:35:48 +0200[diff] [blame]76 -a "'Project Owners'" \
77 Iac6b2ac2
78=====
79
Conley Owensf3ea0ab2011-06-10 11:34:34 -0700[diff] [blame]80GERRIT
81------
82Part of link:index.html[Gerrit Code Review]
Yuxuan 'fishy' Wang99cb68d2013-10-31 17:26:00 -0700[diff] [blame]83
84SEARCHBOX
85---------