aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2023-05-29 19:05:38 -0700
committerKaz Kylheku <kaz@kylheku.com>2023-05-29 19:05:38 -0700
commitff4671eca8e75611a76368eb3f3a3dde334ddb80 (patch)
tree4382b2b39158537619081516e695b99844a57599
parentce18d73fa1f1907ae8c9d7cc245537fa9dd25e20 (diff)
downloadtl-who-ff4671eca8e75611a76368eb3f3a3dde334ddb80.tar.gz
tl-who-ff4671eca8e75611a76368eb3f3a3dde334ddb80.tar.bz2
tl-who-ff4671eca8e75611a76368eb3f3a3dde334ddb80.zip
README: notes about interpolation.
* README.md: Add a note about Lisp evaluation: Lisp expressions that give attribute values are interpolated into HTML; Lisp expressions in tag body are evaled for side effect only.
-rw-r--r--README.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/README.md b/README.md
index fffa92d..71d6773 100644
--- a/README.md
+++ b/README.md
@@ -65,6 +65,15 @@ interpreted as the tag content.
All material that is not a tag or attribute keyword is an evaluated Lisp
expression, so no special syntax is needed to indicate evaluation.
+When the value of an attribute is given as a Lisp expression, that
+value is interpolated automatically into the generated attribute
+syntax.
+
+In the interior of a tag, when a Lisp expression is evaluated, its
+value is **not** turned into output. It is that expression's
+responsibility to generate output, either directly to the HTML
+stream object, or via the convenient local macros like `fmt`,
+`esc` or `str`.
## Documentation