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: Mon, 13 Sep 2021 15:56:52 +0300
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.13.0

On 13.09.2021 15:26, Eli Zaretskii wrote:
Cc: emacs-devel@gnu.org
From: Dmitry Gutov <dgutov@yandex.ru>
Date: Mon, 13 Sep 2021 14:51:32 +0300

We decided to use this style in plain-text documentation long ago.

IME code comments are not the same as plain-text documentation.

Then what does?

I don't understand the question.

The only place where we must leave `..' alone is in
doc strings, everything else is fair play.

I think I have explained how changing comments this way breaks useful functionality.

Aside from highlighting, we have other code that relies on unambiguous
markup. Emacs Lisp completion code also enters "symbol completion" mode
(so to speak) after you type '`', allowing one to more easily input an
existing symbol.

I didn't say anything about completion text.

Comments, NEWS, PROBLEMS, DEBUG, commit log messages (thus the
generated ChangeLog files), and any other form of plain-text
documentation.

Having docstring markup in plain comments is fairly common across
languages, I think.

Again, I don't see how this is relevant to the issue at hand.

References in docstrings ~ references in comments. With the same syntax.

`...' is our docstring syntax for references.



reply via email to

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