From 560a23e1dab7a6a203a4a70b3925a87d6cfddf76 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 24 Feb 2018 19:39:16 +0200 Subject: [PATCH] Document reserved keys * doc/emacs/custom.texi (Key Bindings): Mention keys reserved for users. (Bug#30530) --- doc/emacs/custom.texi | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index e98884cb920..af5429d50c7 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -1417,6 +1417,14 @@ commands, and @dfn{keymaps}, which record key bindings. It also explains how to customize key bindings, which is done by editing your init file (@pxref{Init Rebinding}). + Since most modes define their own key bindings, activating a mode +might override your custom key bindings. A small number of keys are +reserved for user-defined bindings, and should not be used by modes, +so key bindings using those keys are safer in this regard. The +reserved key sequences are those consisting of @kbd{C-c} followed by a +letter (either upper or lower case), and function keys @key{F5} +through @key{F9} without modifiers (@pxref{Modifier Keys}). + @menu * Keymaps:: Generalities. The global keymap. * Prefix Keymaps:: Keymaps for prefix keys. -- 2.39.2