From 56026242e462e8834337f118baaa9c49e2411f7d Mon Sep 17 00:00:00 2001 From: Robert Pluim Date: Mon, 14 Nov 2022 17:12:49 +0100 Subject: [PATCH] Explain how to bind keys to non-ASCII sequences * doc/emacs/custom.texi (Init Rebinding): Explain how to use `kbd' when binding keys to non-ASCII sequences. --- doc/emacs/custom.texi | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 2bc1d3820d1..65970ce412c 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -1868,6 +1868,22 @@ characters. For example, here's how to bind @kbd{C-x M-l} to @example (global-set-key "\C-x\M-l" 'make-symbolic-link) +@end example + + Similarly, a key sequence can be bound to a Lisp string or a vector +instead of a command. A vector is only required if the intended +result contains non-@acronym{ASCII} characters, and @code{kbd} can +again be used to create that vector. For example, to bind @kbd{C-c h} +to the string @samp{hello}: + +@example +(global-set-key (kbd "C-c h") "hello") +@end example + + But to bind it to the string @samp{olá} instead: + +@example +(global-set-key (kbd "C-c h") (kbd "olá")) @end example To bind a key sequence including @key{TAB}, @key{RET}, @key{ESC}, or -- 2.39.2