summaryrefslogtreecommitdiffstats
path: root/gitmodules.txt
diff options
context:
space:
mode:
authorJunio C Hamano <junio@hera.kernel.org>2007-06-16 09:54:05 +0000
committerJunio C Hamano <junio@hera.kernel.org>2007-06-16 09:54:05 +0000
commit6926bef5df36f65153ad9f9ab9202acc6d44cd5d (patch)
tree5d1c642cbaae99018f2cc259dfdc4202e8780115 /gitmodules.txt
parent9e52d4ea667a8100ea390c15adae60a56a410699 (diff)
downloadgit-htmldocs-6926bef5df36f65153ad9f9ab9202acc6d44cd5d.tar.gz
Autogenerated HTML docs for v1.5.2.2-236-g952c8
Diffstat (limited to 'gitmodules.txt')
-rw-r--r--gitmodules.txt62
1 files changed, 62 insertions, 0 deletions
diff --git a/gitmodules.txt b/gitmodules.txt
new file mode 100644
index 000000000..035294e20
--- /dev/null
+++ b/gitmodules.txt
@@ -0,0 +1,62 @@
+gitmodules(5)
+=============
+
+NAME
+----
+gitmodules - defining submodule properties
+
+SYNOPSIS
+--------
+gitmodules
+
+
+DESCRIPTION
+-----------
+
+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:
+
+submodule.<name>.path::
+ 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.
+
+submodule.<name>.url::
+ Defines an url from where the submodule repository can be cloned.
+
+
+EXAMPLES
+--------
+
+Consider the following .gitmodules file:
+
+ [submodule "libfoo"]
+ path = include/foo
+ url = git://foo.com/git/lib.git
+
+ [submodule "libbar"]
+ path = include/bar
+ url = git://bar.com/git/lib.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.
+
+SEE ALSO
+--------
+gitlink:git-submodule[1] gitlink:git-config[1]
+
+DOCUMENTATION
+-------------
+Documentation by Lars Hjemli <hjemli@gmail.com>
+
+GIT
+---
+Part of the gitlink:git[7] suite