From 1fdc98e3b0b8bfc84fc8c8ce4401f9ae392b90ee Mon Sep 17 00:00:00 2001 From: Tim Hockin Date: Fri, 10 Nov 2023 22:15:02 -0800 Subject: [PATCH] Document that short SHAs dont work --- v3-to-v4.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/v3-to-v4.md b/v3-to-v4.md index e4b9098f3..c10dee0e5 100644 --- a/v3-to-v4.md +++ b/v3-to-v4.md @@ -64,6 +64,17 @@ and try to set `--ref` from them. | other | other | "" | error | |----------|---------|---------|------------------------------| +#### Abbreviated hashes + +Because of the fetch loop, git-sync v3 allowed a user to specify `--branch` and +`--rev`, where the rev was a shortened hash (aka SHA), which would be locally +expanded to the full hash. v4 tries hard not to pull extra stuff, which means +we don't have enough information locally to do that resolution, and there no +way to ask the server to do it for us (at least, not as far as we know). + +The net result is that, when using a hash for `--ref`, it must be a full hash, +and not an abbreviated form. + ### Log-related flags git-sync v3 exposed a number of log-related flags (e.g. `-logtostderr`). These