nit: reformat+revise comments

Includes minor refactors to appease the byte-compiler or use more
succinct (but equivalent) syntax.

modules/checkers/syntax/config.el

@@ -87,12 +87,10 @@
 
 ;;
 ;;; Flymake
+
 (use-package! flymake
   :when (modulep! +flymake)
-  :defer t
-  :init
-  ;; as flymakes fail silently there is no need to activate it on a per major mode basis
-  (add-hook! (prog-mode text-mode) #'flymake-mode)
+  :hook ((prog-mode text-mode) . flymake-mode)
   :config
   (setq flymake-fringe-indicator-position 'right-fringe))
 

modules/completion/corfu/config.el

@@ -44,12 +44,11 @@ use the minibuffer such as `query-replace'.")
   (setq corfu-auto t
         corfu-auto-delay 0.18
         corfu-auto-prefix 2
-        global-corfu-modes '((not
-                              erc-mode
-                              circe-mode
-                              help-mode
-                              gud-mode
-                              vterm-mode)
+        global-corfu-modes '((not erc-mode
+                                  circe-mode
+                                  help-mode
+                                  gud-mode
+                                  vterm-mode)
                              t)
         corfu-cycle t
         corfu-preselect 'prompt
@@ -67,8 +66,8 @@ use the minibuffer such as `query-replace'.")
   (add-to-list 'corfu-continue-commands #'+corfu-smart-sep-toggle-escape)
   (add-hook 'evil-insert-state-exit-hook #'corfu-quit)
 
-  ;; If you want to update the visual hints after completing minibuffer commands
-  ;; with Corfu and exiting, you have to do it manually.
+  ;; HACK: If you want to update the visual hints after completing minibuffer
+  ;;   commands with Corfu and exiting, you have to do it manually.
   (defadvice! +corfu--insert-before-exit-minibuffer-a ()
     :before #'exit-minibuffer
     (when (or (and (frame-live-p corfu--frame)

modules/lang/org/autoload/org-babel.el

@@ -40,7 +40,7 @@
             ((user-error "Definition lookup in SRC blocks isn't supported yet"))))))
 
 ;;;###autoload
-(defun +org-lookup-references-handler (identifier)
+(defun +org-lookup-references-handler (_identifier)
   "TODO"
   (when (org-in-src-block-p t)
     (user-error "References lookup in SRC blocks isn't supported yet")))