From daedd978b1aec06ab090ba119334f584d6d7e579 Mon Sep 17 00:00:00 2001 From: Martin von Zweigbergk Date: Wed, 15 Oct 2025 12:48:54 -0700 Subject: [PATCH] BreakingChanges: say that `git diff X..Y` syntax will be removed in 3.0 The `git diff X..Y` syntax is quite misleading because it looks like it shows the diff of the commits in the X..Y range but it actually shows the diff from X to Y. IMO, if that syntax is supported, it should show a diff from the merge base of X and Y to Y. I hope Git 3.0 is a good time to remove support for the current syntax and semantics. Then we can perhaps add the syntax back later with less surprising semantics. Signed-off-by: Martin von Zweigbergk --- Documentation/BreakingChanges.adoc | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Documentation/BreakingChanges.adoc b/Documentation/BreakingChanges.adoc index 90b53abcea28f9..93fb968840e5d5 100644 --- a/Documentation/BreakingChanges.adoc +++ b/Documentation/BreakingChanges.adoc @@ -114,6 +114,10 @@ applications and forges. + There is no plan to deprecate the "sha1" object format at this point in time. + +Support for "git diff X..Y" syntax will be removed. Use "git diff X Y" instead. +This will open up the syntax for a more consistent interpretation of +"git diff $(git merge-base X Y) Y". ++ Cf. <2f5de416-04ba-c23d-1e0b-83bb655829a7@zombino.com>, <20170223155046.e7nxivfwqqoprsqj@LykOS.localdomain>, .