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:
parent
c5558f80c3
commit
db4e4113ea
@ -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
|
||||||
|
@ -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.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user