[PATCH v5 3/4] BreakingChanges: document removal of grafting
- From
Patrick Steinhardt <ps@pks.im>
- Date
- Jun 3, 2024, 09:28 UTC
- Message-ID
- <4142e472ac54f5008b0566fdb967f86677171491.1717402497.git.ps@pks.im>
- In-Reply-To
- <cover.1717402497.git.ps@pks.im>
The grafting mechanism for objects has been deprecated in e650d0643b (docs: mark info/grafts as outdated, 2014-03-05), which is more than a decade ago. The mechanism can lead to hard-to-debug issues and has a superior replacement with replace refs.
Follow through with the deprecation and mark grafts for removal in Git 3.0.
Signed-off-by: Patrick Steinhardt <ps@pks.im> --- Documentation/BreakingChanges.txt | 8 ++++++++ 1 file changed, 8 insertions(+)
diff --git a/Documentation/BreakingChanges.txt b/Documentation/BreakingChanges.txt index 904857a636..b5088dcce2 100644 --- a/Documentation/BreakingChanges.txt +++ b/Documentation/BreakingChanges.txt @@ -87,6 +87,14 @@ Cf. <2f5de416-04ba-c23d-1e0b-83bb655829a7@zombino.com>, === Removals +* Support for grafting commits has long been superseded by git-replace(1). + Grafts are inferior to replacement refs as the mechanism can lead to + hard-to-diagnose problems when transferring objects between repositories. + They have been outdated since e650d0643b (docs: mark info/grafts as outdated, + 2014-03-05) and will be removed. ++ +Cf. <20140304174806.GA11561@sigill.intra.peff.net>. + == Superseded features that will not be deprecated Some features have gained newer replacements that aim to improve the design in
-- 2.45.1.410.g58bac47f8e.dirty