From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Achim Gratz Newsgroups: gmane.emacs.devel Subject: Re: Should we use `symbol' or 'symbol' in Emacs change logs? Date: Thu, 29 May 2014 21:20:15 +0200 Organization: Linux Private Site Message-ID: <87fvjsgzo0.fsf@Rainer.invalid> References: <871tvczf1l.fsf@bzg.ath.cx> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1401391254 29762 80.91.229.3 (29 May 2014 19:20:54 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 29 May 2014 19:20:54 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu May 29 21:20:48 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 1Wq5sd-00044A-II for ged-emacs-devel@m.gmane.org; Thu, 29 May 2014 21:20:47 +0200 Original-Received: from localhost ([::1]:49872 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Wq5sd-0000XZ-3e for ged-emacs-devel@m.gmane.org; Thu, 29 May 2014 15:20:47 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48352) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Wq5sR-0000XN-TC for emacs-devel@gnu.org; Thu, 29 May 2014 15:20:41 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Wq5sK-00081E-3M for emacs-devel@gnu.org; Thu, 29 May 2014 15:20:35 -0400 Original-Received: from plane.gmane.org ([80.91.229.3]:36354) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Wq5sJ-00080b-SP for emacs-devel@gnu.org; Thu, 29 May 2014 15:20:28 -0400 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1Wq5sI-0003h0-Rx for emacs-devel@gnu.org; Thu, 29 May 2014 21:20:26 +0200 Original-Received: from pd9eb1eb1.dip0.t-ipconnect.de ([217.235.30.177]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 29 May 2014 21:20:26 +0200 Original-Received: from Stromeko by pd9eb1eb1.dip0.t-ipconnect.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 29 May 2014 21:20:26 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 27 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: pd9eb1eb1.dip0.t-ipconnect.de User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.91 (gnu/linux) Cancel-Lock: sha1:3SZUrKOur4kSldS9ULnY/wVv/fY= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 80.91.229.3 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:172182 Archived-At: Stefan Monnier writes: >> Am I reading it wrong or am I correct that there is no change >> in Emacs policy regarding the quotation of symbols in change logs >> (and in docstrings)? > > Indeed there's been no change in that policy. To the extent that we > follow the GNU coding standard for the ChangeLogs, you could argue that > we should use 'foo' in ChangeLogs, but the `...' convention is so > pervasive inside Emacs that we'd then either have a mix of conventions > (one for the ChangeLog and another for most everything else) or a major > painful conversion ahead. Then you might want to document it somewhere and/or do something about: https://www.gnu.org/prep/standards/html_node/Style-of-Change-Logs.html which suggests otherwise in the examples (including not using quotes when there is no ambiguity). Regards, Achim. -- +<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+ SD adaptation for Waldorf rackAttack V1.04R1: http://Synth.Stromeko.net/Downloads.html#WaldorfSDada