From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.devel Subject: Re: master ff4de1b: Fix quoting style in Lisp comments Date: Thu, 16 Sep 2021 13:50:32 +0300 Message-ID: <117e3ea6-5348-1320-138f-5bf7fc8fd85a@yandex.ru> 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; format=flowed Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26178"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.13.0 Cc: Stefan Kangas , emacs-devel@gnu.org, rudalics@gmx.at, Eli Zaretskii , juri@linkov.net, larsi@gnus.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Sep 16 12:52:23 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 1mQp0A-0006ec-TA for ged-emacs-devel@m.gmane-mx.org; Thu, 16 Sep 2021 12:52:22 +0200 Original-Received: from localhost ([::1]:37580 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mQp09-00040n-3q for ged-emacs-devel@m.gmane-mx.org; Thu, 16 Sep 2021 06:52:21 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51528) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mQoyW-0002SB-ML for emacs-devel@gnu.org; Thu, 16 Sep 2021 06:50:40 -0400 Original-Received: from mail-wr1-x435.google.com ([2a00:1450:4864:20::435]:40714) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mQoyU-0006V8-Lv; Thu, 16 Sep 2021 06:50:40 -0400 Original-Received: by mail-wr1-x435.google.com with SMTP id q26so8720768wrc.7; Thu, 16 Sep 2021 03:50:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=sender:subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=36Xxf4jw7VUcHk/KPONBd6VqcotwKUVTV3mlTOdJDRM=; b=aX2TlwWHFuryixfG4l1DMqnrlg34VamqKrmB+D5XQoKNh7mC8UuD/HM5wXPNuMl31L 6LKXZwlhD0lSa8PBWqMwWp12tD35NtfiFzs14FjMjjhoif8YTJZOarT0NewIjC3giSPH 9ezmMhVpeTcl/Ubz2eWUHiJSh/7NiBK1B/eLN+OTMoOuZVJ55Y/Uua+7JMBC28mDCw0z ymFwm0eo18aGIWc8Rt7i4+IIi7DX+Rcd+wWqPOcP3SXhb1TIIxLUAoJbsYsERCNHut6N Gso9IcOuzBMjPU7X5CYOzb/WWu9A6eAZ5+qVJGMal2il7WhoFsZlb4b/886AEbQytaD4 phiw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:sender:subject:to:cc:references:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=36Xxf4jw7VUcHk/KPONBd6VqcotwKUVTV3mlTOdJDRM=; b=r3QVrvBDCm1SQinmn1OSOKfp+plV+AMWFP4XA9f95vyp+UdbgnVSEI/VNMWX4+HmHZ Arx58UNCN6DKYzI9MEC4bWqXcDY8/gTOWTjy5/rQLKJ5jwo8+tzFHj0/TulIe82hFg2E U/uqcutE0BRn2O96seQmbFnD29PdrWCOuxiSgi1H2yZrPFTK9s43M2iC9F1Amd0sjhDZ NlPD2A/Ln3V3Q9jekxzu7gX42JA6gyDbgGraPb0D0+Lfwk0scW+mvi6W55/W4gipTyRh aVY6mVBzKoJNGnr3++OGoa4yiPXdtHrEqYvMfYuPU8kNHYvCKqlE3LMmtWuazkCan+8T qnbQ== X-Gm-Message-State: AOAM533XNQG/LGwert8DvgRgdtIlwJ7FdrR+RkT8kv6SpbZmO7zpu7FI 3XBTS42LUYCIAyHuRIMhj9rbj5HrTh0= X-Google-Smtp-Source: ABdhPJxgRVNTIy+NzX19/+cuWzRtYJJUbNiPfifWS/5w1IqXKbhVXM8USRX0G//mT+JP65hGXE+gLA== X-Received: by 2002:adf:e40b:: with SMTP id g11mr5307836wrm.313.1631789436543; Thu, 16 Sep 2021 03:50:36 -0700 (PDT) Original-Received: from [192.168.0.6] ([46.251.119.176]) by smtp.googlemail.com with ESMTPSA id q128sm8683744wma.27.2021.09.16.03.50.34 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 16 Sep 2021 03:50:36 -0700 (PDT) In-Reply-To: Content-Language: en-US Received-SPF: pass client-ip=2a00:1450:4864:20::435; envelope-from=raaahh@gmail.com; helo=mail-wr1-x435.google.com X-Spam_score_int: -29 X-Spam_score: -3.0 X-Spam_bar: --- X-Spam_report: (-3.0 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, NICE_REPLY_A=-1.488, RCVD_IN_DNSWL_NONE=-0.0001, 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:274802 Archived-At: On 15.09.2021 23:15, Stefan Monnier wrote: >> 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. No, that would mean I should because he went and changed code I am responsible for from the style I prefer into a broken one. > - 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™ > will have to write the new code for font-lock and completion. That's my main point: doing this change now all of a sudden without the associated changes in infrastructure is bad form. > - 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. `...` is fine with me, or anything else that looks like markup ('...' will result in more annoying false positives). But it will result in a lot more work across the board. > 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 ;-). And they need to consider the technical tradeoffs of every choice, and take responsibility for the necessary changes in supporting code.