From 6bf441ff11540f2c49cb4f9d506597217cdc73d6 Mon Sep 17 00:00:00 2001 From: Robert Pluim Date: Mon, 20 Mar 2023 16:09:51 +0100 Subject: [PATCH] Warn package authors away from keymap-unset with REMOVE * doc/lispref/keymaps.texi (Changing Key Bindings): Ask package authors to not use the REMOVE argument to `keymap-unset'. --- doc/lispref/keymaps.texi | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi index c17c8a2dc3f..0eea696c612 100644 --- a/doc/lispref/keymaps.texi +++ b/doc/lispref/keymaps.texi @@ -1452,6 +1452,12 @@ keymap; using @var{remove} instead will allow the key in the parent keymap to be used. @end defun +Note: using @code{keymap-unset} with @var{remove} non-@code{nil} is +intended for users to put in their init file; Emacs packages should +avoid using it if possible, since they have complete control over +their own keymaps anyway, and they should not be altering other +packages' keymaps. + This example creates a sparse keymap and makes a number of bindings in it: -- 2.39.5