emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

master 7602ed6: Mention the C-c LETTER keybinding convention


From: Lars Ingebrigtsen
Subject: master 7602ed6: Mention the C-c LETTER keybinding convention
Date: Sun, 1 Nov 2020 06:48:46 -0500 (EST)

branch: master
commit 7602ed6b8271cb034383bd371a1a5f753130aaa4
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    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 81874a0..ee4ab6c 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
 



reply via email to

[Prev in Thread] Current Thread [Next in Thread]