diff options
| author | Patrick Steinhardt <ps@pks.im> | 2024-06-14 08:42:44 +0200 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2024-06-14 09:08:52 -0700 |
| commit | fcf0f4801d9f007a3bc4358f8e2589247be81ab0 (patch) | |
| tree | 820a5938a3a9aaf9244524619717528bf4dda8a7 | |
| parent | 6ccf041d1d73d69d05118f739c80f83c86caf0d6 (diff) | |
| download | git-fcf0f4801d9f007a3bc4358f8e2589247be81ab0.tar.xz | |
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>
| -rw-r--r-- | Documentation/BreakingChanges.txt | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/Documentation/BreakingChanges.txt b/Documentation/BreakingChanges.txt index cb03405519..1c94b8e6d7 100644 --- a/Documentation/BreakingChanges.txt +++ b/Documentation/BreakingChanges.txt @@ -102,6 +102,19 @@ 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: ++ + ** Grafts are a local-only mechanism and cannot be shared across + repositories. + ** Grafts can lead to hard-to-diagnose problems when transferring objects + between repositories. ++ +The grafting mechanism has been marked as 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 |