From a218bfe745569ae01de82fb3582875cbfed2dc7a Mon Sep 17 00:00:00 2001 From: Bozhidar Batsov Date: Wed, 16 Sep 2020 09:14:21 +0300 Subject: [PATCH] Document prelude-super-keybindings --- doc/configuration.md | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/doc/configuration.md b/doc/configuration.md index 949fc6f..bbc9958 100644 --- a/doc/configuration.md +++ b/doc/configuration.md @@ -159,7 +159,24 @@ If you prefer not to automatically format your file on save, you can disable tha Currently this only affects automated formatting of Typescript files. +### Disable Super-based keybindings + +Out-of-the-box Prelude will create two versions of many keybindings in `prelude-mode`: + +* One "traditional" version with a prefix like `Control` +* One "alternative" version with a prefix like `Super` + +The reason for this is that there are generally more options for short keybindings with `Super` - e.g. you can +have `s-p`, `s-g`, etc. There's, however, a problem lying here as well - some operating systems and +desktop environments might be making heavy use of such keybindings. (in most cases those would intercept them before Emacs does). +`exwm` also uses those heavily. You prevent Prelude from creating such keybindings via `prelude-super-keybindings`: + +```emacs-lisp +(setq prelude-super-keybindings nil) +``` + ### Configuration per file or directory -These settings can also be set on a per-file or directory basis by using a file local variable or a `.dir-locals.el` -file. +Some of these settings (those that don't need to be pre-loaded) can also be set +on a per-file or directory basis by using a file local variable or a +`.dir-locals.el` file.