From: Eli Zaretskii <eliz@gnu.org>
Date: Tue, 14 Apr 2020 05:38:00 +0000 (+0300)
Subject: Clarify the doc string of 'yank'
X-Git-Tag: emacs-27.0.91~15
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=5f36e21fe519fe98784d230dd65ca2af78444d14;p=emacs.git

Clarify the doc string of 'yank'

* lisp/simple.el (yank): Mention 'current-kill' in the doc string,
so that people could find all the gory details of what is "the most
recent kill" for this purpose.  (Bug#40375)
---

diff --git a/lisp/simple.el b/lisp/simple.el
index da9e04d16af..ea16d1400cc 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -5109,10 +5109,11 @@ property, in the way that `yank' does."
 
 (defun yank (&optional arg)
   "Reinsert (\"paste\") the last stretch of killed text.
-More precisely, reinsert the most recent kill, which is the
-stretch of killed text most recently killed OR yanked.  Put point
-at the end, and set mark at the beginning without activating it.
-With just \\[universal-argument] as argument, put point at beginning, and mark at end.
+More precisely, reinsert the most recent kill, which is the stretch of
+text most recently killed OR yanked, as returned by `current-kill' (which
+see).  Put point at the end, and set mark at the beginning without
+activating it. With just \\[universal-argument] as argument, put point
+at beginning, and mark at end.
 With argument N, reinsert the Nth most recent kill.
 
 This command honors the `yank-handled-properties' and