General reformatting & comment revision/cleanup

core/core-editor.el

@@ -224,6 +224,7 @@ savehist file."
 ;; Autoloaded Plugins
 ;;
 
+;; `command-log-mode'
 (setq command-log-mode-auto-show t
       command-log-mode-open-log-turns-on-mode t)
 
@@ -237,6 +238,7 @@ savehist file."
   (advice-add #'evil-escape :before #'doom*quit-expand-region)
   (advice-add #'doom/escape :before #'doom*quit-expand-region))
 
+;; A better *help* buffer
 (def-package! helpful
   :defer t
   :init

core/core-ui.el

@@ -106,13 +106,8 @@ Also see `doom-exit-buffer-hook'.")
 
 (fset #'yes-or-no-p #'y-or-n-p) ; y/n instead of yes/no
 
-
-;;
-;; Shims
-;;
-
+;; doesn't exist in terminal Emacs; define it to prevent errors
 (unless (fboundp 'define-fringe-bitmap)
-  ;; doesn't exist in terminal Emacs; define it to prevent errors
   (defun define-fringe-bitmap (&rest _)))
 
 
@@ -234,7 +229,6 @@ Also see `doom-exit-buffer-hook'.")
         show-paren-when-point-inside-paren t)
   (show-paren-mode +1))
 
-;;; More reliable inter-window border
 ;; The native border "consumes" a pixel of the fringe on righter-most splits,
 ;; `window-divider' does not. Available since Emacs 25.1.
 (setq-default window-divider-default-places t
@@ -247,7 +241,7 @@ Also see `doom-exit-buffer-hook'.")
   (remove-hook 'kill-buffer-query-functions #'server-kill-buffer-query-function))
 (add-hook 'server-visit-hook #'server-remove-kill-buffer-hook)
 
-;; `whitespace-mode'
+;; `whitespace-mode' (built-in)
 (setq whitespace-line-column nil
       whitespace-style
       '(face indentation tabs tab-mark spaces space-mark newline newline-mark

modules/emacs/vc/config.el

@@ -9,7 +9,7 @@
   (advice-add #'git-timemachine--show-minibuffer-details :override #'+vc*update-header-line)
 
   (after! evil
-    ;; Force evil to rehash keybindings for the current state
+    ;; rehash evil keybindings so they are recognized
     (add-hook 'git-timemachine-mode-hook #'evil-normalize-keymaps))
 
   (when (featurep! :tools magit)

modules/tools/magit/config.el

@@ -7,7 +7,8 @@ be set before `magithub' (and `magit') is loaded.")
 (defvar +magit-hub-features
   '(pull-request-merge commit-browse completion)
   "What features to initialize when `magithub' is loaded. Set this to `t' to
-load everything.")
+load everything. See `magithub-feature-list' to see what features are
+available.")
 
 
 ;;