From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Tue, 15 Jun 2021 16:36:29 +0000 (+0200)
Subject: Clarify (interactive "K") in the manual
X-Git-Tag: emacs-28.0.90~2110
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=6ae5a59e5275a54a91092ed5c50fe2b42748784a;p=emacs.git

Clarify (interactive "K") in the manual

* doc/lispref/commands.texi (Interactive Codes): Clarify
(interactive "K") (bug#37146).
---

diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 8199ece1101..f30419c3ee7 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -454,10 +454,13 @@ This kind of input is used by commands such as @code{describe-key} and
 @code{global-set-key}.
 
 @item K
-A key sequence, whose definition you intend to change.  This works like
-@samp{k}, except that it suppresses, for the last input event in the key
-sequence, the conversions that are normally used (when necessary) to
-convert an undefined key into a defined one.
+A key sequence on a form that can be used as input to functions like
+@code{define-key}.  This works like @samp{k}, except that it
+suppresses, for the last input event in the key sequence, the
+conversions that are normally used (when necessary) to convert an
+undefined key into a defined one (@pxref{Key Sequence Input}), so this
+form is usually used when prompting for a new key sequence that is to
+be bound to a command.
 
 @item m
 @cindex marker argument