From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: Emacs 26.1 release branch created Date: Sun, 24 Sep 2017 19:41:39 +0000 Message-ID: <20170924194139.GA6793@ACM> References: <20170921205447.GA8240@ACM> <83tvzvcidg.fsf@gnu.org> <20170922184159.GB7229@ACM> <20170922193511.GC7229@ACM> <20170922220700.GD7229@ACM> <20170924143939.GC5725@ACM> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: blaine.gmane.org 1506282563 355 195.159.176.226 (24 Sep 2017 19:49:23 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 24 Sep 2017 19:49:23 +0000 (UTC) User-Agent: Mutt/1.7.2 (2016-11-26) Cc: Eli Zaretskii , rms@gnu.org, emacs-devel@gnu.org To: Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Sep 24 21:49:18 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwCtv-00080p-NW for ged-emacs-devel@m.gmane.org; Sun, 24 Sep 2017 21:49:15 +0200 Original-Received: from localhost ([::1]:39217 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dwCu3-0005US-4I for ged-emacs-devel@m.gmane.org; Sun, 24 Sep 2017 15:49:23 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52002) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dwCto-0005U6-LS for emacs-devel@gnu.org; Sun, 24 Sep 2017 15:49:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dwCtl-0000YP-Im for emacs-devel@gnu.org; Sun, 24 Sep 2017 15:49:08 -0400 Original-Received: from ocolin.muc.de ([193.149.48.4]:53885 helo=mail.muc.de) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1dwCtl-0000Xj-CD for emacs-devel@gnu.org; Sun, 24 Sep 2017 15:49:05 -0400 Original-Received: (qmail 60617 invoked by uid 3782); 24 Sep 2017 19:49:02 -0000 Original-Received: from acm.muc.de (p548C6746.dip0.t-ipconnect.de [84.140.103.70]) by colin.muc.de (tmda-ofmipd) with ESMTP; Sun, 24 Sep 2017 21:49:00 +0200 Original-Received: (qmail 9498 invoked by uid 1000); 24 Sep 2017 19:41:39 -0000 Content-Disposition: inline In-Reply-To: X-Delivery-Agent: TMDA/1.1.12 (Macallan) X-Primary-Address: acm@muc.de X-detected-operating-system: by eggs.gnu.org: FreeBSD 9.x [fuzzy] X-Received-From: 193.149.48.4 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:218757 Archived-At: Hello, Paul. On Sun, Sep 24, 2017 at 11:26:55 -0700, Paul Eggert wrote: > Alan Mackenzie wrote: > > Is there anything standing in the way of me merging this branch into > > emacs-26 now? > Although the code part of that branch looks good, the documentation patch still > has significant unaddressed problems, first mentioned here: > http://lists.gnu.org/archive/html/emacs-devel/2017-09/msg00775.html > with followup discussion ongoing as of today. Your latest proposal > continues to recommend an awkward text-quoting-style programming > technique .... Ruhbish! It suggests the natural and economical way, the way used countless times for many, many purposes throughout Emacs. > used nowhere in Emacs, .... There are historical reasons for that, which I doubt you want to go into at the moment. Those reasons no longer hold. > .... while refusing to mention the technique that is actually used. It's used once, in cc-engine.el (and that might well change). It's a bizarre and poor technique, unnecessarily putting a single conversion through `format'-like operations twice. I think that a typical hacker, with awareness of both techniques, is going to chose binding text-quoting-style rather than the double format alternative. > (Also, it's too wordy.) This needs to be fixed, and I trust that the > ongoing discussion will help do that. When you introduce something like curly quotes to Emacs, there is bound to be a lot of documentation needed about it. I don't think your way of dealing with this, namely fragmenting the documentation of three functions, is the right way. But I suggest that neither of us is in a position to give a definitive unbiassed judgment of the point. Let's wait for more level-headed people to express their viewpoint. -- Alan Mackenzie (Nuremberg, Germany).