From mboxrd@z Thu Jan 1 00:00:00 1970 From: Kyle Meyer Subject: Re: Upstream synchronization documentation Date: Mon, 03 Jul 2017 11:06:22 -0400 Message-ID: <87d19h8sr5.fsf@kyleam.com> References: <87fuedyfij.fsf@gmx.us> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:53501) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dS2vm-0005QX-Cv for emacs-orgmode@gnu.org; Mon, 03 Jul 2017 11:06:31 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dS2vj-0003eB-2D for emacs-orgmode@gnu.org; Mon, 03 Jul 2017 11:06:30 -0400 Received: from pb-smtp2.pobox.com ([64.147.108.71]:54050 helo=sasl.smtp.pobox.com) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dS2vi-0003cb-SD for emacs-orgmode@gnu.org; Mon, 03 Jul 2017 11:06:26 -0400 In-Reply-To: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Neil Jerram , Rasmus , emacs-orgmode@gnu.org Neil Jerram writes: > I just noticed that your text talks about 'backporting', and wondered if > that is the clearest term to use. To me, a 'backport' usually means > porting a change or fix from the master or development branch to some > older or more stable branch. Right. Thanks for bringing this up. > Whereas in your text I think it is the other way round, isn't it? > (I.e. the Emacs branch is more stable, and you are talking about > porting a fix that someone has made in that branch to the Org master.) > So perhaps 'forward port' would be clearer? I suspect that Org's maint (where the Emacs changes land) is generally more stable than the Org in Emacs's master, but, yes, Emacs's version is the older version. (Well, with v9.0.9 just synced the versions match, but maint still has quite a few more commits.) Since before I took over "backporting" changes from the Emacs repo, it's been referred to as this. Although I agree it isn't great word choice, I'd prefer that we remain consistent so that, for example, "git log -i --grep=backport" remains informative. But if people think using "backport" is too confusing, I'm OK switching to another term. Of "forward port" and "propagate" (suggested in this thread by Eric), I prefer "propagate"---or maybe just "port", though grepping for that might lead to too many false positives. And if we stick with "backport", it still might be a good idea to clarify in README_maintainer that we're abusing the term. -- Kyle