From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Gregory Heytings Newsgroups: gmane.emacs.devel Subject: Re: master ff4de1b: Fix quoting style in Lisp comments Date: Sat, 18 Sep 2021 08:53:57 +0000 Message-ID: References: <20210912165141.9491.52637@vcs0.savannah.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> <1a0f9230b7d75e426474@heytings.org> <1a0f9230b71c3d2eff86@heytings.org> <835yuz8na8.fsf@gnu.org> <1a0f9230b7571d4c3293@heytings.org> <831r5n8kqa.fsf@gnu.org> <1a0f9230b74fe15d1abf@heytings.org> <1a0f9230b76ce1574e10@heytings.org> <83k0je7814.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="rbphQvgidq" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="14787"; mail-complaints-to="usenet@ciao.gmane.io" Cc: yuri.v.khan@gmail.com, emacs-devel@gnu.org, rudalics@gmx.at, Stefan Monnier , dgutov@yandex.ru, Eli Zaretskii , juri@linkov.net, larsi@gnus.org To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Sep 18 10:54:35 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 1mRW7G-0003h5-U8 for ged-emacs-devel@m.gmane-mx.org; Sat, 18 Sep 2021 10:54:35 +0200 Original-Received: from localhost ([::1]:54988 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mRW7F-0006cO-Ma for ged-emacs-devel@m.gmane-mx.org; Sat, 18 Sep 2021 04:54:33 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:36330) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mRW6k-0005wZ-1r for emacs-devel@gnu.org; Sat, 18 Sep 2021 04:54:02 -0400 Original-Received: from heytings.org ([95.142.160.155]:40572) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mRW6h-0005OI-PK; Sat, 18 Sep 2021 04:54:01 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=heytings.org; s=20210101; t=1631955237; bh=kxfYCq3xjFq1UaEeCg482LRpRGN/tND5lNzBb8UD0G4=; h=Date:From:To:cc:Subject:In-Reply-To:Message-ID:References:From; b=iWsOllf2AfE5g4zP0eB9cIGnQjVH6tyRsElqTX/bSSambKc820Z0Efcpvg//tiFKr 5IuTYbn8sNiU48NVTWL23bjOzFyIc6NchVeOGmaVPC/ddeeaK56jUwixvdgbTpgPqQ 4OqGvoGtHGxkX4HZQw8gtUWWeY+5e50XzpkfhY8GBDdTYIscZCnNgeGwRriJFk6kwH NI/QO5pixSXmnYsZ7VRrCd8iKDvq0cCLhFfMYOlYhrda+AUv/oWwB7kpJM/JOgQdux RKLo7CdxhRw/AooQrYDSpvlTjm09v1hgWGarysFPafLxi9Zar5k+cgwserqqd5vsL0 1gz3BG7sQPQyQ== In-Reply-To: Content-ID: Received-SPF: pass client-ip=95.142.160.155; envelope-from=gregory@heytings.org; helo=heytings.org X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_PASS=-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:274974 Archived-At: --rbphQvgidq Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Content-ID: >>> My preference for using a well-defined convention based on some=20 >>> existing markup language is that the text is then plain ASCII (and=20 >>> hence easy to type and to display) but we can additionally prettify it= =20 >>> in a reliable way if the user cares about it. >> >> The GNU preferences are described in standards.texi, and we should=20 >> follow them, not our personal preferences. > > Does standards.texi offer advice on how to format Emacs Lisp comments,=20 > or does it otherwise contradict anything that Stefan M wrote? > AFAICS, it doesn't. Here is the 5.10 Quote Characters section of the GCS: In the C locale, the output of GNU programs should stick to plain ASCII=20 for quotation characters in messages to users: preferably 0x22 (=E2=80=98"= =E2=80=99) or=20 0x27 (=E2=80=98'=E2=80=99) for both opening and closing quotes. Although GN= U programs=20 traditionally used 0x60 (=E2=80=98`=E2=80=99) for opening and 0x27 (=E2=80= =98'=E2=80=99) for closing=20 quotes, nowadays quotes =E2=80=98`like this'=E2=80=99 are typically rendere= d=20 asymmetrically, so quoting =E2=80=98"like this"=E2=80=99 or =E2=80=98'like = this'=E2=80=99 typically looks=20 better. It is ok, but not required, for GNU programs to generate locale-specific=20 quotes in non-C locales. For example: printf (gettext ("Processing file '%s'..."), file); Here, a French translation might cause gettext to return the string=20 "Traitement de fichier =E2=80=B9 %s =E2=80=BA...", yielding quotes more app= ropriate for a=20 French locale. Sometimes a program may need to use opening and closing quotes directly.=20 By convention, gettext translates the string =E2=80=98"`"=E2=80=99 to the o= pening quote=20 and the string =E2=80=98"'"=E2=80=99 to the closing quote, and a program ca= n use these=20 translations. Generally, though, it is better to translate quote=20 characters in the context of longer strings. --rbphQvgidq--