[COMMIT] Mention that lexical closures are actually available in XEmacs Lisp

[Aidan Kehoe]

APPROVE COMMIT

NOTE: This patch has been committed.

man/ChangeLog addition:

2007-06-27  Aidan Kehoe  <kehoea at parhasard.net>

	* lispref/variables.texi (Extent):
	Mention that lexical scope is available using lexical-let and
	lexical-let* in cl-macs, instead of ignoring them entirely. 


XEmacs Trunk source patch:
Diff command:   cvs -q diff -u
Files affected: man/lispref/variables.texi
===================================================================
RCS

Index: man/lispref/variables.texi
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/man/lispref/variables.texi,v
retrieving revision 1.8
diff -u -r1.8 variables.texi
--- man/lispref/variables.texi	2006/07/16 10:51:47	1.8
+++ man/lispref/variables.texi	2007/06/27 12:17:09
@@ -894,8 +894,12 @@
 
 @cindex closures not available
   Some Lisp dialects have ``closures'', objects that are like functions
-but record additional variable bindings.  XEmacs Lisp does not have
-closures.
+but record additional variable bindings.  Closures are available in
+XEmacs Lisp using the @code{lexical-let} and @code{lexical-let*}macroes,
+which are autoloaded from @file{cl-macs}.  @xref{(cl)Lexical Bindings}.
+Note that function arguments cannot be closed around using these
+macros, and that any lambda expressions returned will not be
+byte-compiled.  
 
 @node Impl of Scope
 @subsection Implementation of Dynamic Scoping

-- 
On the quay of the little Black Sea port, where the rescued pair came once
more into contact with civilization, Dobrinton was bitten by a dog which was
assumed to be mad, though it may only have been indiscriminating. (Saki)