From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Eric S. Raymond" Newsgroups: gmane.emacs.devel Subject: Re: trunk r115926: In preparation for the move to git, sanitize out some Bazaar-specific names. Date: Wed, 8 Jan 2014 20:25:54 -0500 Organization: Eric Conspiracy Secret Labs Message-ID: <20140109012554.GA23333@thyrsus.com> References: <56y52qcbbh.fsf@fencepost.gnu.org> <20140108233424.GA15258@thyrsus.com> <20140109000406.GA22775@thyrsus.com> <87mwj6f23d.fsf@bzg.ath.cx> <20140109002754.GA22950@thyrsus.com> Reply-To: esr@thyrsus.com NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1389230767 18320 80.91.229.3 (9 Jan 2014 01:26:07 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 9 Jan 2014 01:26:07 +0000 (UTC) Cc: Bastien , Emacs developers To: Juanma Barranquero Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 09 02:26:14 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1W14Nw-0005kr-3B for ged-emacs-devel@m.gmane.org; Thu, 09 Jan 2014 02:26:12 +0100 Original-Received: from localhost ([::1]:49725 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W14Nv-0000gP-Eo for ged-emacs-devel@m.gmane.org; Wed, 08 Jan 2014 20:26:11 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56365) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W14No-0000gF-91 for emacs-devel@gnu.org; Wed, 08 Jan 2014 20:26:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1W14Nj-0001e0-SJ for emacs-devel@gnu.org; Wed, 08 Jan 2014 20:26:04 -0500 Original-Received: from static-71-162-243-5.phlapa.fios.verizon.net ([71.162.243.5]:33914 helo=snark.thyrsus.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W14Nf-0001dO-1w; Wed, 08 Jan 2014 20:25:55 -0500 Original-Received: by snark.thyrsus.com (Postfix, from userid 1000) id 83E7A3805F2; Wed, 8 Jan 2014 20:25:54 -0500 (EST) Content-Disposition: inline In-Reply-To: X-Eric-Conspiracy: There is no conspiracy User-Agent: Mutt/1.5.21 (2010-09-15) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 71.162.243.5 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:167841 Archived-At: Juanma Barranquero : > On Thu, Jan 9, 2014 at 1:27 AM, Eric S. Raymond wrote: > > > The argument WHEN is not described in the function docstring. Is it supposed > > to be the last version in which the old name was valid, or the first version > > in which the new name was? > > Second option. It says in which version the new name is introduced and > the old name turns into an obsolete alias. Thanks. I'll include the obsolete-alias setup with some docstring fixes that version.el meeded anyway. The theme of all my recent commits is fixing places in the tree where code or documentation knew the VCS in use is Bazaar but didn't actually need to know that. In most cases simply referring to 'the repository' is sufficient, and in fact improves the documentation. The goal, of course, is to get to where plugging in git is a very small and well-isolated change. But these cleanups would be good in themselves for their information-hiding effects even if no change were planned. The renaming of that variable is the most intrusive change I'll have to make to get this part of the job done. Most of the others are documentation. -- Eric S. Raymond