From 7602ed6b8271cb034383bd371a1a5f753130aaa4 Mon Sep 17 00:00:00 2001 From: Lars Ingebrigtsen Date: Sun, 1 Nov 2020 12:48:34 +0100 Subject: Mention the C-c LETTER keybinding convention * doc/emacs/custom.texi (Keymaps): Reintroduce the text about C-c LETTER (bug#15917), and clarify. --- doc/emacs/custom.texi | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 81874a04aa7..ee4ab6c3c6f 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -1582,6 +1582,13 @@ starts with @kbd{@key{ESC} [}.) If Emacs understands your terminal type properly, it automatically handles such sequences as single input events. + Key sequences that consists of @kbd{C-c} followed by a letter (upper +or lower case; @acronym{ASCII} or non-@acronym{ASCII}) are reserved +for users. Emacs itself will never bind those key sequences, and +Emacs extensions should avoid binding them. In other words, users can +bind key sequences like @kbd{C-c a} or @kbd{C-c รง} and rely on these +never being shadowed by other Emacs bindings. + @node Prefix Keymaps @subsection Prefix Keymaps -- cgit v1.2.3