development/git
development/git
1
0
Fork 0
mirror of https://github.com/git/git synced 2024-08-27 19:49:21 +00:00
Code Issues Packages Projects Releases Wiki Activity

user-manual: mention 'git remote add' for remote branch config

Browse source 
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:
W. Trevor King 2013-02-17 19:15:56 -05:00 committed by Junio C Hamano
parent d1471e0616
commit 47adb8ac7c
1 changed files with 14 additions and 28 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

42
Documentation/user-manual.txt
View file

@ -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]]