Previous: Performance, Up: Essential Settings [Contents][Index]
This option controls whether some Magit commands are automatically bound in the global keymap even before Magit is used for the first time in the current session.
If this variable is non-nil, which it is by default, then the following bindings may be added to the global keymap.
C-x g | magit-status |
C-x M-g | magit-dispatch |
C-c M-g | magit-file-dispatch |
These bindings may be added when after-init-hook
is called.
Each binding is added if and only if at that time no other key
is bound to the same command and no other command is bound to
the same key. In other words we try to avoid adding bindings
that are unnecessary, as well as bindings that conflict with
other bindings.
Adding the above bindings is delayed until after-init-hook
is called to allow users to set the variable anywhere in their
init file (without having to make sure to do so before magit
is loaded or autoloaded) and to increase the likelihood that
all the potentially conflicting user bindings have already
been added.
Setting this variable after the hook has already been called has no effect.
We recommend that you bind C-c g
instead of C-c M-g
to
magit-file-dispatch
. The former is a much better binding
but the C-c <letter>
namespace is strictly reserved for
users; preventing Magit from using it by default.
(global-set-key (kbd "C-c g") 'magit-file-dispatch)
Also see Commands for Buffers Visiting Files and (elisp)Key Binding Conventions.