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>
This commit is contained in:
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,10 +12,20 @@ ifndef::git-pull[]
endif::git-pull[] endif::git-pull[]
<refspec>:: <refspec>::
The format of a <refspec> parameter is an optional plus Specifies which refs to fetch and which local refs to update.
`+`, followed by the source ref <src>, followed When no <refspec>s appear on the command line, the refs to fetch
by a colon `:`, followed by the destination ref <dst>. are read from `remote.<repository>.fetch` variables instead
The colon can be omitted when <dst> is empty. 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
`+`, followed by the source ref <src>, followed
by a colon `:`, followed by the destination ref <dst>.
The colon can be omitted when <dst> is empty.
+ +
`tag <tag>` means the same as `refs/tags/<tag>:refs/tags/<tag>`; `tag <tag>` means the same as `refs/tags/<tag>:refs/tags/<tag>`;
it requests fetching everything up to the given tag. it requests fetching everything up to the given tag.