General comment revision & cleanup

core/core-editor.el

@@ -111,8 +111,8 @@ successfully sets indent_style/indent_size.")
   ;;
   ;; This is because autorevert abuses the heck out of inotify handles which can
   ;; grind Emacs to a halt if you do expensive IO (outside of Emacs) on the
-  ;; files you have open (like compression). We only really need revert changes
-  ;; when we switch to a buffer or when we focus the Emacs frame.
+  ;; files you have open (like compression). We only really need to revert
+  ;; changes when we switch to a buffer or when we focus the Emacs frame.
   (defun doom-auto-revert-buffer-h ()
     "Auto revert current buffer, if necessary."
     (unless auto-revert-mode

core/core.el

@@ -146,7 +146,9 @@ users).")
 ;; to, it's our (the user's) failure. One case for all!
 (setq auto-mode-case-fold nil)
 
-;; Enable all disabled commands.
+;; Some commands are disabled and emit a warning whenever they are used. Let's
+;; assume the user always knows what they're doing (hahahaha) and enable all
+;; disabled commands.
 (setq disabled-command-function nil)
 
 ;; Display the bare minimum at startup. We don't need all that noise. The

core/packages.el

@@ -9,6 +9,8 @@
 (package! all-the-icons)
 (package! hide-mode-line)
 (package! highlight-numbers)
+;; Some early 26.x builds of Emacs do not have `display-line-numbers' yet, so
+;; check for it instead of Emacs' version.
 (unless (locate-library "display-line-numbers")
   (package! nlinum)
   (package! nlinum-hl)

modules/config/default/+evil-bindings.el

@@ -54,7 +54,7 @@
         [remap quit-window] #'kill-current-buffer)
 
       (:map (help-mode-map helpful-mode-map)
-        :n "o" 'ace-link-help)
+        :n "o" #'ace-link-help)
 
       ;; misc
       :n "C-S-f"  #'toggle-frame-fullscreen

modules/lang/data/config.el

@@ -18,7 +18,7 @@
 ;;
 ;;; Third-party plugins
 
-;; `csv-mode'
+;;;###package csv-mode
 (map! :after csv-mode
       :localleader
       :map csv-mode-map
@@ -37,13 +37,12 @@
   :config
   (set-electric! 'json-mode :chars '(?\n ?: ?{ ?})))
 
-(use-package! jsonnet-mode
-  :defer t
-  :config
+(after! jsonnet-mode
   (set-electric! 'jsonnet-mode :chars '(?\n ?: ?{ ?})))
 
+
 ;;
-;; Frameworks
+;;; Frameworks
 
 (def-project-mode! +data-vagrant-mode
   :files ("Vagrantfile"))