docs: normalize generated-file headers and prune obvious comments

The theme-studio and browser-choice generators now stamp their output with a header that names the authoritative source and says to regenerate rather than hand-edit. I regenerated both files to match. I also deleted six obvious "describe the next form" comments, replaced two stale placeholders in titlecase.el and an incomplete FIXME in org-checklist.el with real rationale, and condensed early-init's header and Commentary.

6 files changed, 4 insertions, 7 deletions

diff --git a/modules/browser-config.el b/modules/browser-config.el
index d596b9e9d..564e7a275 100644
--- a/modules/browser-config.el
+++ b/modules/browser-config.el
@@ -76,7 +76,10 @@ Includes built-in Emacs browsers (those with nil executable)."
 (defun cj/save-browser-choice (browser-plist)
   "Save BROWSER-PLIST to the persistence file."
   (with-temp-file cj/browser-choice-file
-    (insert ";;; Browser choice - Auto-generated\n")
+    (insert ";;; browser-choice.el --- Generated browser selection -*- lexical-binding: t; -*-\n")
+    (insert ";;\n")
+    (insert ";; Generated by browser-config.el. Do not edit by hand; use\n")
+    (insert ";; `cj/choose-browser' to rewrite this file.\n")
     (insert (format "(setq cj/saved-browser-choice '%S)\n" browser-plist))))
 
 (defun cj/load-browser-choice ()
@@ -102,7 +105,6 @@ Returns: \\='success if applied successfully,
           (program-var (plist-get browser-plist :program-var)))
       (if (null browse-fn)
           'invalid-plist
-        ;; Set the main browse-url function
         (setq browse-url-browser-function browse-fn)
         ;; Set the specific browser program variable if it exists
         (when program-var
diff --git a/modules/calibredb-epub-config.el b/modules/calibredb-epub-config.el
index cd8101db1..10a78942c 100644
--- a/modules/calibredb-epub-config.el
+++ b/modules/calibredb-epub-config.el
@@ -178,7 +178,6 @@ Adjust it live with `cj/nov-widen-text' and `cj/nov-narrow-text'.")
   (if (and buffer-file-name
            (string-match-p "\\.epub\\'" buffer-file-name))
       (progn
-        ;; Load nov if not already loaded
         (unless (featurep 'nov)
           (require 'nov nil t))
         ;; Call nov-mode if available, otherwise fallback to default behavior
diff --git a/modules/font-config.el b/modules/font-config.el
index cb060b7be..7617ba01e 100644
--- a/modules/font-config.el
+++ b/modules/font-config.el
@@ -193,7 +193,6 @@ If FRAME is nil, uses the selected frame."
   (all-the-icons-nerd-fonts-prefer))
 
 ;; ----------------------------- Emoji Fonts Per OS ----------------------------
-;; Set emoji fonts in priority order (first found wins)
 
 (defun cj/setup-emoji-fontset (&optional _frame)
   "Set emoji fonts in priority order (first found wins).
diff --git a/modules/org-webclipper.el b/modules/org-webclipper.el
index a51350f51..40ceada76 100644
--- a/modules/org-webclipper.el
+++ b/modules/org-webclipper.el
@@ -52,7 +52,6 @@ See `cj/--webclip-url' for the binding contract.")
 (defun cj/webclipper-ensure-initialized ()
   "Ensure webclipper is initialized when first used."
   (unless cj/webclipper-initialized
-    ;; Load required packages now
     (require 'org-protocol)
     (require 'org-capture)
     (require 'org-web-tools)
diff --git a/modules/selection-framework.el b/modules/selection-framework.el
index 464654a20..7f7f9a475 100644
--- a/modules/selection-framework.el
+++ b/modules/selection-framework.el
@@ -128,7 +128,6 @@
   ;; Optionally tweak the register preview window.
   (advice-add #'register-preview :override #'consult-register-window)
 
-  ;; Configure other variables and modes
   (setq xref-show-xrefs-function #'consult-xref
         xref-show-definitions-function #'consult-xref)
 
diff --git a/modules/tramp-config.el b/modules/tramp-config.el
index e3b835f1f..f2bc8457c 100644
--- a/modules/tramp-config.el
+++ b/modules/tramp-config.el
@@ -57,7 +57,6 @@
   (setq tramp-auto-save-directory
 		(expand-file-name "tramp-auto-save" user-emacs-directory))
 
-  ;; Create directory if it doesn't exist
   (unless (file-exists-p tramp-auto-save-directory)
 	(make-directory tramp-auto-save-directory t))