From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: master ff4de1b: Fix quoting style in Lisp comments Date: Mon, 13 Sep 2021 14:34:32 +0300 Message-ID: <83v934emk7.fsf@gnu.org> References: <20210912165141.9491.52637@vcs0.savannah.gnu.org> <20210912165143.5BC1E20A5E@vcs0.savannah.gnu.org> <47d6e9a6-f334-eda9-2e08-0a946e51fc4a@yandex.ru> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="16968"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Sep 13 13:35:44 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mPkFT-0004DE-Mv for ged-emacs-devel@m.gmane-mx.org; Mon, 13 Sep 2021 13:35:43 +0200 Original-Received: from localhost ([::1]:49518 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mPkFS-0005BE-IZ for ged-emacs-devel@m.gmane-mx.org; Mon, 13 Sep 2021 07:35:42 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:36936) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mPkES-0004Ru-2x for emacs-devel@gnu.org; Mon, 13 Sep 2021 07:34:40 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:33306) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mPkEQ-0005ft-QO; Mon, 13 Sep 2021 07:34:39 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:2798 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mPkEQ-0006CK-Df; Mon, 13 Sep 2021 07:34:38 -0400 In-Reply-To: <47d6e9a6-f334-eda9-2e08-0a946e51fc4a@yandex.ru> (message from Dmitry Gutov on Mon, 13 Sep 2021 01:42:08 +0300) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:274632 Archived-At: > From: Dmitry Gutov > Date: Mon, 13 Sep 2021 01:42:08 +0300 > > Hi Eli, > > On 12.09.2021 19:51, Eli Zaretskii wrote: > > -;; `eval' is hence the core of the culprit. It's used on: > > +;; 'eval' is hence the core of the culprit. It's used on: > > > > -;; encouraged to use `lisp-data-mode' instead. > > +;; encouraged to use 'lisp-data-mode' instead. > > > > -;; The time- functions below translate nil to `current-time' and > > -;; accept an integer as of Emacs 25. `decode-time' and > > -;; `format-time-string' accept nil on Emacs 24 but don't accept an > > +;; The time- functions below translate nil to 'current-time' and > > +;; accept an integer as of Emacs 25. 'decode-time' and > > +;; 'format-time-string' accept nil on Emacs 24 but don't accept an > > Is this a good idea? We decided to use this style in plain-text documentation long ago. > I'm not sure we ever agreed to standardize on straight quotes in Lisp > comments (as opposed to plain text files like NEWS). Comments, NEWS, PROBLEMS, DEBUG, commit log messages (thus the generated ChangeLog files), and any other form of plain-text documentation. > More importantly, the symbol references inside `...' are font-locked > with font-lock-constant-face, and references inside '...' do not. If we want to highlight 'like this' (and I'm not sure we do, but I won't object if we did), then let's make such a change in font-lock, by all means.