gerrit/Documentation/cmd-set-reviewers.txt
Yuxuan 'fishy' Wang 61698b14e0 Use the new section title style in Asciidoctor.
We previous use the section title style like:

Section level 1
===============

Section level 2
---------------

Which have a problem in Asciidoctor that the number of "="s or "-"s must match
the number of characters in the header exactly, as a result it's easy to make
mistakes while changing the titles. Asciidoctor provides a better style like:

= Section level 1

== Section level 2

So we switched to this style.

Also fixed a bug in replace_macros.py, which will not cause any problem in the
old style.

Change-Id: I811dd7238735d98f662767c17086152cd69aea02
2013-12-20 12:55:51 -08:00

86 lines
2.1 KiB
Plaintext

= gerrit set-reviewers
== NAME
gerrit set-reviewers - Add or remove reviewers to a change
== SYNOPSIS
--
'ssh' -p <port> <host> 'gerrit set-reviewers'
[--project <PROJECT> | -p <PROJECT>]
[--add <REVIEWER> ... | -a <REVIEWER> ...]
[--remove <REVIEWER> ... | -r <REVIEWER> ...]
[--]
{COMMIT | CHANGE-ID}...
--
== DESCRIPTION
Adds or removes reviewers to the specified change, sending email
notifications when changes are made.
Changes should be specified as complete or abbreviated Change-Ids
such as 'Iac6b2ac2'. They may also be specified by numeric change
identifiers, such as '8242' or by complete or abbreviated commit
SHA-1s.
== 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 configured an SSH key.
== 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
---------