[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps'

From: Eli Zaretskii
Subject: Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps'
Date: Fri, 04 Nov 2016 20:14:19 +0200

> Date: Fri, 4 Nov 2016 07:31:41 -0700 (PDT)
> From: Drew Adams <address@hidden>
> Cc: Eli Zaretskii <address@hidden>
> > > +Unlike `transpose-words', point must be between the two sexps and not 
> >   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > > +in the middle of a sexp to be transposed.
> >   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > 
> > The underlined sentence is not accurate, since transpose-sexps does
> > work like transpose-words if point is in the middle of a symbol or
> > number.  Here's a more accurate statement: "If point is in the middle
> > of a list or string, you cannot transpose that sexp with another sexp."
> See bug #24860 (https://debbugs.gnu.org/cgi/bugreport.cgi?bug=24860).
> That bug points out that the doc statement is incorrect/incomplete.

The above commit was the fix for that bug.

> The problem is that "in the middle of a sexp" can mean different
> things.  Which sexp?

As the doc string now says: that which is to be transposed.

IOW, when the user invokes this command, she wants it to transpose two
specific sexps.  These are the sexps the doc string alludes to.

reply via email to

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