From patchwork Fri Jun 14 06:42:44 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Patrick Steinhardt X-Patchwork-Id: 13697921 Received: from fhigh8-smtp.messagingengine.com (fhigh8-smtp.messagingengine.com [103.168.172.159]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 6A24E1474C4 for ; Fri, 14 Jun 2024 06:42:49 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.159 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1718347371; cv=none; b=O70JwaFSJrqOAKAdOWQgBFWz6ts5ZgFEIE9gYRxAVajNKZWOj87HAl8Pte6hWzfprzqGlQMyO8rwpVkrUdFkF+Cno5dBGjKIWcpmQBG4FtYqnlfkhVNBbG/rSpAfc2IF4mcr3dm4svPu0hHgk2enMRNyKGBuDIbYMembBFSz9YI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1718347371; c=relaxed/simple; bh=x9ROFbzDXc1cZlx2TNR80vtJOy2nxHb/Bhm+XDR+voo=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=Xq58aKumUMq4+5p3ZUZU6bWtsKBzZRD7gDACfzGqCVwU6A64QdNKhKXfGAJnayShARZFdhkydVqjn2cBWgII3bMSzMDz5eRx4b0lcMFI2FR9IyE8wdD/x1vw+v8HywVZdb4GNP4MGvAWKFNIjAf3Fdwso7siCs9azxZLZ7G2PzI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=pks.im; spf=pass smtp.mailfrom=pks.im; dkim=pass (2048-bit key) header.d=pks.im header.i=@pks.im header.b=M2I6VJK1; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=gr9oT5kI; arc=none smtp.client-ip=103.168.172.159 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=pks.im Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=pks.im Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=pks.im header.i=@pks.im header.b="M2I6VJK1"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="gr9oT5kI" Received: from compute7.internal (compute7.nyi.internal [10.202.2.48]) by mailfhigh.nyi.internal (Postfix) with ESMTP id 6EB821140107; Fri, 14 Jun 2024 02:42:48 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute7.internal (MEProxy); Fri, 14 Jun 2024 02:42:48 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=pks.im; h=cc:cc :content-type:content-type:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:subject :subject:to:to; s=fm1; t=1718347368; x=1718433768; bh=3dXeY6mywi idKtz+qRQW4Vbi8kalkIpabji1dfEyP6g=; b=M2I6VJK1ZT/xALWbgZzOpR88Xl o7TmVY1CLc09taaClMrodRqqG5s6iaqe1HB5tZle4/kdepoLA53OINJCTgdONmfD BLqABu0nzrIaCHf1o15XFzNa+DMHQqLoT4fY+XbGpXxAhzUXAZPKNgN78y/y8Jrz UpYM6aIE+PQHfrjufN8Qkq8UIV/lC0yesJmRX/Nc9X6dXuLHBIsIh3BmOyFiEqz8 ndv4gZs/kCAAoiWrllOfrRoc2pH6IAzSAjSF58DEPDMo6DFi6mkp/q8h8IQ61yK3 fsyIXVAQdwqGZHJHpLecQMllne9vm0nIk1TIc3g+x8wqzvgiz46QGxCM/DiQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:subject:subject:to :to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm1; t=1718347368; x=1718433768; bh=3dXeY6mywiidKtz+qRQW4Vbi8kal kIpabji1dfEyP6g=; b=gr9oT5kIVAs0UPpqrVTmWOjFJUlT0SCa7M4wioOV5lyz AKuBIqbGFXWdGvTpKGBU59f8yO7RveSE4zD4ecRR/euv8StrklkjtzNKE8cCLrDO RsEe2X9kRWCwmx3cwHN7POZav4KDd27MHJRYEOR0BwNS6OLJFd1Kjmu1zTWHokLQ E6xVdVf9TkyI1sm44BfPfKVyrSTQZe5Dy6rYPXq6MYdDbbS59wn6H0yRMp427njs 2SWcqSaPjg719MuGxbcaOw1xyRKTpd+PlIzuovTLU0UZC3mdvgJKeoLPCImwBiLs dHtM5pPYUxvfQgMQV2eAJb1tvN++ky4FiO+MV7VR7g== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrfedukedguddtvdcutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpeffhffvvefukfhfgggtuggjsehgtderredttddvnecuhfhrohhmpefrrght rhhitghkucfuthgvihhnhhgrrhguthcuoehpshesphhkshdrihhmqeenucggtffrrghtth gvrhhnpeeukedtvedtffevleejtefgheehieegkeeluddvfeefgeehgfeltddtheejleff teenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehpsh esphhkshdrihhm X-ME-Proxy: Feedback-ID: i197146af:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Fri, 14 Jun 2024 02:42:46 -0400 (EDT) Received: by localhost (OpenSMTPD) with ESMTPSA id f632ce35 (TLSv1.3:TLS_AES_256_GCM_SHA384:256:NO); Fri, 14 Jun 2024 06:42:31 +0000 (UTC) Date: Fri, 14 Jun 2024 08:42:44 +0200 From: Patrick Steinhardt To: git@vger.kernel.org Cc: Johannes Schindelin , Phillip Wood , Justin Tobler , Junio C Hamano , Dragan Simic , Karthik Nayak , Todd Zullinger Subject: [PATCH v7 3/4] BreakingChanges: document removal of grafting Message-ID: References: Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: 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 --- Documentation/BreakingChanges.txt | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/Documentation/BreakingChanges.txt b/Documentation/BreakingChanges.txt index 68ad42d805..62695ec2e1 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