summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2016-12-06 05:04:24 -0800
committerKaz Kylheku <kaz@kylheku.com>2016-12-06 05:04:24 -0800
commit5d08be74f82ec4b6816b25da7eff777f01ce8ad4 (patch)
tree6e63af0a54003bb3eed604f8babfac312919845a
parent0c28514c428a1ccd73aedf10e7225c584266bf38 (diff)
downloadtxr-5d08be74f82ec4b6816b25da7eff777f01ce8ad4.tar.gz
txr-5d08be74f82ec4b6816b25da7eff777f01ce8ad4.tar.bz2
txr-5d08be74f82ec4b6816b25da7eff777f01ce8ad4.zip
doc: dialect note about quasiquote.
* txr.1: Document that unquoting and splicing forms may appear outside of unquote syntax.
-rw-r--r--txr.113
1 files changed, 13 insertions, 0 deletions
diff --git a/txr.1 b/txr.1
index 0679a1b2..710622ed 100644
--- a/txr.1
+++ b/txr.1
@@ -10401,6 +10401,19 @@ to apply the ordinary non-splicing unquote to the symbol
whitespace must be used:
.codn ", *abc" .
+In \*(TX, the unquoting and splicing forms may freely appear outside of
+a quasiquote template. If they are evaluated as forms, however, they
+throw an exception:
+
+.cblk
+ ,(+ 2 2) ;; error!
+
+ ',(+ 2 2) --> ,(+ 2 2)
+.cble
+
+In other Lisp dialects, a comma not enclosed by backquote syntax is
+treated as a syntax error by the reader.
+
.NP* Quasiquoting non-List Objects
Quasiquoting is supported over hash table and vector literals (see Vectors
and Hashes below). A hash table or vector literal can be quoted, like any