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

[Lars Ingebrigtsen]

Daniel Martín <mardani29@yahoo.es> writes:

> I propose to change it to something more descriptive, like:
>
>   Replace the enclosing parenthesis structure with ARG sexps from point.

I don't think that really explains a lot more than the current doc
string.

But there's no need to be terse here, and in a case like this, an
example explains more than any text could, so I've changed the doc
string to this in Emacs 29 now:

  "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))"


-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no