path: root/Documentation/git-submodule.txt
diff options
authorMark Levedahl <>2007-09-24 02:19:42 (GMT)
committerJunio C Hamano <>2007-09-25 07:31:12 (GMT)
commitf31a522a2d64a5c7d83047e9234e1722ef63985e (patch)
tree215a391b0da588203277d7e1960a05ed651107c2 /Documentation/git-submodule.txt
parent41ef95aea7c8d8a337af693b601511e099cc468f (diff)
git-submodule - allow a relative path as the subproject url
This allows a subproject's location to be specified and stored as relative to the parent project's location (e.g., ./foo, or ../foo). This url is stored in .gitmodules as given. It is resolved into an absolute url by appending it to the parent project's url when the information is written to .git/config (i.e., during submodule add for the originator, and submodule init for a downstream recipient). This allows cloning of the project to work "as expected" if the project is hosted on a different server than when the subprojects were added. Signed-off-by: Mark Levedahl <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/git-submodule.txt')
1 files changed, 3 insertions, 0 deletions
diff --git a/Documentation/git-submodule.txt b/Documentation/git-submodule.txt
index 2c48936..335e973 100644
--- a/Documentation/git-submodule.txt
+++ b/Documentation/git-submodule.txt
@@ -21,6 +21,9 @@ add::
repository is cloned at the specified path, added to the
changeset and registered in .gitmodules. If no path is
specified, the path is deduced from the repository specification.
+ If the repository url begins with ./ or ../, it is stored as
+ given but resolved as a relative path from the main project's
+ url when cloning.
Show the status of the submodules. This will print the SHA-1 of the