Document paren configuration.

1 files changed, 22 insertions, 5 deletions

diff --git a/init.org b/init.org
index d02be48..0038d01 100644
--- a/init.org
+++ b/init.org
@@ -786,6 +786,28 @@ Geiser makes Scheme development really nice.  It’s also used for Guix developm
   (setq geiser-guile-load-path '("~/dev/guix-wip")))
 #+END_SRC
 
+Parentheses don’t annoy me but I still prefer to have them fade into the background a little.  This is what =paren-face-mode= does.
+
+#+BEGIN_SRC elisp :noweb-ref paren-face-hook
+(require 'paren-face)
+(global-paren-face-mode 1)
+#+END_SRC
+
+Emacs also highlights matching parentheses, but it does so with a delay.  Here I’m disabling the delay.
+
+#+BEGIN_SRC elisp :noweb-ref show-paren-hook
+(require 'paren)
+(setq show-paren-delay 0)
+(show-paren-mode 1)
+#+END_SRC
+
+TODO: the parentheses adjustments should happen only when I’m in programming mode.
+
+#+BEGIN_SRC elisp
+<<paren-face-hook>>
+<<show-paren-hook>>
+#+END_SRC
+
 * TODO Initial stuff
 :PROPERTIES:
 :header-args: :noweb-ref initial
@@ -818,11 +840,6 @@ This is even more stuff to be done after initialising packages.  I still need to
 #+BEGIN_SRC elisp
 ;; better defaults, includes hiding the GUI
 (require 'better-defaults)
-(require 'paren-face)
-(global-paren-face-mode 1)
-(require 'paren)
-(setq show-paren-delay 0)
-(show-paren-mode 1)
 
 (require 'projectile)
 (projectile-global-mode)