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.
This commit is contained in:
Robert Pluim 2022-11-14 17:12:49 +01:00
parent 7d592db0ab
commit 56026242e4

View file

@ -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