From f708cb22a1608f8a5aea671afebea44d216d9496 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 4 Nov 2016 11:50:48 +0200 Subject: [PATCH] Clarify doc string of 'transpose-sexps' * lisp/simple.el (transpose-sexps): Clarify the conditions for transposing sexps that are lists or strings. Mention the effect of the prefix argument. (Bug#24860) --- lisp/simple.el | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/lisp/simple.el b/lisp/simple.el index 8f5324f20ec..ff5774e103e 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -6663,9 +6663,13 @@ are interchanged." (transpose-subr 'forward-word arg)) (defun transpose-sexps (arg) - "Like \\[transpose-words] but applies to sexps. -Does not work on a sexp that point is in the middle of -if it is a list or string." + "Like \\[transpose-chars] (`transpose-chars'), but applies to sexps. +Unlike `transpose-words', point must be between the two sexps and not +in the middle of a sexp to be transposed. +With non-zero prefix arg ARG, effect is to take the sexp before point +and drag it forward past ARG other sexps (backward if ARG is negative). +If ARG is zero, the sexps ending at or after point and at or after mark +are interchanged." (interactive "*p") (transpose-subr (lambda (arg) -- 2.39.5