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: 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




reply via email to

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