Document that remapping commands is supported with bind-key

Copyright-paperwork-exempt: yes

1 files changed, 6 insertions, 0 deletions

diff --git a/lisp/use-package/bind-key.el b/lisp/use-package/bind-key.el
index e5cd73e9ea3..5b375a54597 100644
--- 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:
 ;;