From 40c04a853c6e4f880d1d3073b499d58f79b8417d Mon Sep 17 00:00:00 2001 From: Kaz Kylheku Date: Fri, 14 Oct 2016 21:59:10 -0700 Subject: doc: defsymacro rewording. * txr.1: Updating awkward wording, beginning with clumsy two-clause sentence joined by a colon. --- txr.1 | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) (limited to 'txr.1') 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 -- cgit v1.2.3