From 0f3d168cbf97886ed5ddc187ca66d42ce3a50936 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Thu, 9 Jul 2026 17:39:24 -0500 Subject: docs(auto-dim): note that ANSI-coloured terminal spans stay lit The commentary claimed EAT buffers dim like any other buffer. Background and uncoloured text do, but ANSI-coloured spans keep their colour: EAT attaches them as anonymous face plists with a literal foreground, and face-remap-add-relative only reaches named faces. I went looking for the missing face name in this alist before working out there isn't one. The note says so now, and points at an overlay as the way in. --- modules/auto-dim-config.el | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'modules') diff --git a/modules/auto-dim-config.el b/modules/auto-dim-config.el index 67a27345..c7216655 100644 --- a/modules/auto-dim-config.el +++ b/modules/auto-dim-config.el @@ -23,6 +23,14 @@ ;; terminal background, so -- unlike the old ghostel/vterm engines, which baked ;; color per-terminal with no per-window hook -- they follow the per-window ;; dimmed background like any other buffer. +;; +;; One caveat, so nobody chases it through this alist: ANSI-coloured spans in a +;; terminal keep their colour when dimmed. EAT attaches those as anonymous face +;; plists carrying a literal foreground, e.g. (:foreground "#AFD7FF" :inherit +;; (eat-term-font-0)), and `face-remap-add-relative' only reaches named faces. +;; There is no face name to add below. Reaching them would need an overlay +;; (whose face outranks a text property), not a remap. Background and uncoloured +;; text still dim, which is close enough; this is deliberate, not an oversight. ;;; Code: -- cgit v1.2.3