Jeff King <p...@peff.net> writes:
> On Wed, May 20, 2020 at 12:17:11PM -0700, Junio C Hamano wrote:
>
>> Git 2.27 Release Notes (draft)
>> ==============================
>>
>> Updates since v2.26
>> -------------------
>>
>> Backward compatibility notes
>
> Is it worth mentioning here the reversion of v2 as the default protocol?
>
> It does end up (along with the actual code fix) in the "fixes from
> v2.26" section:
>
>> * Those fetching over protocol v2 from linux-next and other kernel
>> repositories are reporting that v2 often fetches way too much than
>> needed.
>> (merge 11c7f2a30b jn/demote-proto2-from-default later to maint).
>>
>> * The upload-pack protocol v2 gave up too early before finding a
>> common ancestor, resulting in a wasteful fetch from a fork of a
>> project. This has been corrected to match the behaviour of v0
>> protocol.
>> (merge 2f0a093dd6 jt/v2-fetch-nego-fix later to maint).
>
> but that's somewhat buried. I dunno. It is not likely to introduce _new_
> compatibility issues, but perhaps folks looking into compatibility stuff
> may want to know about the revert.
The promotion in Git 2.26 was buried in the "performance &
implementation details" section and not in the backward
compatibility section, so it feels a bit funny to highlight the
reversion. In any case, here is what I prepared (but not committed
yet)
-- >8 --
Subject: [PATCH] RelNotes: advertise the demotion of protocol v2
In the upcoming release, the transport protocol v2 is no longer the
default; note it in the backward compatibility section.
Suggested-by: Jeff King <p...@peff.net>
Signed-off-by: Junio C Hamano <gits...@pobox.com>
---
Documentation/RelNotes/2.27.0.txt | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/Documentation/RelNotes/2.27.0.txt
b/Documentation/RelNotes/2.27.0.txt
index 5fb8c0cf67..95a8d338ad 100644
--- a/Documentation/RelNotes/2.27.0.txt
+++ b/Documentation/RelNotes/2.27.0.txt
@@ -24,6 +24,10 @@ Backward compatibility notes
users may find annoying---those who prefer not to rebase need to
set the variable to false to squelch the warning.
+ * The transport protocol version 2, which was promoted to the default
+ in Git 2.26 release, turned out to have some remaining rough edges,
+ so it has been demoted from the default.
+
UI, Workflows & Features
