emacs-27 5f36e21: Clarify the doc string of 'yank'

[Eli Zaretskii]

branch: emacs-27
commit 5f36e21fe519fe98784d230dd65ca2af78444d14
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    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)
---
 lisp/simple.el | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/lisp/simple.el b/lisp/simple.el
index da9e04d..ea16d14 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