aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-06-09 06:04:44 -0500
committerCraig Jennings <c@cjennings.net>2026-06-09 06:04:44 -0500
commit6efc7f89b134b8dbfb51d8d6992f01749c38dfef (patch)
tree4c476e68e3ab8853f419e9bd89f28342ac331ed5
parent892b981875a75bff1b484a30aacd39ef4143b01f (diff)
downloaddotemacs-6efc7f89b134b8dbfb51d8d6992f01749c38dfef.tar.gz
dotemacs-6efc7f89b134b8dbfb51d8d6992f01749c38dfef.zip
docs(theme-studio): warn that fill_data tokens are replaced in comments too
-rw-r--r--scripts/theme-studio/generate.py3
1 files changed, 3 insertions, 0 deletions
diff --git a/scripts/theme-studio/generate.py b/scripts/theme-studio/generate.py
index e2a26f825..24ad7a1b7 100644
--- a/scripts/theme-studio/generate.py
+++ b/scripts/theme-studio/generate.py
@@ -503,6 +503,9 @@ APP_JS</script>"""
# Fill the data placeholders. str.replace is literal (no backref interpretation),
# so backslashes in the inlined JS survive intact — the escaping-bug class that
# the triple-quoted string used to cause is gone now that app.js is a real file.
+# Caveat: these tokens are replaced everywhere they appear, including inside code
+# comments. Don't write a placeholder name (COLORMATH_J, APP_CORE_J, ...) in
+# prose in any inlined file, or that prose gets the body spliced into it too.
def fill_data(s):
return (s.replace("COLORMATH_J",COLORMATH_BODY)
.replace("APP_CORE_J",APP_CORE_BODY)