emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: master ff4de1b: Fix quoting style in Lisp comments


From: Dmitry Gutov
Subject: Re: master ff4de1b: Fix quoting style in Lisp comments
Date: Thu, 16 Sep 2021 13:39:35 +0300
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.13.0

On 16.09.2021 08:08, Eli Zaretskii wrote:
From: Stefan Monnier <monnier@iro.umontreal.ca>
Cc: Eli Zaretskii <eliz@gnu.org>,  Stefan Kangas <stefan@marxist.se>,
   juri@linkov.net,  rudalics@gmx.at,  larsi@gnus.org,  emacs-devel@gnu.org
Date: Wed, 15 Sep 2021 16:15:59 -0400

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 ;-).

We already had this discussion, and there was a conclusion.  We
decided to use '..' as the quoting style in plain-text documents.
I've been using it everywhere since then.  The main arguments were:

   . the ` character looks ugly on many modern displays

The "` character look ugly" discussion resulted in changes of how these characters are rendered in the manual, the Help buffers, and so on.

And in this manual page:

https://www.gnu.org/software/emacs/manual/html_node/elisp/Documentation-Tips.html

Note how it still recommends either using curved quotes around symbols in source code (which you apparently dislike; and so do I), or keep to the old convention of `..'.

   . the Unicode quotes are not universally supported on text-mode terminals
   . therefore '..' has the least problems

This discussion was a kind-of tangent of the dispute triggered by the
changes in how we display `foo' quoted symbols in doc strings and
echo-area messages.

That tangent was about NEWS and ChangeLogs and other plain text files.

If we want '..' to be highlighted in some contexts, let's change
font-lock to support that.

You can't just go around breaking things and expect others to pick up the pieces.

And please remember that we are not talking only about comments, nor
only about ELisp files.  We are talking about all kinds of plain-text
documentation: comments, Git commit log messages, NEWS, PROBLEMS, text
files in admin/notes/, etc.

No, we are not.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]