summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLuca Milanesio <luca.milanesio@gmail.com>2021-11-26 14:51:23 +0000
committerLuca Milanesio <luca.milanesio@gmail.com>2021-11-26 14:51:23 +0000
commit9a76d4505e0f327db5d2b2a650b1c1985c26077b (patch)
tree54948140eb2c4d1b25af808c72237b8eef94b2a3
parent7d9ba0d543e8212b73d8cf8e2e2d5764b63b7678 (diff)
parentbad55d97ac86f6b16b63a1c4870762aa101332d8 (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.md11
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.