|
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 +0300We 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.
[Prev in Thread] | Current Thread | [Next in Thread] |