From 0de051ed6a11e15ed53fa4029f57ddc816e6b820 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Sat, 13 Jun 2026 19:23:52 -0500
Subject: Clarify theme studio reset and erase actions

---
 scripts/theme-studio/README.md | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

(limited to 'scripts/theme-studio/README.md')

diff --git a/scripts/theme-studio/README.md b/scripts/theme-studio/README.md
index e319a324b..b680e6a82 100644
--- a/scripts/theme-studio/README.md
+++ b/scripts/theme-studio/README.md
@@ -105,11 +105,14 @@ Three tiers of faces, plus the palette:
   function, type, comment, and the rest), each with normal/bold/italic and a
   contrast rating. Click a category to flash its tokens in the code; click a
   token to flash its row. `lock all` flips to `unlock all` when every row in the
-  tier is locked; `clear unlocked` leaves locked rows untouched.
+  tier is locked. `reset unlocked` restores unlocked rows to the captured syntax
+  defaults; `erase unlocked` blanks unlocked rows. Both leave locked rows
+  untouched.
 - **UI faces** — cursor, region, mode-line, fringe, line numbers, isearch, paren
   match, link, error/warning/success, and the rest, foreground and background
-  per face, shown in a live mock Emacs buffer. The same lock-all and clear
-  unlocked controls apply to the UI face tier.
+  per face, shown in a live mock Emacs buffer. `reset unlocked` restores captured
+  UI face defaults; `erase unlocked` blanks unlocked rows to no explicit fg/bg.
+  Both leave locked rows untouched.
 - **Package faces** — per-package face tables with a live preview (below).
 
 ## Color columns
@@ -190,9 +193,11 @@ Pick an application from the dropdown to edit its faces. Each row has a
 foreground and background dropdown, bold/italic toggles, an `inherit` dropdown
 (base faces like `fixed-pitch`/`link` plus the app's own faces), a relative
 height stepper, a contrast readout, and a per-face reset. There's a per-app
-reset and a text filter for the large sets. Package `lock all` / `unlock all`
-applies to the whole currently selected package, not only the rows visible under
-the text filter.
+reset and a text filter for the large sets. Package `reset unlocked` restores unlocked
+rows to the captured package defaults; `erase unlocked` blanks unlocked rows to
+no fg/bg/style/inherit override. Both leave locked rows untouched. Package
+`lock all` / `unlock all` applies to the whole currently selected package, not
+only the rows visible under the text filter.
 
 Twenty applications have bespoke previews that exercise nearly all of their
 faces: org-mode (a document plus an agenda view), magit (a status buffer plus
-- 
cgit v1.2.3