[PATCH 2/3] Add gitmodules(5)
From: Lars Hjemli <hidden>
Date: 2016-06-15 22:43:15
Subsystem:
documentation, the rest · Maintainers:
Jonathan Corbet, Linus Torvalds
This adds documentation for the .gitmodules file. Signed-off-by: Lars Hjemli <redacted> --- Documentation/Makefile | 2 +- Documentation/gitmodules.txt | 63 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 64 insertions(+), 1 deletions(-) create mode 100644 Documentation/gitmodules.txt
diff --git a/Documentation/Makefile b/Documentation/Makefile
index 9cef480..2ad18e0 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile@@ -2,7 +2,7 @@ MAN1_TXT= \ $(filter-out $(addsuffix .txt, $(ARTICLES) $(SP_ARTICLES)), \ $(wildcard git-*.txt)) \ gitk.txt -MAN5_TXT=gitattributes.txt gitignore.txt +MAN5_TXT=gitattributes.txt gitignore.txt gitmodules.txt MAN7_TXT=git.txt DOC_HTML=$(patsubst %.txt,%.html,$(MAN1_TXT) $(MAN5_TXT) $(MAN7_TXT))
diff --git a/Documentation/gitmodules.txt b/Documentation/gitmodules.txt
new file mode 100644
index 0000000..37888c9
--- /dev/null
+++ b/Documentation/gitmodules.txt@@ -0,0 +1,63 @@ +gitmodules(5) +============= + +NAME +---- +gitmodules - defining submodule properties + +SYNOPSIS +-------- +.gitmodules + + +DESCRIPTION +----------- + +The `.gitmodules` file, located in the top-level directory of a +gitlink:git[7] working tree, is a text file with a layout matching the +requirements of gitlink:git-config[1]. + +The file consists of sections named `module`, divided into one subsection +per submodule. The subsections are named with the logical name of the +submodule it describes. + +Each submodule can contain the following keys. + +module.$name.path:: + Define a path, relative to the top-level directory of the git + working tree, where the submodule is expected to be checked out. + +module.$name.url:: + Define a url from where the submodule repository can be cloned. + + +EXAMPLES +-------- + +Consider the following .gitmodules file: + + [module 'libfoo'] + path = include/foo + url = git://example1.com/git/libfoo.git + + [module 'libbar'] + url = git://example2.com/pub/git/libbar.git + + +This defines two submodules, `libfoo` and `libbar`. The former specifies +both a checkout path and a suggested url, while the latter only specifies +a url. This file would make gitlink:git-submodule[1] map the path +`include/foo` to the submodule `libfoo` and the path `libbar` to the +submodule `libbar`. + +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
--
1.5.2.1.914.gbd3a7