diff options
author | Luca Milanesio <luca.milanesio@gmail.com> | 2021-11-26 14:51:23 +0000 |
---|---|---|
committer | Luca Milanesio <luca.milanesio@gmail.com> | 2021-11-26 14:51:23 +0000 |
commit | 9a76d4505e0f327db5d2b2a650b1c1985c26077b (patch) | |
tree | 54948140eb2c4d1b25af808c72237b8eef94b2a3 | |
parent | 7d9ba0d543e8212b73d8cf8e2e2d5764b63b7678 (diff) | |
parent | bad55d97ac86f6b16b63a1c4870762aa101332d8 (diff) |
Merge branch 'stable-3.3' into stable-3.4v3.4.3
* stable-3.3:
Doc: make explicit that remoteNameStyle is for non-Gerrit repos
Doc: remoteNameStyle might result in a repo name clashes
Change-Id: I1b2e9c5fd408b8f8bd1a3ef3104182c6f6474559
-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 f4ea9d6..af91032 100644 --- a/src/main/resources/Documentation/config.md +++ b/src/main/resources/Documentation/config.md @@ -443,7 +443,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 @@ -458,6 +459,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. |