Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 

README.md

guru-mode

![License GPL 3][badge-license] MELPA MELPA Stable ko-fi Patreon

Synopsis

Guru mode disables (or warns on) some generic keybindings and suggests the use of the established and more efficient Emacs alternatives instead. Here are a few examples:

  • It will teach you to avoid the arrow keys and use keybindings like C-f, C-b, etc.
  • It will teach you to avoid keybindings using Home, End, etc.
  • It will teach you to avoid Delete/Backspace.

Installation

Manual

Just drop guru-mode.el somewhere in your load-path. I favour the folder ~/.emacs.d/vendor:

(add-to-list 'load-path "~/emacs.d/vendor")
(require 'guru-mode)

MELPA

If you're an Emacs 24 user or you have a recent version of package.el you can install guru-mode from the MELPA repository.

Emacs Prelude

guru-mode is naturally part of the Emacs Prelude. If you're a Prelude user - guru-mode is already properly configured and ready for action.

Usage

You can enable guru-mode globally like this:

(guru-global-mode +1)

Most likely you'd like to enable guru-mode only in specific modes (like prog-mode in Emacs 24):

(add-hook 'prog-mode-hook 'guru-mode)

If you only want to get warnings when you the arrow keys use the following config:

(setq guru-warn-only t)

You can extend the list of keybindings covered by guru-mode like this:

(add-to-list 'guru-affected-bindings-list '("<C-left>" "M-b" left-word))

The list you're adding is of the format (discouraged keybinding, recommended keybinding, command).

Note: guru-mode operates only on global keybindings and it will never interfere with some mode-specific keybindings.

Known issues

Check out the project's issue list a list of unresolved issues. By the way - feel free to fix any of them and send me a pull request. :-)

Contributors

Here's a list of all the people who have contributed to the development of guru-mode.

Bugs & Improvements

Bug reports and suggestions for improvements are always welcome. GitHub pull requests are even better! :-)

Cheers,
Bozhidar

About

Learn to use Emacs the way it was meant to be used (the Emacs guru way)

Resources

Packages

No packages published
You can’t perform that action at this time.