summaryrefslogtreecommitdiff
path: root/doc/ref/api-binding.texi
diff options
context:
space:
mode:
authorDaniel Llorens <lloda@sarc.name>2023-01-24 11:26:44 +0100
committerDaniel Llorens <lloda@sarc.name>2023-01-25 12:52:29 +0100
commit35566ea585d6ebb0e97a83956de6a39ae2a0c2d5 (patch)
tree3197db2bb3c9db4911a05ec59ed550b14a69a652 /doc/ref/api-binding.texi
parent764e3614b8c13de604399572a67d071621e9ca21 (diff)
downloadguile-35566ea585d6ebb0e97a83956de6a39ae2a0c2d5.tar.gz
Document multiple-value returns in forms taking a let-expression body
* doc/ref/api-binding.texi (Local Bindings): Document multiple-value returns for let. * doc/ref/api-control.texi (begin): Document multiple-value returns for begin. (Conditionals): Document multiple-value returns and use 'body' in the syntax description of when, unless, cond, case. (Multiple values): Document multiple-value returns and use 'body' in the syntax description of SRFI-8 receive. (Fluids and Dynamic States): Use 'body' in the syntax description of 'with-fluids'.
Diffstat (limited to 'doc/ref/api-binding.texi')
-rw-r--r--doc/ref/api-binding.texi11
1 files changed, 8 insertions, 3 deletions
diff --git a/doc/ref/api-binding.texi b/doc/ref/api-binding.texi
index 60f034a0e..32170f978 100644
--- a/doc/ref/api-binding.texi
+++ b/doc/ref/api-binding.texi
@@ -138,6 +138,11 @@ The most basic local binding construct is @code{let}.
that is zero or more two-element lists of a variable and an arbitrary
expression each. All @var{variable} names must be distinct.
+@cindex body, of a @code{let} expression
+
+@var{body} is a sequence of expressions and definitions, ending in an
+expression.
+
A @code{let} expression is evaluated as follows.
@itemize @bullet
@@ -151,9 +156,9 @@ New storage is allocated for the @var{variables}.
The values of the @var{init} expressions are stored into the variables.
@item
-The expressions in @var{body} are evaluated in order, and the value of
-the last expression is returned as the value of the @code{let}
-expression.
+The expressions and definitions in @var{body} are evaluated in order
+(@pxref{Internal Definitions}), and the values of the last expression
+are returned as the result of the @code{let} expression.
@end itemize
The @var{init} expressions are not allowed to refer to any of the