diff --git a/README.md b/README.md index 7e7cf3f..babcf9b 100644 --- a/README.md +++ b/README.md @@ -5,6 +5,8 @@ bindings with a common prefix - a Hydra. ![hydra](http://oremacs.com/download/Hydra.jpg) +## Description for Poets + Once you summon the Hydra through the prefixed binding (the body + any one head), all heads can be called in succession with only a short extension. @@ -13,6 +15,20 @@ Hercules, besides vanquishing the Hydra, will still serve his original purpose, command. This makes the Hydra very seamless, it's like a minor mode that disables itself auto-magically. +## Description for Pragmatics + +Imagine that you have bound C-c j and C-c k in your +config. You want to call C-c j and C-c k in some +(arbitrary) sequence. Hydra allows you to: + +- Bind your functions in a way that pressing C-c jjkk3j5k is +equivalent to pressing C-c j C-c j C-c k C-c k M-3 C-c j M-5 C-c +k. Any key other than j or k exits this state. + +- Assign a custom hint to this group of functions, so that you know immediately +after pressing C-c that you can follow up with j or +k. + If you want to quickly understand the concept, see [the video demo](https://www.youtube.com/watch?v=_qZliI1BKzI).