From: Dmitry Gutov <dgutov@yandex.ru>
To: Eli Zaretskii <eliz@gnu.org>
Cc: emacs-devel@gnu.org
Subject: Re: master ff4de1b: Fix quoting style in Lisp comments
Date: Mon, 13 Sep 2021 15:56:52 +0300 [thread overview]
Message-ID: <0490d7f6-82e9-fb47-671d-9ee34ac48964@yandex.ru> (raw)
In-Reply-To: <83ee9sek61.fsf@gnu.org>
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.
prev parent reply other threads:[~2021-09-13 12:56 UTC|newest]
Thread overview: 159+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <20210912165141.9491.52637@vcs0.savannah.gnu.org>
[not found] ` <20210912165143.5BC1E20A5E@vcs0.savannah.gnu.org>
2021-09-12 22:42 ` master ff4de1b: Fix quoting style in Lisp comments Dmitry Gutov
2021-09-13 8:06 ` Lars Ingebrigtsen
2021-09-13 12:01 ` Eli Zaretskii
2021-09-14 2:14 ` Phil Sainty
2021-09-13 11:34 ` Eli Zaretskii
2021-09-13 11:41 ` Lars Ingebrigtsen
2021-09-13 12:23 ` Eli Zaretskii
2021-09-13 12:36 ` martin rudalics
2021-09-13 16:53 ` Stefan Monnier
2021-09-13 18:25 ` Stefan Monnier
2021-09-15 9:27 ` martin rudalics
2021-09-15 12:42 ` Stefan Monnier
2021-09-15 18:46 ` martin rudalics
2021-09-15 16:02 ` Juri Linkov
2021-09-15 16:30 ` Eli Zaretskii
2021-09-15 18:07 ` Dmitry Gutov
2021-09-15 18:16 ` Eli Zaretskii
2021-09-15 18:20 ` Dmitry Gutov
2021-09-15 21:12 ` [External] : " Drew Adams
2021-09-15 18:40 ` Stefan Kangas
2021-09-15 18:52 ` Eli Zaretskii
2021-09-15 20:01 ` Dmitry Gutov
2021-09-15 20:15 ` Stefan Monnier
2021-09-15 21:24 ` [External] : " Drew Adams
2021-09-16 5:08 ` Eli Zaretskii
2021-09-16 10:39 ` Dmitry Gutov
2021-09-16 12:32 ` Lars Ingebrigtsen
2021-09-16 12:53 ` Eli Zaretskii
2021-09-16 13:37 ` Dmitry Gutov
2021-09-16 23:20 ` Phil Sainty
2021-09-18 0:15 ` Dmitry Gutov
2021-09-16 16:19 ` [External] : " Drew Adams
2021-09-17 14:12 ` Lars Ingebrigtsen
2021-09-17 15:58 ` Eli Zaretskii
2021-09-17 19:21 ` Stefan Kangas
2021-09-18 5:42 ` Eli Zaretskii
2021-09-18 8:17 ` Stefan Kangas
2021-09-18 8:26 ` Eli Zaretskii
2021-09-18 13:30 ` Lars Ingebrigtsen
2021-09-18 13:34 ` Eli Zaretskii
2021-09-18 16:03 ` [External] : " Drew Adams
2021-09-18 16:13 ` Eli Zaretskii
2021-09-18 16:52 ` Drew Adams
2021-09-18 16:54 ` Lars Ingebrigtsen
2021-09-18 17:07 ` Drew Adams
2021-09-16 13:31 ` Eli Zaretskii
2021-09-16 16:20 ` [External] : " Drew Adams
2021-09-16 14:15 ` Eli Zaretskii
2021-09-16 14:18 ` Dmitry Gutov
2021-09-16 15:22 ` Eli Zaretskii
2021-09-16 16:20 ` [External] : " Drew Adams
2021-09-17 9:17 ` Gregory Heytings
2021-09-17 10:26 ` Stefan Kangas
2021-09-17 10:39 ` Eli Zaretskii
2021-09-17 22:46 ` Stefan Kangas
2021-09-18 6:19 ` Eli Zaretskii
2021-09-18 7:32 ` Andreas Schwab
2021-09-18 8:20 ` Eli Zaretskii
2021-09-18 8:37 ` Adam Sjøgren
2021-09-18 8:44 ` Gregory Heytings
2021-09-18 8:48 ` Yuri Khan
2021-09-18 11:50 ` Phil Sainty
2021-09-18 11:54 ` Yuri Khan
2021-09-18 16:03 ` [External] : " Drew Adams
2021-09-18 16:02 ` Drew Adams
2021-09-18 16:02 ` Drew Adams
2021-09-18 16:01 ` Drew Adams
2021-09-18 16:01 ` Drew Adams
2021-09-18 8:17 ` Stefan Kangas
2021-09-18 8:25 ` Eli Zaretskii
2021-09-18 9:18 ` Stefan Kangas
2021-09-18 11:00 ` Eli Zaretskii
2021-09-18 16:02 ` [External] : " Drew Adams
2021-09-18 9:28 ` Yuri Khan
2021-09-18 10:05 ` Stefan Kangas
2021-09-18 10:27 ` Yuri Khan
2021-09-18 10:51 ` Stefan Kangas
2021-09-18 18:40 ` Juri Linkov
2021-09-18 18:56 ` Eli Zaretskii
2021-09-18 19:34 ` Stefan Kangas
2021-09-18 23:22 ` [External] : " Drew Adams
2021-09-19 5:44 ` Eli Zaretskii
2021-09-19 10:00 ` Stefan Kangas
2021-09-19 17:30 ` Drew Adams
2021-09-19 17:42 ` Eli Zaretskii
2021-09-19 17:54 ` Drew Adams
2021-09-21 14:38 ` Jean Louis
2021-09-21 17:04 ` tomas
2021-09-21 17:09 ` tomas
2021-09-24 20:42 ` Richard Stallman
2021-09-19 5:30 ` Eli Zaretskii
2021-09-17 10:55 ` Gregory Heytings
2021-09-17 11:16 ` Eli Zaretskii
2021-09-17 11:30 ` Gregory Heytings
2021-09-17 12:11 ` Eli Zaretskii
2021-09-17 12:30 ` Gregory Heytings
2021-09-17 16:21 ` Yuri Khan
2021-09-17 16:40 ` João Távora
2021-09-17 16:44 ` Alan Mackenzie
2021-09-17 17:47 ` Eli Zaretskii
2021-09-17 18:42 ` Yuri Khan
2021-09-17 18:51 ` Eli Zaretskii
2021-09-17 19:14 ` Gregory Heytings
2021-09-17 19:22 ` Stefan Monnier
2021-09-17 20:32 ` Manuel Giraud
2021-09-17 22:16 ` [External] : " Drew Adams
2021-09-18 13:45 ` Stefan Monnier
2021-09-18 16:03 ` [External] : " Drew Adams
2021-09-18 17:25 ` Stefan Monnier
2021-09-18 17:46 ` Stefan Kangas
2021-09-18 23:11 ` Stefan Monnier
2021-09-18 23:22 ` Drew Adams
2021-09-19 12:26 ` Stefan Monnier
2021-09-18 5:43 ` Eli Zaretskii
2021-09-18 8:33 ` Stefan Kangas
2021-09-18 8:53 ` Gregory Heytings
2021-09-17 18:09 ` [External] : " Drew Adams
2021-09-17 18:09 ` Drew Adams
2021-09-16 16:18 ` Drew Adams
2021-09-16 10:50 ` Dmitry Gutov
2021-09-16 11:39 ` Eli Zaretskii
2021-09-16 14:12 ` Dmitry Gutov
2021-09-16 16:20 ` [External] : " Drew Adams
2021-09-16 16:18 ` Drew Adams
2021-09-16 11:25 ` Stefan Kangas
2021-09-17 0:16 ` Richard Stallman
2021-09-17 0:27 ` Alexandre Garreau
2021-09-17 6:34 ` Eli Zaretskii
2021-09-17 10:44 ` Dmitry Gutov
2021-09-17 11:11 ` Eli Zaretskii
2021-09-17 11:25 ` Dmitry Gutov
2021-09-17 12:09 ` Eli Zaretskii
2021-09-17 12:38 ` Phil Sainty
2021-09-17 12:59 ` Tassilo Horn
2021-09-17 15:45 ` Eli Zaretskii
2021-09-17 13:07 ` Dmitry Gutov
2021-09-17 13:44 ` João Távora
2021-09-17 15:49 ` Eli Zaretskii
2021-09-17 16:33 ` Dmitry Gutov
2021-09-17 18:10 ` [External] : " Drew Adams
2021-09-17 13:18 ` Amin Bandali
2021-09-17 18:09 ` [External] : " Drew Adams
2021-09-16 4:53 ` Eli Zaretskii
2021-09-16 8:51 ` Dmitry Gutov
2021-09-16 9:11 ` Eli Zaretskii
2021-09-16 10:34 ` Dmitry Gutov
2021-09-16 11:35 ` Eli Zaretskii
2021-09-16 13:38 ` Dmitry Gutov
2021-09-15 18:48 ` martin rudalics
2021-09-15 19:05 ` Eli Zaretskii
2021-09-16 6:56 ` martin rudalics
2021-09-16 7:11 ` Eli Zaretskii
2021-09-16 16:18 ` [External] : " Drew Adams
2021-09-13 11:51 ` Dmitry Gutov
2021-09-13 12:05 ` Lars Ingebrigtsen
2021-09-13 12:28 ` Eli Zaretskii
2021-09-13 12:29 ` Lars Ingebrigtsen
2021-09-13 12:26 ` Eli Zaretskii
2021-09-13 12:56 ` Dmitry Gutov [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=0490d7f6-82e9-fb47-671d-9ee34ac48964@yandex.ru \
--to=dgutov@yandex.ru \
--cc=eliz@gnu.org \
--cc=emacs-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.