Skip to content

Commit 1fdc98e

Browse files
committed
Document that short SHAs dont work
1 parent a5cec7a commit 1fdc98e

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

v3-to-v4.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,17 @@ and try to set `--ref` from them.
6464
| other | other | "" | error |
6565
|----------|---------|---------|------------------------------|
6666

67+
#### Abbreviated hashes
68+
69+
Because of the fetch loop, git-sync v3 allowed a user to specify `--branch` and
70+
`--rev`, where the rev was a shortened hash (aka SHA), which would be locally
71+
expanded to the full hash. v4 tries hard not to pull extra stuff, which means
72+
we don't have enough information locally to do that resolution, and there no
73+
way to ask the server to do it for us (at least, not as far as we know).
74+
75+
The net result is that, when using a hash for `--ref`, it must be a full hash,
76+
and not an abbreviated form.
77+
6778
### Log-related flags
6879

6980
git-sync v3 exposed a number of log-related flags (e.g. `-logtostderr`). These

0 commit comments

Comments
 (0)