aboutsummaryrefslogtreecommitdiff
path: root/modules/custom-buffer-file.el
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-24 16:20:01 -0500
committerCraig Jennings <c@cjennings.net>2026-05-24 16:20:01 -0500
commit4a6eee7bb2e82246b4a07f517212fcf9ac40a157 (patch)
tree3ce58f7ae68886100d8b061b298a11b19254cd12 /modules/custom-buffer-file.el
parent07bbe4ee9ed49b873b02d7cad1c7a6903eccdde4 (diff)
downloaddotemacs-4a6eee7bb2e82246b4a07f517212fcf9ac40a157.tar.gz
dotemacs-4a6eee7bb2e82246b4a07f517212fcf9ac40a157.zip
docs(load-graph): classify text/editing command modules
Second classification batch: the nine custom-* text/editing command helpers (case, comments, datetime, buffer-file, line-paragraph, misc, ordering, text-enclose, whitespace). I annotated each with the load-graph header contract and added a Batch 2 table to the inventory. They're all Layer 2, eager only to register a C-; submap at load, with no necessary eager reason, so all are Phase 3/4 deferral candidates. The inventory records a second hidden dependency for Phase 2: custom-buffer-file guards its C-; b registration with (when (boundp 'cj/custom-keymap) ...) and declares the keymap only via eval-when-compile, so the binding silently drops when the module loads without keybindings.
Diffstat (limited to 'modules/custom-buffer-file.el')
-rw-r--r--modules/custom-buffer-file.el13
1 files changed, 13 insertions, 0 deletions
diff --git a/modules/custom-buffer-file.el b/modules/custom-buffer-file.el
index e3fdedf2f..671912440 100644
--- a/modules/custom-buffer-file.el
+++ b/modules/custom-buffer-file.el
@@ -1,6 +1,19 @@
;;; custom-buffer-file.el --- Custom Buffer and File Operations -*- coding: utf-8; lexical-binding: t; -*-
;;
;;; Commentary:
+;;
+;; Layer: 2 (Core UX).
+;; Category: L/C.
+;; Load shape: eager.
+;; Eager reason: registers its C-; b buffer/file submap at load. Currently eager
+;; by init order; a deferral candidate for Phase 3/4.
+;; Top-level side effects: defines cj/copy-buffer-content-map and
+;; cj/buffer-and-file-map; conditionally registers the latter under C-; b.
+;; Runtime requires: external-open, mm-decode, system-lib. keybindings is needed
+;; for the C-; b registration but is declared only via eval-when-compile and
+;; guarded by `boundp', so the binding silently drops standalone. Phase 2 fix.
+;; Direct test load: conditional (C-; b registration skipped without keybindings).
+;;
;; This module provides custom buffer and file operations including PostScript
;; printing capabilities.
;;