>From dfd9978d839eccf744835e2e1daed9e140800214 Mon Sep 17 00:00:00 2001 From: Marcin Borkowski Date: Wed, 7 Mar 2018 14:03:57 +0100 Subject: [PATCH] Reword docs of let and let* Make it slightly more prominent that local bindings are destroyed in case of an error within let's body. --- doc/lispref/variables.texi | 4 ++-- src/eval.c | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi index e025d3fd10..49eba3816e 100644 --- a/doc/lispref/variables.texi +++ b/doc/lispref/variables.texi @@ -155,7 +155,7 @@ Local Variables Global variables have values that last until explicitly superseded with new values. Sometimes it is useful to give a variable a address@hidden value}---a value that takes effect only within a certain address@hidden value}---a value that is in effect only within a certain part of a Lisp program. When a variable has a local value, we say that it is @dfn{locally bound} to that value, and that it is a @dfn{local variable}. @@ -165,7 +165,7 @@ Local Variables function call; these local bindings take effect within the body of the function. To take another example, the @code{let} special form explicitly establishes local bindings for specific variables, which -take effect within the body of the @code{let} form. +are in effect only within the body of the @code{let} form. We also speak of the @dfn{global binding}, which is where (conceptually) the global value is kept. diff --git a/src/eval.c b/src/eval.c index 08a73b1e4a..bc08f0d084 100644 --- a/src/eval.c +++ b/src/eval.c @@ -843,7 +843,7 @@ DEFUN ("internal-make-var-non-special", Fmake_var_non_special, DEFUN ("let*", FletX, SletX, 1, UNEVALLED, 0, - doc: /* Bind variables according to VARLIST then eval BODY. + doc: /* Bind local variables according to VARLIST then eval BODY. The value of the last form in BODY is returned. Each element of VARLIST is a symbol (which is bound to nil) or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM). @@ -902,7 +902,7 @@ usage: (let* VARLIST BODY...) */) } DEFUN ("let", Flet, Slet, 1, UNEVALLED, 0, - doc: /* Bind variables according to VARLIST then eval BODY. + doc: /* Bind local variables according to VARLIST then eval BODY. The value of the last form in BODY is returned. Each element of VARLIST is a symbol (which is bound to nil) or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM). -- 2.16.2