From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sat, 27 Jul 2019 11:15:03 +0000 (+0200)
Subject: Clarify yank-pop doc string
X-Git-Tag: emacs-27.0.90~1817^2~79
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a975c8783160255139ed7f17997e0926afc908ff;p=emacs.git

Clarify yank-pop doc string

* lisp/simple.el (yank-pop): Mention `kill-ring' to make it more
clear what the command is doing (bug#25196).
---

diff --git a/lisp/simple.el b/lisp/simple.el
index e33709e8ad4..742d6cb6ff3 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -4972,10 +4972,11 @@ Normally set from the UNDO element of a yank-handler; see `insert-for-yank'.")
 
 (defun yank-pop (&optional arg)
   "Replace just-yanked stretch of killed text with a different stretch.
-This command is allowed only immediately after a `yank' or a `yank-pop'.
-At such a time, the region contains a stretch of reinserted
-previously-killed text.  `yank-pop' deletes that text and inserts in its
-place a different stretch of killed text.
+This command is allowed only immediately after a `yank' or a
+`yank-pop'.  At such a time, the region contains a stretch of
+reinserted previously-killed text.  `yank-pop' deletes that text
+and inserts in its place a different stretch of killed text by
+traversing the value of the `kill-ring' variable.
 
 With no argument, the previous kill is inserted.
 With argument N, insert the Nth previous kill.