docs: Explain the purpose of fetch's and pull's <refspec> parameter.

Signed-off-by: Marc Branchaud <marcnarc@xiplink.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Marc Branchaud 2014-06-11 10:24:04 -04:00 committed by Junio C Hamano
parent c5558f80c3
commit db4e4113ea
2 changed files with 16 additions and 6 deletions

View File

@ -51,8 +51,8 @@ include::pull-fetch-param.txt[]
include::urls-remotes.txt[] include::urls-remotes.txt[]




CONFIGURED REMOTE-TRACKING BRANCHES CONFIGURED REMOTE-TRACKING BRANCHES[[CRTB]]
----------------------------------- -------------------------------------------


You often interact with the same remote repository by You often interact with the same remote repository by
regularly and repeatedly fetching from it. In order to keep track regularly and repeatedly fetching from it. In order to keep track

View File

@ -12,6 +12,16 @@ ifndef::git-pull[]
endif::git-pull[] endif::git-pull[]


<refspec>:: <refspec>::
Specifies which refs to fetch and which local refs to update.
When no <refspec>s appear on the command line, the refs to fetch
are read from `remote.<repository>.fetch` variables instead
ifndef::git-pull[]
(see <<CRTB,CONFIGURED REMOTE-TRACKING BRANCHES>> below).
endif::git-pull[]
ifdef::git-pull[]
(see linkgit:git-fetch[1]).
endif::git-pull[]
+
The format of a <refspec> parameter is an optional plus The format of a <refspec> parameter is an optional plus
`+`, followed by the source ref <src>, followed `+`, followed by the source ref <src>, followed
by a colon `:`, followed by the destination ref <dst>. by a colon `:`, followed by the destination ref <dst>.