[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: master ff4de1b: Fix quoting style in Lisp comments
From: |
Stefan Monnier |
Subject: |
Re: master ff4de1b: Fix quoting style in Lisp comments |
Date: |
Wed, 15 Sep 2021 16:15:59 -0400 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) |
> Then, if you don't mind, I will revert your commit.
I think we should first try to agree on a convention (specifically for
quoting symbols in ELisp comments). Either:
- We have no official preference (in which case the maintainer of
a package/file can try and impose his preference for that file, but
beyond this we should just refrain from changing other people's
style). I guess that would mean you shouldn't revert his commit.
Not sure what that would mean for font-lock and symbol completion.
- We declare '...' as the official style and decide on how we deal with
the many cases of other style used throughout the code, and someoneā¢
will have to write the new code for font-lock and completion.
- We declare `...' as the official style. This matches the historical
use, so it requires no changes, AFAIK (other than reverting Eli's
commit, obviously).
- We declare something else as the official style. I personally have
grown fond of (a subset of) Markdown, so I'd vote for `...` (and
encourage extending this to a few more conventions, e.g. so we can
distinguish code from prose in comments), but (a subset of) Org style
would also make a lot of sense.
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 ;-).
Stefan
- Re: master ff4de1b: Fix quoting style in Lisp comments, (continued)
- Re: master ff4de1b: Fix quoting style in Lisp comments, martin rudalics, 2021/09/15
- Re: master ff4de1b: Fix quoting style in Lisp comments, Juri Linkov, 2021/09/15
- Re: master ff4de1b: Fix quoting style in Lisp comments, Eli Zaretskii, 2021/09/15
- Re: master ff4de1b: Fix quoting style in Lisp comments, Dmitry Gutov, 2021/09/15
- Re: master ff4de1b: Fix quoting style in Lisp comments, Eli Zaretskii, 2021/09/15
- Re: master ff4de1b: Fix quoting style in Lisp comments, Dmitry Gutov, 2021/09/15
- RE: [External] : Re: master ff4de1b: Fix quoting style in Lisp comments, Drew Adams, 2021/09/15
- Re: master ff4de1b: Fix quoting style in Lisp comments, Stefan Kangas, 2021/09/15
- Re: master ff4de1b: Fix quoting style in Lisp comments, Eli Zaretskii, 2021/09/15
- Re: master ff4de1b: Fix quoting style in Lisp comments, Dmitry Gutov, 2021/09/15
- Re: master ff4de1b: Fix quoting style in Lisp comments,
Stefan Monnier <=
- RE: [External] : Re: master ff4de1b: Fix quoting style in Lisp comments, Drew Adams, 2021/09/15
- Re: master ff4de1b: Fix quoting style in Lisp comments, Eli Zaretskii, 2021/09/16
- Re: master ff4de1b: Fix quoting style in Lisp comments, Dmitry Gutov, 2021/09/16
- Re: master ff4de1b: Fix quoting style in Lisp comments, Lars Ingebrigtsen, 2021/09/16
- Re: master ff4de1b: Fix quoting style in Lisp comments, Eli Zaretskii, 2021/09/16
- Re: master ff4de1b: Fix quoting style in Lisp comments, Dmitry Gutov, 2021/09/16
- Re: master ff4de1b: Fix quoting style in Lisp comments, Phil Sainty, 2021/09/16
- Re: master ff4de1b: Fix quoting style in Lisp comments, Dmitry Gutov, 2021/09/17
- RE: [External] : Re: master ff4de1b: Fix quoting style in Lisp comments, Drew Adams, 2021/09/16
- Re: master ff4de1b: Fix quoting style in Lisp comments, Lars Ingebrigtsen, 2021/09/17