bug#55788: [PATCH] Improve documentation of the raise-sexp command

[Eli Zaretskii]

> Cc: 55788@debbugs.gnu.org, Daniel Martín <mardani29@yahoo.es>
> From: Juri Linkov <juri@linkov.net>
> Date: Mon, 06 Jun 2022 10:33:25 +0300
> 
> >   "Raise ARG sexps higher up the tree.
> > This means that the ARGth enclosing form will be deleted and
> > replaced with the form that follows point.
> >
> > For instance, if you have:
> >
> >   (let ((foo 2))
> >     (progn
> >       (setq foo 3)
> >       (zot)
> >       (+ foo 2)))
> >
> > and point is before (zot), `M-x raise-sexp' will give you
> >
> >   (let ((foo 2))
> >     (zot))"
> 
> It seems that new docstring suggests that `M-2 M-x raise-sexp' will give
> 
>   (zot)
> 
> whereas really it will give
> 
>   (let ((foo 2))
>     (zot)
>     (+ foo 2))
> 
> since ARG is the number of sexps that follow point and that will be raised.

Right.  Is the below better?

    Raise ARG sexps one level higher up the tree.

  This function removes the sexp enclosing the form which follows
  point, and then re-inserts ARG sexps following point, thus raising
  them one level up.