gerrit/Documentation/cmd-set-members.txt
Michael Ochmann b99feabd88 Fix formatting of example blocks
With the new stylesheet example blocks (delimited with ====) are
rendered as rather intrusive boxes with large padding in yellow
and grey.

This patch replaces the example blocks with simple code blocks
(delimited with ----) that better match the overall style of the
documentation.

Change-Id: Id95387cdb153332c2066e2d5e378697647dbca52
Signed-off-by: Michael Ochmann <michael.ochmann@sap.com>
2016-07-07 14:06:31 +02:00

80 lines
1.8 KiB
Plaintext

= gerrit set-members
== NAME
gerrit set-members - Set group members
== SYNOPSIS
[verse]
--
_ssh_ -p <port> <host> _gerrit set-members_
[--add USER ...]
[--remove USER ...]
[--include GROUP ...]
[--exclude GROUP ...]
[--]
<GROUP> ...
--
== DESCRIPTION
Set the group members for the specified groups.
== OPTIONS
<GROUP>::
Required; name of the group for which the members should be set.
The members for multiple groups can be set at once by specifying
multiple groups.
--add::
-a::
A user that should be added to the specified groups. Multiple
users can be added at once by using this option multiple times.
--remove::
-r::
Remove this user from the specified groups. Multiple users can be
removed at once by using this option multiple times.
--include::
-i::
A group that should be included to the specified groups. Multiple
groups can be included at once by using this option multiple
times.
--exclude::
-e::
Exclude this group from the specified groups. Multiple groups can
be excluded at once by using this option multiple times.
The `set-members` command is processing the options in the following
order: `--remove`, `--exclude`, `--add`, `--include`
== ACCESS
Any user who has configured an SSH key.
== SCRIPTING
This command is intended to be used in scripts.
== EXAMPLES
Add alice and bob, but remove eve from the groups my-committers and
my-verifiers.
----
$ ssh -p 29418 review.example.com gerrit set-members \
-a alice@example.com -a bob@example.com \
-r eve@example.com my-committers my-verifiers
----
Include the group my-friends into the group my-committers, but
exclude the included group my-testers from the group my-committers.
----
$ ssh -p 29418 review.example.com gerrit set-members \
-i my-friends -e my-testers my-committers
----
GERRIT
------
Part of link:index.html[Gerrit Code Review]
SEARCHBOX
---------