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

[Eli Zaretskii]

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