From 43652af453658b46b5e99adac1c6d2c9a2e746dc Mon Sep 17 00:00:00 2001
From: noa@gaiwan.org
Date: Sun, 23 Jun 2024 00:40:20 +0000
Subject: Add configuration for help

---
 config.org | 36 ++++++++++++++++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/config.org b/config.org
index 9a7fccc..a71f9af 100644
--- a/config.org
+++ b/config.org
@@ -484,14 +484,46 @@ I also want to make the completion at point function a bit more friendly than th
 (setopt completion-in-region-function 'consult-completion-in-region)
 #+end_src
 
-Select the help window so that i can easily close it again with q
+* Getting help
+Emacs is great because of its great built in help system!
+
+** Close help buffers more easily
+By default, opening a help buffer keeps the original window active, but this means that i have to go into the help buffer to close it.  Some people might like to always have the help buffer hanging around, but i like my screen empty of distractions.  Luckily there's a simple setting to select the help window so that i can easily close it again with q.
 
 #+begin_src elisp
 (setopt help-window-select t)
 #+end_src
 
+Also to that end, we use the same window as the help buffer to open source files.
+
+#+begin_src elisp
+  (setopt help-window-keep-selected t)
+#+end_src
+
+** Better aesthetics
+Help buffers put quotes around links in the buffer.  I don't think this adds anything to the output.
+
+#+begin_src elisp
+  (setopt help-clean-buttons t)
+	  #+end_src
+
+The arguments are shown in upper case.  I don't want to be shouted at!  I already define them to be bold, this is all the attention they need.
+
+#+begin_src elisp
+  (setopt help-downcase-arguments t)
+	  #+end_src
+
+** Edit variables from help buffers
+Often, i will look at the documentation for a variable and immediately want to play with it.  This removes one step between wanting that and being able to do that.
+
+#+begin_src elisp
+  (setopt help-enable-variable-value-editing t)
+#+end_src
+
+* Switching buffers
+
 #+begin_src elisp
-(setopt switch-to-buffer-obey-display-actions t)
+    (setopt switch-to-buffer-obey-display-actions t)
 #+end_src
 
 ** Org mode
-- 
cgit 1.4.1-2-gfad0