X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-submodule.txt;h=b72964947afcc39af3b97c5b9eeb1969b44e0d05;hb=bd193f46b70fd3f8a55e2a8dcbb1fb2b4eec13d6;hp=6ec3fef0799222e67cb176d00aae2f583004032d;hpb=79eec363d2f7f77cde3a3f25765e8a72b80f288c;p=git.git

diff --git a/Documentation/git-submodule.txt b/Documentation/git-submodule.txt
index 6ec3fef07..b72964947 100644
--- a/Documentation/git-submodule.txt
+++ b/Documentation/git-submodule.txt
@@ -79,7 +79,12 @@ to exist in the superproject. If <path> is not given, the
 <repository> is the URL of the new submodule's origin repository.
 This may be either an absolute URL, or (if it begins with ./
 or ../), the location relative to the superproject's origin
-repository. If the superproject doesn't have an origin configured
+repository (Please note that to specify a repository 'foo.git'
+which is located right next to a superproject 'bar.git', you'll
+have to use '../foo.git' instead of './foo.git' - as one might expect
+when following the rules for relative URLs - because the evaluation
+of relative URLs in Git is identical to that of relative directories).
+If the superproject doesn't have an origin configured
 the superproject is its own authoritative upstream and the current
 working directory is used instead.
 +