git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Jonathan Nieder <jrnieder@gmail.com>
To: Peter Krefting <peter@softwolves.pp.se>
Cc: Boaz Harrosh <bharrosh@panasas.com>,
	Git Mailing List <git@vger.kernel.org>,
	Johan Herland <johan@herland.net>, Lars Hjemli <hjemli@gmail.com>
Subject: [PATCH] gitmodules.5: url can be a relative path
Date: Thu, 15 Jul 2010 02:41:55 -0500	[thread overview]
Message-ID: <20100715074155.GA22244@burratino> (raw)
In-Reply-To: <alpine.DEB.2.00.1007150745340.13735@perkele.intern.softwolves.pp.se>

There is already excellent documentation for this facility in
git-submodule.1, but it is not so discoverable.

Relative paths in .gitmodules can be useful for serving the
same repository over multiple protocols, for example.
Thanks to Peter for pointing this out.

Cc: Peter Krefting <peter@softwolves.pp.se>
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
---
 Documentation/gitmodules.txt |    3 +++
 1 files changed, 3 insertions(+), 0 deletions(-)

diff --git a/Documentation/gitmodules.txt b/Documentation/gitmodules.txt
index 5daf750..72a13d1 100644
--- a/Documentation/gitmodules.txt
+++ b/Documentation/gitmodules.txt
@@ -29,6 +29,9 @@ submodule.<name>.path::
 
 submodule.<name>.url::
 	Defines an url from where the submodule repository can be cloned.
+	This may be either an absolute URL ready to be passed to
+	linkgit:git-clone[1] or (if it begins with ./ or ../) a location
+	relative to the superproject's origin repository.
 
 submodule.<name>.update::
 	Defines what to do when the submodule is updated by the superproject.
-- 
1.7.2.rc2

  reply	other threads:[~2010-07-15  7:43 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2010-07-14 15:29 serving git with both "git:" and "http:" and submodules Boaz Harrosh
2010-07-14 15:39 ` Jonathan Nieder
2010-07-14 15:58   ` Boaz Harrosh
2010-07-14 16:12     ` Jonathan Nieder
2010-07-15 14:07   ` Brad King
2010-07-15  6:46 ` Peter Krefting
2010-07-15  7:41   ` Jonathan Nieder [this message]
2010-07-15  7:51     ` [PATCH] Documentation: add submodule.* to the big configuration variable list Jonathan Nieder
2010-07-15  9:34       ` Johan Herland
2010-07-15 23:12         ` Jonathan Nieder
2010-07-15  9:32     ` [PATCH] gitmodules.5: url can be a relative path Johan Herland
2010-07-15 10:13     ` Boaz Harrosh

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20100715074155.GA22244@burratino \
    --to=jrnieder@gmail.com \
    --cc=bharrosh@panasas.com \
    --cc=git@vger.kernel.org \
    --cc=hjemli@gmail.com \
    --cc=johan@herland.net \
    --cc=peter@softwolves.pp.se \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).