bug#11407: 24.0.96; Doc for lexical binding in Elisp manual

[Stefan Monnier]

tags 11407 wontfix
thanks

> With the arrival of lexical scoping in Emacs 24, it is even more
> important, not less, that the Elisp manual document `lexical-let(*)'.

Why?  I intend to mark lexical-let as obsolete in 24.2.

> (defun foo (arg)
>   (lexical-let ((beta  (something)))
>     #'(lambda () (alpha arg beta))))
 
> Does the closure here treat ARG as lexically bound by the `defun', or is
> ARG a dynamically bound free var in the lambda?  I believe the answer it

The behavior is largely the result of some accidental design decisions
taken years ago in the implementation of lexical-let, and I have no
intention to document the result.


        Stefan