From: Jonathan Nieder <jrnieder@gmail.com>
Date: Thu, 15 Jul 2010 07:41:55 +0000 (-0500)
Subject: gitmodules.5: url can be a relative path
X-Git-Tag: v1.7.2~7^2~3
X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=47dc5d5fda291bc399da54648ca27e8df4ddfd2c;p=git.git

gitmodules.5: url can be a relative path

There is already excellent documentation for this facility in
git-submodule.1, but it is not so discoverable.

Relative paths in .gitmodules can be useful for serving the
same repository over multiple protocols, for example.
Thanks to Peter for pointing this out.

Cc: Peter Krefting <peter@softwolves.pp.se>
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Acked-by: Johan Herland <johan@herland.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
---

diff --git a/Documentation/gitmodules.txt b/Documentation/gitmodules.txt
index 5daf750d1..72a13d18e 100644
--- a/Documentation/gitmodules.txt
+++ b/Documentation/gitmodules.txt
@@ -29,6 +29,9 @@ submodule.<name>.path::
 
 submodule.<name>.url::
 	Defines an url from where the submodule repository can be cloned.
+	This may be either an absolute URL ready to be passed to
+	linkgit:git-clone[1] or (if it begins with ./ or ../) a location
+	relative to the superproject's origin repository.
 
 submodule.<name>.update::
 	Defines what to do when the submodule is updated by the superproject.