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: Sat, 18 Sep 2021 08:42:51 +0300 Message-ID: <83lf3u782s.fsf@gnu.org> References: <20210912165141.9491.52637@vcs0.savannah.gnu.org> <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> <83o88t9kgb.fsf@gnu.org> <9672aeae-a969-1526-003b-abb1b00b5b49@yandex.ru> <87sfy43dlt.fsf@gnus.org> <834kakadga.fsf@gnu.org> <87k0jfxpe2.fsf@gnus.org> <83v92z6vou.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="40141"; mail-complaints-to="usenet@ciao.gmane.io" Cc: juri@linkov.net, rudalics@gmx.at, monnier@iro.umontreal.ca, dgutov@yandex.ru, larsi@gnus.org, emacs-devel@gnu.org To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Sep 18 07:44:50 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 1mRT9d-000AHo-IO for ged-emacs-devel@m.gmane-mx.org; Sat, 18 Sep 2021 07:44:49 +0200 Original-Received: from localhost ([::1]:59352 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mRT9c-0000Mv-Ga for ged-emacs-devel@m.gmane-mx.org; Sat, 18 Sep 2021 01:44:48 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44518) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mRT80-0006XZ-Ix for emacs-devel@gnu.org; Sat, 18 Sep 2021 01:43:09 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:41112) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mRT7x-0005xA-Tp; Sat, 18 Sep 2021 01:43:05 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:2801 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 1mRT7w-0001cO-CD; Sat, 18 Sep 2021 01:43:05 -0400 In-Reply-To: (message from Stefan Kangas on Fri, 17 Sep 2021 12:21:10 -0700) 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:274954 Archived-At: > From: Stefan Kangas > Date: Fri, 17 Sep 2021 12:21:10 -0700 > Cc: emacs-devel@gnu.org, rudalics@gmx.at, monnier@iro.umontreal.ca, > dgutov@yandex.ru, juri@linkov.net > > > We also move text between doc strings and the manual, or vice versa, > > but no one will (I hope) suggest to use `..' instead of the Texinfo > > markup and have arguments in uper-case, or vice versa. > > That's unavoidable though. No, it isn't. People who are proficient in Texinfo have no problem reading Texinfo markup, so we could decide to leave it intact. We won't, of course, because the minor annoyance of adapting the text to its environment is nothing compared to the other aspects. > > Moving text sometimes requires to make small adjustments, and that's > > not a catastrophe. > > Having to change quotes between docstrings and comments is not a > catastrophe, but an annoyance and a fully avoidable one at that. It's a minor annoyance that is well worth sustaining. As we already decided.