emacs-28 56026242e4: Explain how to bind keys to non-ASCII sequences

[Robert Pluim]

branch: emacs-28
commit 56026242e462e8834337f118baaa9c49e2411f7d
Author: Robert Pluim <rpluim@gmail.com>
Commit: Robert Pluim <rpluim@gmail.com>

    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 2bc1d3820d..65970ce412 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