nit: comment revision & reformatting

modules/completion/corfu/config.el

@@ -28,8 +28,10 @@ TAB/S-TAB.")
   "If non-nil, prefer navigating org tables over cycling candidates with
 TAB/S-TAB.")
 
+
 ;;
 ;;; Packages
+
 (use-package! corfu
   :hook (doom-first-input . global-corfu-mode)
   :init

modules/editor/format/autoload/lsp.el

@@ -2,7 +2,6 @@
 ;;;###if (modulep! :tools lsp)
 
 (defvar +format-lsp--last nil)
-
 ;;;###autoload
 (define-minor-mode +format-with-lsp-mode
   "Toggles `lsp-mode'/`eglot' integration with `apheleia-mode' in this buffer.

modules/emacs/dired/config.el

@@ -1,8 +1,12 @@
-;;; tools/dired/config.el -*- lexical-binding: t; -*-
+;;; emacs/dired/config.el -*- lexical-binding: t; -*-
 
 (defvar +dired-dirvish-icon-provider 'nerd-icons
   "Icon provider to use for dirvish when the module is enabled.")
 
+
+;;
+;;; Packages
+
 (use-package! dired
   :commands dired-jump
   :init

modules/lang/beancount/config.el

@@ -18,7 +18,7 @@
   ;; HACK: The intro message changed in newer versions of Fava, plus, the output
   ;;   could contain ANSI codes, causing the `beancount-fava' command to not
   ;;   open the server in the browser after the server has started.
-  ;; REVIEW: PR this uptsream!
+  ;; REVIEW: PR this upstream!
   (defadvice! +beancount--open-in-browser-after-starting-fix-a (_process output)
     :override #'beancount--fava-filter
     (save-match-data

modules/lang/clojure/config.el

@@ -10,6 +10,7 @@
 (defvar +clojure-load-clj-refactor-with-lsp nil
   "Whether or not to include clj-refactor along with clojure-lsp.")
 
+
 ;;
 ;;; Packages
 

modules/lang/go/config.el

@@ -69,6 +69,7 @@
   (set-company-backend! 'go-mode 'company-go)
   (setq company-go-show-annotation t))
 
+
 (use-package! flycheck-golangci-lint
   :when (and (modulep! :checkers syntax)
              (not (modulep! :checkers syntax +flymake)))

modules/lang/haskell/config.el

@@ -6,7 +6,7 @@
 
 
 ;;
-;;; Common packages
+;;; Packages
 
 (after! haskell-mode
   (setq haskell-process-suggest-remove-import-lines t  ; warnings for redundant imports etc

modules/os/macos/config.el

@@ -18,7 +18,9 @@
 ;; Visit files opened outside of Emacs in existing frame, not a new one
 (setq ns-pop-up-frames nil)
 
-;; sane trackpad/mouse scroll settings
+;; Sane trackpad/mouse scroll settings. Also disables smooth scrolling because
+;; it's disturbingly clunky and slow without something like
+;; jdtsmith/ultra-scroll-mac.
 (setq mac-redisplay-dont-reset-vscroll t
       mac-mouse-wheel-smooth-scroll nil)
 

modules/ui/popup/autoload/settings.el

@@ -163,6 +163,7 @@ used.
 \(fn PREDICATE &key IGNORE ACTIONS SIDE SIZE WIDTH HEIGHT SLOT VSLOT TTL QUIT SELECT MODELINE AUTOSAVE PARAMETERS)"
   (declare (indent defun))
   (push (+popup-make-rule predicate plist) +popup--display-buffer-alist)
+  ;; TODO: Don't overwrite user entries in `display-buffer-alist'
   (when (bound-and-true-p +popup-mode)
     (setq display-buffer-alist +popup--display-buffer-alist))
   +popup--display-buffer-alist)