aboutsummaryrefslogtreecommitdiff
path: root/scripts
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-06-08 06:35:06 -0500
committerCraig Jennings <c@cjennings.net>2026-06-08 06:35:06 -0500
commitcb6444fa80208dd1c13265eafdc4964848c9fc81 (patch)
tree2931378527c5ac30007722e79b91d91d30009265 /scripts
parent3d2c86d466960254f36b3122fed1b8eefb9029b8 (diff)
downloaddotemacs-cb6444fa80208dd1c13265eafdc4964848c9fc81.tar.gz
dotemacs-cb6444fa80208dd1c13265eafdc4964848c9fc81.zip
docs(theme-selector): document underline and strike in the theme.json contract
Record the two new face booleans in the README contract and the spec's state-and-export-policy block, including that the converter writes them as :underline t and :strike-through t.
Diffstat (limited to 'scripts')
-rw-r--r--scripts/theme-selector/README.md8
1 files changed, 5 insertions, 3 deletions
diff --git a/scripts/theme-selector/README.md b/scripts/theme-selector/README.md
index b7e8f155d..8f63383c1 100644
--- a/scripts/theme-selector/README.md
+++ b/scripts/theme-selector/README.md
@@ -118,6 +118,7 @@ The export (and what a build step consumes):
"packages": {
"org-mode": {
"org-level-1": {"fg": "#67809c", "bg": null, "bold": true, "italic": false,
+ "underline": false, "strike": false,
"inherit": null, "height": 1.3, "source": "default"}
}
}
@@ -127,9 +128,10 @@ The export (and what a build step consumes):
- `assignments` maps syntax category keys to hexes; `bg` is the `default` face
background, `p` the foreground.
- `ui` and `packages` faces carry `fg`/`bg` (hex or `null`), `bold`, `italic`,
- and for package faces `inherit` (a face name or `null`), `height` (a float,
- omitted at 1.0), and `source` (`"default"` seeded, `"user"` edited,
- `"cleared"`).
+ `underline`, `strike`, and for package faces `inherit` (a face name or
+ `null`), `height` (a float, omitted at 1.0), and `source` (`"default"` seeded,
+ `"user"` edited, `"cleared"`). The converter writes `underline` as
+ `:underline t` and `strike` as `:strike-through t`.
- The theme name is both the `name` field and the download filename. Import a
`theme.json` to start from a prior theme; a file with no `packages` key still
loads.