aboutsummaryrefslogtreecommitdiff
path: root/modules/config-utilities.el
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-24 16:13:01 -0500
committerCraig Jennings <c@cjennings.net>2026-05-24 16:13:01 -0500
commit03e9f6b2b6797e3b89bd683bd60e7b62e51e87be (patch)
tree2f5306d4a7768550017a5df8aa546f32d826a3b4 /modules/config-utilities.el
parentb7389d3a99197c08b4f1fa3627ef00a934574616 (diff)
downloaddotemacs-03e9f6b2b6797e3b89bd683bd60e7b62e51e87be.tar.gz
dotemacs-03e9f6b2b6797e3b89bd683bd60e7b62e51e87be.zip
docs(load-graph): seed module inventory and annotate foundation headers
I started the init.el load-graph classification with the foundation batch. I added docs/design/module-inventory.org as the living per-module inventory and annotated the seven foundation modules (system-lib, user-constants, host-environment, system-defaults, keyboard-compat, keybindings, config-utilities) with the load-graph header contract: layer, category, load shape, eager reason, top-level side effects, runtime requires, and direct-test-load safety. I changed no load order, so init.el keeps its current eager order. The inventory records one hidden dependency for Phase 2: system-defaults uses host-environment and user-constants symbols at load while declaring them eval-when-compile, so the compiled module cannot load standalone.
Diffstat (limited to 'modules/config-utilities.el')
-rw-r--r--modules/config-utilities.el9
1 files changed, 9 insertions, 0 deletions
diff --git a/modules/config-utilities.el b/modules/config-utilities.el
index 4ed086d1..b3eec5d3 100644
--- a/modules/config-utilities.el
+++ b/modules/config-utilities.el
@@ -2,6 +2,15 @@
;; author Craig Jennings <c@cjennings.net>
;;; Commentary:
+;;
+;; Layer: 1 (Foundation).
+;; Category: C/O.
+;; Load shape: eager.
+;; Eager reason: the C-c d debug keymap is kept available during config work.
+;; Top-level side effects: defines `cj/debug-config-keymap', binds it to C-c d.
+;; Runtime requires: cl-lib, cl-generic, eieio, find-lisp, profiler.
+;; Direct test load: yes (defines a keymap and helpers; batch-safe).
+;;
;; Development and debugging utilities for Emacs configuration maintenance.
;;
;;; Code: