diff options
author | Luca Milanesio <luca.milanesio@gmail.com> | 2021-11-26 14:50:31 +0000 |
---|---|---|
committer | Luca Milanesio <luca.milanesio@gmail.com> | 2021-11-26 14:50:31 +0000 |
commit | bad55d97ac86f6b16b63a1c4870762aa101332d8 (patch) | |
tree | 7edb537c08cc5798865f81a510389179cd21f89c | |
parent | 2f69b53b8c64b696d6819b4355ea3ac76d8f1293 (diff) | |
parent | d9f7c9387119e67bef20fe795975763f3bf50be9 (diff) |
* stable-3.2:
Doc: make explicit that remoteNameStyle is for non-Gerrit repos
Doc: remoteNameStyle might result in a repo name clashes
Change-Id: I32d598a36fe20c469528eca8d4c10d8775f7a3c4
-rw-r--r-- | src/main/resources/Documentation/config.md | 11 |
1 files changed, 10 insertions, 1 deletions
diff --git a/src/main/resources/Documentation/config.md b/src/main/resources/Documentation/config.md index d606b7b..13e10ea 100644 --- a/src/main/resources/Documentation/config.md +++ b/src/main/resources/Documentation/config.md @@ -434,7 +434,8 @@ remote.NAME.mirror remote.NAME.remoteNameStyle : Provides possibilities to influence the name of the target repository, e.g. by replacing slashes in the `${name}` - placeholder. + placeholder, when the target remote repository is not served + by Gerrit. Github and Gitorious do not permit slashes "/" in repository names and will change them to dashes "-" at repository creation @@ -449,6 +450,14 @@ remote.NAME.remoteNameStyle Gerrit server, e.g. `${name}` of `foo/bar/my-repo.git` would be `my-repo`. + > **NOTE**: The use of repository name translation using `remoteNameStyle` + > may lead to dangerous situations if there are multiple repositories + > that may be mapped to the same target name. For instance when + > mapping `/foo/my-repo.git` to `my-repo` using "basenameOnly" + > would also map `/bar/my-repo.git` to the same `my-repo` leading + > to conflicts where commits can be lost between the two repositories + > replicating to the same target `my-repo`. + By default, "slash", i.e. remote names will contain slashes as they do in Gerrit. |