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
|
||||
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
|
||||
$ git fetch example master:refs/remotes/example/master
|
||||
[remote "example"]
|
||||
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
|
||||
-------------------------------------------------
|
||||
|
||||
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 git://example.com/proj.git +refs/heads/*:refs/remotes/example/*
|
||||
$ git fetch example +refs/heads/*:refs/remotes/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
|
||||
options mentioned above.
|
||||
options mentioned above and linkgit:git-fetch[1] for more details on
|
||||
the refspec syntax.
|
||||
|
||||
|
||||
[[git-concepts]]
|
||||
|
|
Loading…
Reference in a new issue