From 9578ee36ef005f0b96c1d5b120f11c178e341775 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Taylan=20Ulrich=20Bay=C4=B1rl=C4=B1/Kammer?= Date: Sun, 30 Aug 2015 10:24:52 +0200 Subject: [PATCH] Amend datum->syntax documentation. * doc/ref/api-macros.texi (Syntax Case): Mention that the first argument to datum->syntax is invalid if it's a compound syntax object, except when also created with datum->syntax. --- doc/ref/api-macros.texi | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/doc/ref/api-macros.texi b/doc/ref/api-macros.texi index c2910a4..9c1f023 100644 --- a/doc/ref/api-macros.texi +++ b/doc/ref/api-macros.texi @@ -618,7 +618,12 @@ But they can, if we explicitly introduce a binding via @code{datum->syntax}. @deffn {Scheme Procedure} datum->syntax for-syntax datum Create a syntax object that wraps @var{datum}, within the lexical context -corresponding to the syntax object @var{for-syntax}. +corresponding to the syntax object @var{for-syntax}. @var{for-syntax} must +either be an identifier, or a syntax object that was also created with +@var{datum->syntax}; other compound syntax objects may be rejected because they +contain identifiers from different lexical contexts, in which case it would be +ambiguous which one's environment should be used for the newly created syntax +object. @end deffn For completeness, we should mention that it is possible to strip the metadata -- 2.5.0