]> git.ipfire.org Git - thirdparty/git.git/commit
BreakingChanges: clarify the procedure
authorJunio C Hamano <gitster@pobox.com>
Fri, 28 Feb 2025 17:28:21 +0000 (09:28 -0800)
committerJunio C Hamano <gitster@pobox.com>
Mon, 3 Mar 2025 18:07:03 +0000 (10:07 -0800)
commitc268e3285d4eafeec048d98672faa43f21857990
treeaebd289835c99d6f2790ea35b7159c5c035e2e5c
parent2454970930851179fb6486e6faa6342f008e7d9d
BreakingChanges: clarify the procedure

The point behind a compile-time switch is to ensure that we have a
mechanism to hide myriad of backward incompatible changes that may
be prepared and accumulated over time, yet make them available for
testing any time during the development toward the big version
boundary.  Add a few words to stress that point.

Since the document was first written, we have added the CI job that
the document anticipated us to have.  Rephrase to state the current
status.

The discussion in [*1*] made us abandon the "feature.git3" based
runtime switching of behaviour and instead adopt the compile-time
switching mechanism, but a stray sentence about runtime switching
still remained in the final text by mistake.  Remove it.

[Reference]

 *1* https://lore.kernel.org/git/xmqqldzel6ug.fsf@gitster.g/

Signed-off-by: Junio C Hamano <gitster@pobox.com>
Acked-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/BreakingChanges.txt