From 20ee90614ae86828a7141251a4c245428cd9470b Mon Sep 17 00:00:00 2001
From: Henrik Lissner <git@henrik.io>
Date: Thu, 11 Jul 2024 21:39:38 -0400
Subject: [PATCH] nit(cli): revise comment over site-run-file loader

To better explain to the wondering reader why we're loading site-start
here.
---
 lisp/doom-cli.el | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/lisp/doom-cli.el b/lisp/doom-cli.el
index cef7faab0..cf32f6505 100644
--- a/lisp/doom-cli.el
+++ b/lisp/doom-cli.el
@@ -23,8 +23,11 @@
               doom-cache-dir
               doom-state-dir))
 
-  ;; HACK: Load `cl' and site files manually to prevent polluting logs and
-  ;;   stdout with deprecation and/or file load messages.
+  ;; HACK: bin/doom invokes Emacs with --no-site-lisp solely to allow us to load
+  ;;   site-start manually, here, to suppress any output it produces, and they
+  ;;   almost always produce some. This causes premature redraws of the Emacs
+  ;;   frame during startup (to display those messages in the minibuffer), which
+  ;;   -- as I mention in the comments of doom.el -- really hurts startup time.
   (quiet!
    (require 'cl nil t)
    (unless site-run-file