@PLUGIN@ rename
===============

NAME
----
@PLUGIN@ rename - Rename a project and update all its changes

SYNOPSIS
--------
```
ssh -p @SSH_PORT@ @SSH_HOST@ @PLUGIN@
  <PROJECT>
  <NEWNAME>
  [--replication]
```

DESCRIPTION
-----------
Renames a project in the Gerrit installation, renaming the Git
repository along with updating any changes associated with it.

ACCESS
------
Caller must be a member of a group that is granted the 'Rename Project'
capability (provided by this plugin) or the 'Administrate Server'
capability.

SCRIPTING
---------
This command is intended to be used in scripts.


OPTIONS
-------
`--replication`
:   To perform only file system rename. This option is used for replication of
    rename operation to other replica instances. This command should not be used
    towards non-replica instances. This option requires the user to have admin
    permissions.

EXAMPLES
--------

Rename a project named 'project-1' to 'project-2':

```
  $ ssh -p @SSH_PORT@ @SSH_HOST@ @PLUGIN@ project-1 project-2
```


SEE ALSO
--------

* [Access Control](../../../Documentation/access-control.html)