summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2016-10-14 21:59:10 -0700
committerKaz Kylheku <kaz@kylheku.com>2016-10-14 21:59:10 -0700
commit40c04a853c6e4f880d1d3073b499d58f79b8417d (patch)
tree260e764098704520fb61979a12f25fd50b5850f7
parentfb2013cc76b1c50009a2d8656ed8e74f2940fa10 (diff)
downloadtxr-40c04a853c6e4f880d1d3073b499d58f79b8417d.tar.gz
txr-40c04a853c6e4f880d1d3073b499d58f79b8417d.tar.bz2
txr-40c04a853c6e4f880d1d3073b499d58f79b8417d.zip
doc: defsymacro rewording.
* txr.1: Updating awkward wording, beginning with clumsy two-clause sentence joined by a colon.
-rw-r--r--txr.120
1 files changed, 12 insertions, 8 deletions
diff --git a/txr.1 b/txr.1
index 6acff7d2..88f83971 100644
--- a/txr.1
+++ b/txr.1
@@ -26456,16 +26456,20 @@ namespace established by
.desc
A
.code defsymacro
-form introduces a symbol macro: a symbol macro is a parameterless
-substitution keyed to a symbol. In contexts where a symbol macro
-definition of
+form introduces a symbol macro. A symbol macro consists of a binding
+between a symbol
+.meta sym
+and and a
+.metn form .
+The binding denotes the form itself, rather than its value. How the
+symbol macro works is that if
.meta sym
-is visible, if the form
+occurs as a form in a scope where the symbol macro definition is
+in scope,
.meta sym
-appears such that its evaluation is called for, it is subject
-to replacement by
+is replaced by
.metn form .
-After replacement takes place,
+Immediately after this replacement takes place,
.meta form
itself is then processed for further replacement of macros and
symbol macros.
@@ -26497,7 +26501,7 @@ then
first removes that variable from the global environment, and if that
variable is special, the symbol's special marking is removed.
.code defsymacro
-doesn't alter a dynamic binding of a special variable. Any such
+doesn't alter the dynamic binding of a special variable. Any such
a binding remains intact.
If
.code defsymacro