From c570284ace0ed5f1f254f9cc475a30f4be56af0f Mon Sep 17 00:00:00 2001 From: shoshin Date: Sun, 17 Jul 2022 11:49:01 -0500 Subject: Add: which-key notes, embark prefix help, inf-ruby package --- shoshin-config.org | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) (limited to 'shoshin-config.org') diff --git a/shoshin-config.org b/shoshin-config.org index 8d381ea..9c05ae3 100644 --- a/shoshin-config.org +++ b/shoshin-config.org @@ -445,6 +445,9 @@ perspective-local buffers where the perspective was tied to a project. #+begin_src emacs-lisp (package-install 'embark) + (package-install 'embark-consult) + (global-set-key (kbd "C-;") #'embark-act) + (setq prefix-help-command #'embark-prefix-help-command) #+end_src ** marginalia @@ -502,6 +505,23 @@ this is implemented with the ~vertico-directory~ extension. #+end_src ** which-key +which-key is an excellent package that helps provide guide posts for command +discoverability. many key commands in Emacs are in sequences. for example, +~org-babel-tangle~ is ~C-c C-v t~. as a user, the commands you use often +become muscle memory, or you map them to something more convienient. but +sometimes you know there is some command to do what you want but you don't +quite remember what the sequence is. or perhaps you're in a new major-mode +and you know there must be several handy commands under ~C-c~. ~which-key~ +pops up a buffer with a listing of all the possible continuations from where +you are in a key sequence. for that reason, it can be useful at times even +for experienced users. + +this config installs which-key, but does not activate it automatically. +some advice from Daniel Mendler (consult author) suggested that limiting the +amount Emacs pops things up automatically is a better user experience. +which-key is just a toggle away when needed, and there is also [[*embark][embark]] +which has a command to show prefix key continuations. + #+begin_src emacs-lisp (package-install 'which-key) (which-key-mode) @@ -583,6 +603,14 @@ from them in various Emacs menus. [[*\[\[info:consult#Top\]\[consult\]\] - Consu #+end_src *** Ruby +**** inf-ruby + +inf-ruby provides an interface to the various REPLs available in the Ruby-verse +its currently provided by non-gnu ELPA: + +#+begin_src emacs-lisp + (package-install 'inf-ruby) +#+end_src ** Dev Docs #+begin_src emacs-lisp -- cgit v1.2.3