summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLars Ingebrigtsen <larsi@gnus.org>2020-11-01 12:48:34 +0100
committerLars Ingebrigtsen <larsi@gnus.org>2020-11-01 12:48:40 +0100
commit7602ed6b8271cb034383bd371a1a5f753130aaa4 (patch)
tree5d3c552309eb58a1004b3effaed1c4b8605e3631
parent06585bb939ed61574a4b79455c58cab02f11f0fc (diff)
downloademacs-7602ed6b8271cb034383bd371a1a5f753130aaa4.tar.gz
Mention the C-c LETTER keybinding convention
* doc/emacs/custom.texi (Keymaps): Reintroduce the text about C-c LETTER (bug#15917), and clarify.
-rw-r--r--doc/emacs/custom.texi7
1 files changed, 7 insertions, 0 deletions
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