From a357997d7578ac66c1279ccfa5475f23da8b522e Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Fri, 6 Sep 2013 14:56:44 -0600 Subject: [PATCH] syntax/for-body: adjust docs to clarify why it exists --- .../racket-doc/syntax/scribblings/for-body.scrbl | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/pkgs/racket-pkgs/racket-doc/syntax/scribblings/for-body.scrbl b/pkgs/racket-pkgs/racket-doc/syntax/scribblings/for-body.scrbl index 1483d7f44a..763e30bfbb 100644 --- a/pkgs/racket-pkgs/racket-doc/syntax/scribblings/for-body.scrbl +++ b/pkgs/racket-pkgs/racket-doc/syntax/scribblings/for-body.scrbl @@ -18,4 +18,10 @@ The @racket[body-stxes] argument must have the form @racket[(_post-body ...)] is as large as possible without containing a @racket[#:break] or @racket[#:final] clause. -The @racket[stx] argument is used only for reporting syntax errors.} +The @racket[stx] argument is used only for reporting syntax errors. + +Use @racket[split-for-body] instead of assuming that the last form in +a @racket[for]-like form's body can be wrapped separately. In +particular, the last form might contain definitions that need to be +spliced in the same definition context as earlier forms to create +mutually-recursive definitions.}