Re: [PATCH v6 3/4] BreakingChanges: document removal of grafting
Patrick Steinhardt <ps@pks.im> writes:
Show 25 quoted lines
> 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 | 12 ++++++++++++
> 1 file changed, 12 insertions(+)
>
> diff --git a/Documentation/BreakingChanges.txt b/Documentation/BreakingChanges.txt
> index 5d7e80aebb..9fb6d8c78a 100644
> --- a/Documentation/BreakingChanges.txt
> +++ b/Documentation/BreakingChanges.txt
> @@ -96,6 +96,18 @@ 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 reositories.
"reositories" -> "repositories".
Show 11 quoted lines
> + ** 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
Junio C Hamano <gitster@pobox.com>