From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 24 Feb 2018 17:39:16 +0000 (+0200)
Subject: Document reserved keys
X-Git-Tag: emacs-26.1-rc1~158^2
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=560a23e1dab7a6a203a4a70b3925a87d6cfddf76;p=emacs.git

Document reserved keys

* doc/emacs/custom.texi (Key Bindings): Mention keys reserved for
users.  (Bug#30530)
---

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.