From mboxrd@z Thu Jan 1 00:00:00 1970 From: Lars Hjemli Subject: [PATCH 5/5] Add gitmodules(5) Date: Tue, 12 Jun 2007 09:05:21 +0200 Message-ID: <11816319211097-git-send-email-hjemli@gmail.com> References: <20070611225918.GD4323@planck.djpig.de> Cc: Junio C Hamano , git@vger.kernel.org To: Frank Lichtenheld X-From: git-owner@vger.kernel.org Tue Jun 12 09:04:18 2007 Return-path: Envelope-to: gcvg-git@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1Hy0QL-0003zq-MN for gcvg-git@gmane.org; Tue, 12 Jun 2007 09:04:17 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1758879AbXFLHDE (ORCPT ); Tue, 12 Jun 2007 03:03:04 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1753434AbXFLHDD (ORCPT ); Tue, 12 Jun 2007 03:03:03 -0400 Received: from mail42.e.nsc.no ([193.213.115.42]:46200 "EHLO mail42.e.nsc.no" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1759218AbXFLHDA (ORCPT ); Tue, 12 Jun 2007 03:03:00 -0400 Received: from localhost.localdomain (ti231210a341-2365.bb.online.no [85.166.53.63]) by mail42.nsc.no (8.13.8/8.13.5) with ESMTP id l5C72khO026654; Tue, 12 Jun 2007 09:02:46 +0200 (MEST) X-Mailer: git-send-email 1.5.2.1.914.gbd3a7 In-Reply-To: <20070611225918.GD4323@planck.djpig.de> Sender: git-owner@vger.kernel.org Precedence: bulk X-Mailing-List: git@vger.kernel.org Archived-At: This adds documentation for the .gitmodules file. Signed-off-by: Lars Hjemli --- On 6/12/07, Frank Lichtenheld wrote: > On Mon, Jun 11, 2007 at 09:12:25PM +0200, Lars Hjemli wrote: > > +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 > > + > > Still the wrong quotes. Thanks for noticing Documentation/Makefile | 2 +- Documentation/gitmodules.txt | 62 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 63 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..6c7d9bf --- /dev/null +++ b/Documentation/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..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..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 + +GIT +--- +Part of the gitlink:git[7] suite -- 1.5.2.1.914.gbd3a7