Skip to content

clojure-emacs/cider-hydra

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 

Repository files navigation

Hydras for CIDER.

Overview

This package defines some hydras (pop-up menus of commands with common prefixes) for CIDER.

Hydras serve several important purposes: discovery, memorization, and organization.

  • Discovery

    • Grouping related commands together under a common prefix and displaying them in a single menu facilitates discovery.

    • For example, if a user wants to know about CIDER's documentation commands, they could bring up a hydra that includes commands like cider-doc', cider-javadoc', etc, some of which may be new to them.

  • Memorization

    • Hydras serve as a memory aid for the user. By grouping related commands together, the user has less need to memorize every command; knowing one, she can find the others.
  • Organization

    • The process of creating hydras can aid in organizing code. This gives both developers and users a better overview of what the project can or cannot do.

    • Thus, each hydra is like a section of a quick-reference card. In fact, many of the hydras here are inspired by the CIDER refcard: https://github.com/clojure-emacs/cider/blob/master/doc/cider-refcard.pdf

Install

After setting up MELPA as a repository, use M-x package-install cider-hydra to install the package.

Setup

Add the following to your init file:

(add-hook 'clojure-mode-hook #'cider-hydra-mode)

To turn hydras off, just disable the cider-hydra-mode, which will restore the previous CIDER commands.

See Also

  • The which-key package, which displays keys following for a prefix key.

Packages

No packages published

Contributors 3

  •  
  •  
  •