path: root/Documentation/urls.txt
diff options
authorDaniel Barkalow <>2008-02-20 18:43:53 (GMT)
committerJunio C Hamano <>2008-02-25 04:05:29 (GMT)
commit55029ae4dac07942437c0c715ea7c8ac60dd3576 (patch)
treeb2e278bd16f852229e3a3149febb7df98171951b /Documentation/urls.txt
parent2d31347ba5c56d43d64dfdfe04a924178ee55b75 (diff)
Add support for url aliases in config files
This allows users with different preferences for access methods to the same remote repositories to rewrite each other's URLs by pattern matching across a large set of similiarly set up repositories to each get the desired access. For example, if you don't have a account, you might want settings like: [url "git://"] insteadOf = Then, if you give git a URL like: it will act like you gave it: git:// and you can cut-and-paste pull requests in email without fixing them by hand, for example. Signed-off-by: Daniel Barkalow <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/urls.txt')
1 files changed, 23 insertions, 0 deletions
diff --git a/Documentation/urls.txt b/Documentation/urls.txt
index 81ac17f..fa34c67 100644
--- a/Documentation/urls.txt
+++ b/Documentation/urls.txt
@@ -44,3 +44,26 @@ endif::git-clone[]
They are equivalent, except the former implies --local option.
+If there are a large number of similarly-named remote repositories and
+you want to use a different format for them (such that the URLs you
+use will be rewritten into URLs that work), you can create a
+configuration section of the form:
+ [url "<actual url base>"]
+ insteadOf = <other url base>
+For example, with this:
+ [url "git://"]
+ insteadOf = host.xz:/path/to/
+ insteadOf = work:
+a URL like "work:repo.git" or like "host.xz:/path/to/repo.git" will be
+rewritten in any context that takes a URL to be "git://".