[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps'
From: |
Stephen Berman |
Subject: |
Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps' |
Date: |
Fri, 04 Nov 2016 18:08:37 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) |
On Fri, 4 Nov 2016 09:44:30 -0700 (PDT) Drew Adams <address@hidden> wrote:
>> > What does it mean to be in the middle of a list, for example?
>> > A case mentioned in the bug report is this:
>> >
>> >>> When point is in the middle of a list it can also be between two
>> >>> sexps, which themselves could be lists: ((foo)|(bar)), with
>> >>> point at |.
>> >
>> > Point here is in the middle of the outer list, but it is between
>> > the two inner lists. Any text description needs to be more careful
>> > and explicit, if it really wants to make the point clear.
>>
>> I think a reasonable interpretation of "in the middle of a sexp" is
>> that the relevant sexp
>
> What "relevant sexp"? To say that point is in the middle of a
> sexp does not imply that it is in the middle of only one sexp.
> There might be any number of such in-the-middle-of, "relevant"
> sexps.
>> is the one whose start and end are closer to point (counting
>> leftwards and rightwards from point, respectively) than those
>> of any other sexp.
>
> If that's what is meant then that's what the doc should say:
> "the innermost sexp containing point".
I think that's unnecessary if this is a "reasonable interpretation",
i.e. it's common sense, so making it explicit tends to be pedantic. Do
you really think this is not the common sense way of understanding it?
If so, I guess you have a function in mind that behaves differently;
which one?
Steve Berman
- Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Stephen Berman, 2016/11/04
- RE: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Drew Adams, 2016/11/04
- Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Stephen Berman, 2016/11/04
- RE: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Drew Adams, 2016/11/04
- Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps',
Stephen Berman <=
- RE: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Drew Adams, 2016/11/04
- Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Stephen Berman, 2016/11/04
- RE: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Drew Adams, 2016/11/04
- Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Eli Zaretskii, 2016/11/04
- RE: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Drew Adams, 2016/11/04
- Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Eli Zaretskii, 2016/11/04
- Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Eli Zaretskii, 2016/11/04
Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps', Eli Zaretskii, 2016/11/04