From bd68ff5a593b3747b1efed75ca54f2b5eeec8230 Mon Sep 17 00:00:00 2001 From: Daniel Llorens Date: Thu, 19 Jan 2023 16:23:29 +0100 Subject: [PATCH] Fix doc for conditional forms taking lambda-like bodies * doc/ref/api-control.texi (Simple Conditional Evaluation): Use 'body' in the syntax description of when, unless, cond, case. --- doc/ref/api-control.texi | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/doc/ref/api-control.texi b/doc/ref/api-control.texi index ece6a6020..7ad52e080 100644 --- a/doc/ref/api-control.texi +++ b/doc/ref/api-control.texi @@ -142,13 +142,13 @@ an expression that is evaluated for effect, not for value). In such a case, it is considered more clear to express these intentions with these special forms, @code{when} and @code{unless}. As an added -bonus, these forms accept multiple statements to evaluate, which are -implicitly wrapped in a @code{begin}. +bonus, these forms take a @ref{Local Bindings,lambda-like body}, which can +contain @ref{Internal Definitions,internal definitions} and multiple statements +to evaluate. -@deffn {Scheme Syntax} when test statement1 statement2 ... -@deffnx {Scheme Syntax} unless test statement1 statement2 ... -The actual definitions of these forms are in many ways their most clear -documentation: +@deffn {Scheme Syntax} when test body +@deffnx {Scheme Syntax} unless test body +The actual definitions of these forms may be their most clear documentation: @example (define-syntax-rule (when test stmt stmt* ...) @@ -167,11 +167,10 @@ statements if @var{test} is false. Each @code{cond}-clause must look like this: @lisp -(@var{test} @var{body} @dots{}) +(@var{test} @var{body}) @end lisp -where @var{test} is an arbitrary expression and @var{body} is a -lambda-like body, or like this +where @var{test} is an arbitrary expression, or like this @lisp (@var{test} => @var{expression}) @@ -217,7 +216,7 @@ result of the @code{cond}-expression. @var{key} may be any expression, and the @var{clause}s must have the form @lisp -((@var{datum1} @dots{}) @var{body} @dots{}) +((@var{datum1} @dots{}) @var{body}) @end lisp or @@ -229,7 +228,7 @@ or and the last @var{clause} may have the form @lisp -(else @var{expr1} @var{body} @dots{}) +(else @var{body}) @end lisp or -- 2.30.2