Document :customizations in emacs config

flake.lock

@@ -2,11 +2,11 @@
   "nodes": {
     "emacs-overlay": {
       "locked": {
-        "lastModified": 1616142448,
+        "lastModified": 1616156829,
-        "narHash": "sha256-8u9rBGwvKm+LzzE72yJFWnZrqWac0yYv3gjd7OnOtsM=",
+        "narHash": "sha256-UfDBl9DBjPrU3PHg5CS38mLjDMUPBtcaWaTcCTgln6c=",
         "owner": "nix-community",
         "repo": "emacs-overlay",
-        "rev": "fe4b8f089c74233814a74626bb6fb58142d977c9",
+        "rev": "fbc910b94b313e821e833f407076a163527fa517",
         "type": "github"
       },
       "original": {

modules/emacs/init.el

@@ -72,10 +72,10 @@
 ;; Vim keybindings
 (use-package evil
   :custom
-  ;; Disable default evil keybindings, since evil-collection is a superset
+  (evil-want-keybinding nil "Disable default evil keybindings, since
-  ;; See https://github.com/emacs-evil/evil-collection/issues/60
+    evil-collection is a superset. See
-  (evil-want-keybinding nil)
+    https://github.com/emacs-evil/evil-collection/issues/60.")
-  (evil-want-integration t)
+  (evil-want-integration t "Also needed for evil-collection")
   :config (evil-mode 1)
   )
 
@@ -98,10 +98,10 @@
 ;; Autocomplete framework
 (use-package ivy
   :custom
-  (ivy-count-format "(%d/%d) ")
+  (ivy-count-format "(%d/%d) " "Format used to display match count")
-  (ivy-height 20)
+  (ivy-height 20 "Maximum height of the ivy buffer")
-  (ivy-use-virtual-buffers t)
+  (ivy-use-virtual-buffers t "Include recent files and bookmarks in buffer switch")
-  (ivy-wrap t)
+  (ivy-wrap t "Wrap next and previous at the end and beginning of the completion list")
   :config (ivy-mode 1)
   :diminish (ivy-mode)
   )
@@ -110,12 +110,13 @@
 (use-package ledger-mode
   :mode "\\.journal\\'"
   :custom
-  (ledger-binary-path "hledger")
+  (ledger-binary-path "hledger" "Use hledger instead of ledger")
-  (ledger-highlight-xact-under-point nil)
+  (ledger-highlight-xact-under-point nil "Remove distracting highlight")
-  (ledger-post-account-alignment-column 4)
+  (ledger-mode-should-check-version nil "Remove version check, since it doesn't work with hledger anyway")
-  (ledger-post-amount-alignment-at :decimal)
+  (ledger-post-account-alignment-column 4 "Indent postings with 4 spaces")
-  (ledger-post-amount-alignment-column 59)
+  (ledger-post-amount-alignment-at :decimal "Align on the decimal")
-  (ledger-post-auto-align t)
+  (ledger-post-amount-alignment-column 59 "Align on column 60")
+  (ledger-post-auto-align t "Align when moving to the next line")
   )
 
 ;; Language server support
@@ -142,11 +143,11 @@
 ;; Theming
 (use-package modus-themes
   :custom
-  (modus-themes-bold-constructs t)
+  (modus-themes-bold-constructs t "Use bold accents")
-  (modus-themes-syntax 'alt-syntax-yellow-comments)
+  (modus-themes-syntax 'alt-syntax-yellow-comments "Show comments in yellow instead of gray")
-  (modus-themes-promts 'intense-accented)
+  (modus-themes-promts 'intense-accented "Colours are nice")
-  (modus-themes-mode-line 'borderless)
+  (modus-themes-mode-line 'borderless "Thin borders are ugly")
-  (modus-themes-region 'bg-only)
+  (modus-themes-region 'bg-only "Don't lose syntax highlighting in the active region")
   :config
   (modus-themes-load-themes)
   (modus-themes-load-operandi)
@@ -160,8 +161,9 @@
   :after (ripgrep)
   :diminish (projectile-mode)
   :custom
-  (projectile-completion-system 'ivy)
+  (projectile-completion-system 'ivy "Make sure projectile uses ivy as
-  (projectile-switch-project-action #'projectile-dired)
+    the completion system. This should be autodetected, but that doesn't
+    seem to work")
   :config (projectile-mode 1)
   :general
   (nmap