Skip to contentSkip to conversation

fetch doc: src side of refspec could be full SHA-1

PATCH In review Junio C Hamano 2 participants 3 messages Oct 17, 2017 Documentation

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 fetch doc: src side of refspec could be full SHA-1

Since a9d34933 ("Merge branch 'fm/fetch-raw-sha1'", 2015-06-01) we allow to fetch by an object name when the other side accepts such a request, but we never updated the documentation to match.

---
 Documentation/pull-fetch-param.txt | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
Documentation/pull-fetch-param.txt +4 -2
index 1ebbf1d738..733f932479 100644
@@ -23,9 +23,11 @@ ifdef::git-pull[]
 endif::git-pull[]
 +
 The format of a <refspec> parameter is an optional plus
-`+`, followed by the source ref <src>, followed
+`+`, followed by the source <src>, followed
 by a colon `:`, followed by the destination ref <dst>.
-The colon can be omitted when <dst> is empty.
+The colon can be omitted when <dst> is empty.  <src> is most
+typically a ref, but it can also be an fully spelled hex object
+name.
 +
 `tag <tag>` means the same as `refs/tags/<tag>:refs/tags/<tag>`;
 it requests fetching everything up to the given tag.
Signature · 1 line
2.15.0-rc1-168-g2b9456ab46
Reviewed-by on v1 1/1
#1 lore raw

Hi Junio,

Quoted 8 lines · Junio C Hamano

Since a9d34933 ("Merge branch 'fm/fetch-raw-sha1'", 2015-06-01) we allow to fetch by an object name when the other side accepts such a request, but we never updated the documentation to match.

---
 Documentation/pull-fetch-param.txt | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

Good catch.

Documentation/pull-fetch-param.txt ifdef::git-pull[] · line 30

Quoted 13 lines
Documentation/pull-fetch-param.txt +4 -2
@@ -23,9 +23,11 @@ ifdef::git-pull[]
 endif::git-pull[]
 +
 The format of a <refspec> parameter is an optional plus
-`+`, followed by the source ref <src>, followed
+`+`, followed by the source <src>, followed
 by a colon `:`, followed by the destination ref <dst>.
-The colon can be omitted when <dst> is empty.
+The colon can be omitted when <dst> is empty.  <src> is most
+typically a ref, but it can also be an fully spelled hex object
+name.

nits:

s/most typically/typically/
s/an fully/a fully/

With those tweaks,

Thanks.