path: root/Documentation/gitmodules.txt
diff options
authorLars Hjemli <>2007-06-12 07:05:21 (GMT)
committerJunio C Hamano <>2007-06-12 08:06:21 (GMT)
commit891dbc6e40b93a2fa5c4af74e2684d40fb1aad4c (patch)
tree87171854bc80b8af859bbb5e5fe0cf7653e42b2c /Documentation/gitmodules.txt
parent941987a554812b982094e09c5c817f18be953365 (diff)
Add gitmodules(5)
This adds documentation for the .gitmodules file. Signed-off-by: Lars Hjemli <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/gitmodules.txt')
1 files changed, 62 insertions, 0 deletions
diff --git a/Documentation/gitmodules.txt b/Documentation/gitmodules.txt
new file mode 100644
index 0000000..7814b6a
--- /dev/null
+++ b/Documentation/gitmodules.txt
@@ -0,0 +1,62 @@
+gitmodules - defining submodule properties
+The `.gitmodules` file, located in the top-level directory of a git
+working tree, is a text file with a syntax matching the requirements
+of gitlink:git-config[1].
+The file contains one subsection per submodule, and the subsection value
+is the name of the submodule. Each submodule section also contains the
+following required keys:
+ Defines the path, relative to the top-level directory of the git
+ working tree, where the submodule is expected to be checked out.
+ The path name must not end with a `/`. All submodule paths must
+ be unique within the .gitmodules file.
+ Defines an url from where the submodule repository can be cloned.
+Consider the following .gitmodules file:
+ [submodule "libfoo"]
+ path = include/foo
+ url = git://
+ [submodule "libbar"]
+ path = include/bar
+ url = git://
+This defines two submodules, `libfoo` and `libbar`. These are expected to
+be checked out in the paths 'include/foo' and 'include/bar', and for both
+submodules an url is specified which can be used for cloning the submodules.
+gitlink:git-submodule[1] gitlink:git-config[1]
+Documentation by Lars Hjemli <>
+Part of the gitlink:git[7] suite