]> git.eshelyaron.com Git - emacs.git/commitdiff
Mention the C-c LETTER keybinding convention
authorLars Ingebrigtsen <larsi@gnus.org>
Sun, 1 Nov 2020 11:48:34 +0000 (12:48 +0100)
committerLars Ingebrigtsen <larsi@gnus.org>
Sun, 1 Nov 2020 11:48:40 +0000 (12:48 +0100)
* doc/emacs/custom.texi (Keymaps): Reintroduce the text about C-c
LETTER (bug#15917), and clarify.

doc/emacs/custom.texi

index 81874a04aa7c7d838dbcc63496e432da81987ec8..ee4ab6c3c6f183662bba1dcc54dc365d29cafa00 100644 (file)
@@ -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