summaryrefslogtreecommitdiff
path: root/modules/keybindings.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
commit2d83f8f55977dbf69f4f80e490ed0b96aeea4eee (patch)
tree32c5ad0e360e0e15fed1ec83cd967991149b5cc3 /modules/keybindings.el
parent9a0560e87867dc2a23767f66940ba4fb4d5a5c20 (diff)
downloaddotemacs-2d83f8f55977dbf69f4f80e490ed0b96aeea4eee.tar.gz
dotemacs-2d83f8f55977dbf69f4f80e490ed0b96aeea4eee.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/keybindings.el')
-rw-r--r--modules/keybindings.el11
1 files changed, 11 insertions, 0 deletions
diff --git a/modules/keybindings.el b/modules/keybindings.el
index 462fde24..6e8adeac 100644
--- a/modules/keybindings.el
+++ b/modules/keybindings.el
@@ -3,6 +3,17 @@
;;
;;; Commentary:
;;
+;; Layer: 1 (Foundation).
+;; Category: F/C.
+;; Load shape: eager.
+;; Eager reason: owns `cj/custom-keymap' and the global C-; prefix that feature
+;; modules register into; must exist before they load.
+;; Top-level side effects: defines `cj/custom-keymap'/`cj/jump-map', binds
+;; global keys (C-;, C-z, and others), registers which-key labels after-load.
+;; Runtime requires: user-constants (currently eval-when-compile only),
+;; which-key, free-keys.
+;; Direct test load: conditional (binds global keys; needs user-constants).
+;;
;; Global keybinding configuration and custom keymap framework.
;;
;; Main features include: