* bug#37146: 26.2; (elisp) Interactive Codes, for `K'
@ 2019-08-22 15:45 Drew Adams
2019-08-22 23:37 ` Richard Stallman
2021-06-15 16:35 ` Lars Ingebrigtsen
0 siblings, 2 replies; 6+ messages in thread
From: Drew Adams @ 2019-08-22 15:45 UTC (permalink / raw)
To: 37146
This is what it says:
'K'
A key sequence, whose definition you intend to change. This works
like '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.
That's inadequate. In this node you have no idea what "the conversions
that are normally used (when necessary) to convert an undefined key into
a defined one" are, or even what that phrase means.
Either such conversions need to be described here or, if they are
described in some other node then please add a cross-reference to that
node. Otherwise, there is no way for us to understand what `K' is/does.
I couldn't even find a description of such conversion by starting with
the parent node and searching for "conve". But I don't claim to have
studied the full context of each search hit.
In GNU Emacs 26.2 (build 1, x86_64-w64-mingw32)
of 2019-04-13
Repository revision: fd1b34bfba8f3f6298df47c8e10b61530426f749
Windowing system distributor `Microsoft Corp.', version 10.0.17763
Configured using:
`configure --without-dbus --host=x86_64-w64-mingw32
--without-compress-install 'CFLAGS=-O2 -static -g3''
^ permalink raw reply [flat|nested] 6+ messages in thread* bug#37146: 26.2; (elisp) Interactive Codes, for `K'
2019-08-22 15:45 bug#37146: 26.2; (elisp) Interactive Codes, for `K' Drew Adams
@ 2019-08-22 23:37 ` Richard Stallman
2019-08-23 1:30 ` Drew Adams
2021-06-15 16:35 ` Lars Ingebrigtsen
1 sibling, 1 reply; 6+ messages in thread
From: Richard Stallman @ 2019-08-22 23:37 UTC (permalink / raw)
To: Drew Adams; +Cc: 37146
[[[ To any NSA and FBI agents reading my email: please consider ]]]
[[[ whether defending the US Constitution against all enemies, ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]
> A key sequence, whose definition you intend to change. This works
> like '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.
> That's inadequate. In this node you have no idea what "the conversions
> that are normally used (when necessary) to convert an undefined key into
> a defined one" are, or even what that phrase means.
To explain that here would be too much duolication. A reference
to the Lisp manual would perhaps be worth it.
--
Dr Richard Stallman
President, Free Software Foundation (https://gnu.org, https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#37146: 26.2; (elisp) Interactive Codes, for `K'
2019-08-22 23:37 ` Richard Stallman
@ 2019-08-23 1:30 ` Drew Adams
0 siblings, 0 replies; 6+ messages in thread
From: Drew Adams @ 2019-08-23 1:30 UTC (permalink / raw)
To: rms; +Cc: 37146
> > That's inadequate. In this node you have no idea what "the
> > conversions that are normally used (when necessary) to
> > convert an undefined key into a defined one" are, or even
> > what that phrase means.
>
> To explain that here would be too much duolication.
> A reference to the Lisp manual would perhaps be worth it.
Yes, that's would be great. But this _is_ the Lisp
manual. And I'm not sure the doc to link to exists.
I hope it does, or it will be added.
I guess perhaps the conversions mentioned are those
described in (elisp) `Key Sequence Input' for function
`read-key-sequence'. But I'm not sure that's what's
meant.
It's also not clear to me what is meant by "whose
definition you intend to change". How so? That seems
to be a description of the ` use case (or main use
case?) of `K' (as opposed to `k'), but it's not clear
to me what that's about.
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#37146: 26.2; (elisp) Interactive Codes, for `K'
2019-08-22 15:45 bug#37146: 26.2; (elisp) Interactive Codes, for `K' Drew Adams
2019-08-22 23:37 ` Richard Stallman
@ 2021-06-15 16:35 ` Lars Ingebrigtsen
2021-06-15 16:56 ` Eli Zaretskii
1 sibling, 1 reply; 6+ messages in thread
From: Lars Ingebrigtsen @ 2021-06-15 16:35 UTC (permalink / raw)
To: Drew Adams; +Cc: 37146
Drew Adams <drew.adams@oracle.com> writes:
> This is what it says:
>
> 'K'
> A key sequence, whose definition you intend to change. This works
> like '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.
>
> That's inadequate. In this node you have no idea what "the conversions
> that are normally used (when necessary) to convert an undefined key into
> a defined one" are, or even what that phrase means.
Yes, it's pretty obscure. I've now changed this to the following in
Emacs 28:
@item K
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.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2021-06-16 8:15 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-08-22 15:45 bug#37146: 26.2; (elisp) Interactive Codes, for `K' Drew Adams
2019-08-22 23:37 ` Richard Stallman
2019-08-23 1:30 ` Drew Adams
2021-06-15 16:35 ` Lars Ingebrigtsen
2021-06-15 16:56 ` Eli Zaretskii
2021-06-16 8:15 ` Lars Ingebrigtsen
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).