BreakingChanges: document removal of grafting
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> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Patrick Steinhardt committed
Jun 14, 2024 at 08:42 UTC
fcf0f4801d9f007a3bc4358f8e2589247be81ab0
1 file changed
+13
Documentation/BreakingChanges.txt
+13
@@ -102,6 +102,19 @@ Cf. <2f5de416-04ba-c23d-1e0b-83bb655829a7@zombino.com>,
102
103
=== Removals
104
105
+* Support for grafting commits has long been superseded by git-replace(1).
106
+ Grafts are inferior to replacement refs:
107
++
108
+ ** Grafts are a local-only mechanism and cannot be shared across
109
+ repositories.
110
+ ** Grafts can lead to hard-to-diagnose problems when transferring objects
111
+ between repositories.
112
++
113
+The grafting mechanism has been marked as outdated since e650d0643b (docs: mark
114
+info/grafts as outdated, 2014-03-05) and will be removed.
115
++
116
+Cf. <20140304174806.GA11561@sigill.intra.peff.net>.
117
+
118
== Superseded features that will not be deprecated
119
120
Some features have gained newer replacements that aim to improve the design in