mirror of
https://github.com/git/git
synced 2024-08-27 19:49:21 +00:00
user-manual: mention 'git remote add' for remote branch config
I hardly ever setup remote.<name>.url using 'git config'. While it may be instructive to do so, we should also point out 'git remote add'. Signed-off-by: W. Trevor King <wking@tremily.us> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
parent
d1471e0616
commit
47adb8ac7c
|
@ -2856,48 +2856,34 @@ branch.master.merge=refs/heads/master
|
||||||
|
|
||||||
If there are other repositories that you also use frequently, you can
|
If there are other repositories that you also use frequently, you can
|
||||||
create similar configuration options to save typing; for example,
|
create similar configuration options to save typing; for example,
|
||||||
after
|
|
||||||
|
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
$ git config remote.example.url git://example.com/proj.git
|
$ git remote add example git://example.com/proj.git
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
|
|
||||||
then the following two commands will do the same thing:
|
adds the following to `.git/config`:
|
||||||
|
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
$ git fetch git://example.com/proj.git master:refs/remotes/example/master
|
[remote "example"]
|
||||||
$ git fetch example master:refs/remotes/example/master
|
url = git://example.com/proj.git
|
||||||
|
fetch = +refs/heads/*:refs/remotes/example/*
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
|
|
||||||
Even better, if you add one more option:
|
Also note that the above configuration can be performed by directly
|
||||||
|
editing the file `.git/config` instead of using linkgit:git-remote[1].
|
||||||
|
|
||||||
|
After configuring the remote, the following three commands will do the
|
||||||
|
same thing:
|
||||||
|
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
$ git config remote.example.fetch master:refs/remotes/example/master
|
$ git fetch git://example.com/proj.git +refs/heads/*:refs/remotes/example/*
|
||||||
-------------------------------------------------
|
$ git fetch example +refs/heads/*:refs/remotes/example/*
|
||||||
|
|
||||||
then the following commands will all do the same thing:
|
|
||||||
|
|
||||||
-------------------------------------------------
|
|
||||||
$ git fetch git://example.com/proj.git master:refs/remotes/example/master
|
|
||||||
$ git fetch example master:refs/remotes/example/master
|
|
||||||
$ git fetch example
|
$ git fetch example
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
|
|
||||||
You can also add a "+" to force the update each time:
|
|
||||||
|
|
||||||
-------------------------------------------------
|
|
||||||
$ git config remote.example.fetch +master:refs/remotes/example/master
|
|
||||||
-------------------------------------------------
|
|
||||||
|
|
||||||
Don't do this unless you're sure you won't mind "git fetch" possibly
|
|
||||||
throwing away commits on 'example/master'.
|
|
||||||
|
|
||||||
Also note that all of the above configuration can be performed by
|
|
||||||
directly editing the file .git/config instead of using
|
|
||||||
linkgit:git-config[1].
|
|
||||||
|
|
||||||
See linkgit:git-config[1] for more details on the configuration
|
See linkgit:git-config[1] for more details on the configuration
|
||||||
options mentioned above.
|
options mentioned above and linkgit:git-fetch[1] for more details on
|
||||||
|
the refspec syntax.
|
||||||
|
|
||||||
|
|
||||||
[[git-concepts]]
|
[[git-concepts]]
|
||||||
|
|
Loading…
Reference in a new issue