From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: master ff4de1b: Fix quoting style in Lisp comments Date: Wed, 15 Sep 2021 16:15:59 -0400 Message-ID: References: <20210912165141.9491.52637@vcs0.savannah.gnu.org> <20210912165143.5BC1E20A5E@vcs0.savannah.gnu.org> <47d6e9a6-f334-eda9-2e08-0a946e51fc4a@yandex.ru> <83v934emk7.fsf@gnu.org> <87sfy8d7oo.fsf@gnus.org> <9194fc93-fb9c-000f-a35a-321ddd259893@gmx.at> <8735q5yi63.fsf@mail.linkov.net> <83czp9by3s.fsf@gnu.org> <05cbffe0-f89b-ff54-64f5-cd1d11bac4f5@yandex.ru> <831r5pbt7j.fsf@gnu.org> <83wnnhacy4.fsf@gnu.org> <40937e22-994f-466c-87be-4f70a522118a@yandex.ru> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25255"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: Eli Zaretskii , Stefan Kangas , juri@linkov.net, rudalics@gmx.at, larsi@gnus.org, emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Sep 15 22:17:27 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 1mQbLQ-0006Fw-1P for ged-emacs-devel@m.gmane-mx.org; Wed, 15 Sep 2021 22:17:24 +0200 Original-Received: from localhost ([::1]:54176 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mQbLO-00078B-9F for ged-emacs-devel@m.gmane-mx.org; Wed, 15 Sep 2021 16:17:22 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57788) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mQbKD-0005hD-LS for emacs-devel@gnu.org; Wed, 15 Sep 2021 16:16:10 -0400 Original-Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:45186) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mQbK8-0001np-Qk; Wed, 15 Sep 2021 16:16:08 -0400 Original-Received: from pmg1.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 7E834100182; Wed, 15 Sep 2021 16:16:09 -0400 (EDT) Original-Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id D29C4100139; Wed, 15 Sep 2021 16:16:07 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1631736967; bh=cSLEgz09sMUoL/e/qsWuctgN3Y747cFFrL67f31PYjk=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From; b=ZI4oeaaiTcHx2VmhjJjY1CBeSNXz3vzMC8GpnvaEngETH0Nex3wR0j8dLkKFVHnZk FyaqhQ8d8Zu6rplLgjOApKDxxCKxp5VcLo0akLhcoBUDdrzqGBPYtcprLtu0eTc+xr RgGaFTmlADLrPMQZiNFzszBOQpc1uJdMjHHrNEtcSWIfPF/KW61y9xEubziorzOA7g bwJWi7CkOwLdDzqAEfqTewDS7fxsf17QtaxWghiMk9gY7L+2Igf0gT1JOv8xcZLHz+ z9HeLuzrxguoQiLtfKbCcAo6Hsm8RYGusNdOSAAdVDXHC0WUobDScS4Y/OMpj5ku8g 3sen4ZtNxox4g== Original-Received: from pastel (unknown [45.72.241.23]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 5FCC0120376; Wed, 15 Sep 2021 16:16:00 -0400 (EDT) In-Reply-To: <40937e22-994f-466c-87be-4f70a522118a@yandex.ru> (Dmitry Gutov's message of "Wed, 15 Sep 2021 23:01:40 +0300") Received-SPF: pass client-ip=132.204.25.50; envelope-from=monnier@iro.umontreal.ca; helo=mailscanner.iro.umontreal.ca X-Spam_score_int: -42 X-Spam_score: -4.3 X-Spam_bar: ---- X-Spam_report: (-4.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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:274775 Archived-At: > Then, if you don't mind, I will revert your commit. I think we should first try to agree on a convention (specifically for quoting symbols in ELisp comments). Either: - We have no official preference (in which case the maintainer of a package/file can try and impose his preference for that file, but beyond this we should just refrain from changing other people's style). I guess that would mean you shouldn't revert his commit. Not sure what that would mean for font-lock and symbol completion. - We declare '...' as the official style and decide on how we deal with the many cases of other style used throughout the code, and someone=E2=84= =A2 will have to write the new code for font-lock and completion. - We declare `...' as the official style. This matches the historical use, so it requires no changes, AFAIK (other than reverting Eli's commit, obviously). - We declare something else as the official style. I personally have grown fond of (a subset of) Markdown, so I'd vote for `...` (and encourage extending this to a few more conventions, e.g. so we can distinguish code from prose in comments), but (a subset of) Org style would also make a lot of sense. This is a typical bikeshed kind of question, so there's not much point getting people to argue over it. The maintainers should make an executive decision on it (but they do need to come to an agreement among themselves ;-). Stefan