summaryrefslogtreecommitdiffstats
path: root/Documentation/cmd-set-project-parent.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/cmd-set-project-parent.txt')
-rw-r--r--Documentation/cmd-set-project-parent.txt36
1 files changed, 29 insertions, 7 deletions
diff --git a/Documentation/cmd-set-project-parent.txt b/Documentation/cmd-set-project-parent.txt
index 699d76ff12..1e7e6c5607 100644
--- a/Documentation/cmd-set-project-parent.txt
+++ b/Documentation/cmd-set-project-parent.txt
@@ -8,15 +8,17 @@ gerrit set-project-parent - Change the project permissions are inherited from.
SYNOPSIS
--------
[verse]
-'ssh' -p <port> <host> 'gerrit set-project-parent' \
-[\--parent <NAME>] \
-<NAME> ...
+'ssh' -p <port> <host> 'gerrit set-project-parent'
+ [--parent <NAME>]
+ [--children-of <NAME>]
+ [--exclude <NAME>]
+ <NAME> ...
DESCRIPTION
-----------
Changes the project that permissions are inherited through.
Every project inherits permissions from another project, by
-default this is `\-- All Projects \--`. This command sets
+default this is `All-Projects`. This command sets
the project to inherit through another one.
ACCESS
@@ -29,9 +31,22 @@ This command is intended to be used in scripts.
OPTIONS
-------
-\--parent::
- Name of the parent to inherit through. If not specified,
- the parent is set back to the default `\-- All Projects \--`.
+--parent::
+ Name of the parent to inherit through. If not specified,
+ the parent is set back to the default `All-Projects`.
+
+--children-of::
+ Name of the parent project for which all child projects should be
+ reparented. If the new parent project or any project in its
+ parent line is a child of this parent project it is automatically
+ excluded from reparenting.
+
+--exclude::
+ Name of a child project that should not be reparented. This
+ option can only be used if the option --children-of is set.
+ Multiple child projects can be excluded from reparenting by
+ specifying the --exclude option multiple times. Excluding a
+ project that is not a child project has no effect.
EXAMPLES
--------
@@ -41,6 +56,13 @@ Configure `kernel/omap` to inherit permissions from `kernel/common`:
$ ssh -p 29418 review.example.com gerrit set-project-parent --parent kernel/common kernel/omap
====
+Reparent all children of `myParent` to `myOtherParent`:
+
+====
+ $ ssh -p 29418 review.example.com gerrit set-project-parent \
+ --children-of myParent --parent myOtherParent
+====
+
SEE ALSO
--------