[Emacs-diffs] emacs-26 560a23e: Document reserved keys

[Eli Zaretskii]

branch: emacs-26
commit 560a23e1dab7a6a203a4a70b3925a87d6cfddf76
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    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 e98884c..af5429d 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.