[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Regarding outline headings in emacs-lisp libraries
From: |
Jonas Bernoulli |
Subject: |
Re: Regarding outline headings in emacs-lisp libraries |
Date: |
Tue, 28 Jul 2020 21:18:03 +0200 |
Let me summarize the conversation so far:
1. I make some arguments as to why it is better for the sections that
contain code to be top-level sections instead of sub-sections of a
single top-level section.
One can of course disagree with those arguments but that has not
really happened. Stefan stated that he ever so slightly prefers
the nested approach but also that he is fine with either style.
2. Eli approves the change as long as we adjust the documentation and
rename the "Code:" section to something else because if it does not
contain all the code anymore, then keeping the old name would be a
misnomer.
> But after the proposed changes, almost none of the code will be
> under "Code:", so the name will be a misnomer, no?
3. Stefan does not want to rename "Code:" to something else because it
is the one bit that in nearly all elisp files.
> I definitely don't want to rename "Code:" to something else. It
> would be a rather gratuitous change, since "Code:" is basically the
> only section that appears in virtually all Elisp files and renaming
> it would provide very little concrete benefits.
Stefan also thinks that what Eli calls a "lie" is just a "very minor
cosmetic problem".
Is that what they call a Mexican Standoff?
I think the conversation should be about whether my arguments as to
*why* we should change the recommended style are sound, but we discuss
whether "Code:" should be renamed or not. (I tend to agree with Stefan
that it {should not / does not have to be} renamed.) Nothing wrong with
discussing that detail, but I fear that disagreement about it is what
will ultimately derail my proposal; not disagreement about the merit of
my arguments as to why it is preferable to skip one nesting level.
Jonas
- Re: Regarding outline headings in emacs-lisp libraries, (continued)
- Re: Regarding outline headings in emacs-lisp libraries, Stefan Monnier, 2020/07/26
- Re: Regarding outline headings in emacs-lisp libraries, Jonas Bernoulli, 2020/07/28
- Re: Regarding outline headings in emacs-lisp libraries, Eli Zaretskii, 2020/07/28
- Re: Regarding outline headings in emacs-lisp libraries, Jonas Bernoulli, 2020/07/28
- Re: Regarding outline headings in emacs-lisp libraries, Eli Zaretskii, 2020/07/28
- Re: Regarding outline headings in emacs-lisp libraries, Stefan Monnier, 2020/07/28
- Re: Regarding outline headings in emacs-lisp libraries, Jonas Bernoulli, 2020/07/26
- Re: Regarding outline headings in emacs-lisp libraries, Jonas Bernoulli, 2020/07/26
- Re: [SPAM UNSURE] Re: Regarding outline headings in emacs-lisp libraries, Stephen Leake, 2020/07/26
Re: Regarding outline headings in emacs-lisp libraries, Eli Zaretskii, 2020/07/18
Re: Regarding outline headings in emacs-lisp libraries,
Jonas Bernoulli <=
Re: Regarding outline headings in emacs-lisp libraries, Richard Stallman, 2020/07/31