aboutsummaryrefslogtreecommitdiff
path: root/shoshin-config.org
diff options
context:
space:
mode:
authorshoshin <shoshin@cicadas.surf>2022-07-17 11:49:01 -0500
committershoshin <shoshin@cicadas.surf>2022-07-17 11:49:01 -0500
commitc570284ace0ed5f1f254f9cc475a30f4be56af0f (patch)
tree7f5c7f4482968814f0f81eb506e194729a4fe2b1 /shoshin-config.org
parent98705ee525fe5a9b88b1664a7984b2d3ec9c4741 (diff)
Add: which-key notes, embark prefix help, inf-ruby package
Diffstat (limited to 'shoshin-config.org')
-rw-r--r--shoshin-config.org28
1 files changed, 28 insertions, 0 deletions
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