From 0ac588eb45df674049dab835b38ee178f552cef7 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Sun, 28 Jun 2026 06:54:37 -0400
Subject: docs: finish the commentary/comment audit tail

Condensed early-init's debug-flags note and added a why for the deferred global-font-lock, rewrote three vcf-conversion-helpers comments to name the real intent (keeping the reverse-order-to-preserve-positions rationale), and gave the archived testutil-filesystem a real summary while deleting its line-by-line narration comments.
---
 early-init.el | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

(limited to 'early-init.el')

diff --git a/early-init.el b/early-init.el
index 32f144cdb..f2ed5bfa3 100644
--- a/early-init.el
+++ b/early-init.el
@@ -21,7 +21,8 @@
 ;;   (add-hook 'after-init-hook 'benchmark-init/deactivate))
 
 ;; -------------------------------- Debug Flags --------------------------------
-;; debugging enabled during Emacs startup. disabled again after Emacs startup.
+;; Keep debug-on-error enabled only during startup; the startup hook restores the
+;; normal interactive behavior after init has loaded.
 
 ;; uncomment when repo signatures expire and package installation is necessary
 ;; (setq package-check-signature nil)
@@ -295,6 +296,8 @@ early-init.el.")
 			   bidi-inhibit-bpa t)         ;; additional speedup
 
 ;; Disable global font lock mode until after initialization
+;; Defer global font-lock until init finishes; major modes re-enable normal
+;; highlighting after startup.
 (setq-default global-font-lock-mode nil)
 (add-hook 'emacs-startup-hook #'global-font-lock-mode)
 
-- 
cgit v1.2.3