Document that remapping commands is supported with bind-key

Copyright-paperwork-exempt: yes

diff --git a/lisp/use-package/bind-key.el b/lisp/use-package/bind-key.el
index e5cd73e9ea3852f70c69d3e74605b7e378448ea2..5b375a545975c16321bd7675d35e9cb6c00a7278 100644 (file)
--- a/lisp/use-package/bind-key.el
+++ b/lisp/use-package/bind-key.el
@@ -38,6 +38,12 @@
 ;;
 ;;   (bind-key "C-c x" 'my-ctrl-c-x-command)
 ;;
+;; If the keybinding argument is a vector, it is passed straight to
+;; `define-key', so remapping a key with `[remap COMMAND]' works as
+;; expected:
+;;
+;;   (bind-key [remap original-ctrl-c-x-command] 'my-ctrl-c-x-command)
+;;
 ;; If you want the keybinding to override all minor modes that may also bind
 ;; the same key, use the `bind-key*' form:
 ;;