Update Functions chapter of Lisp manual; document closures.
authorChong Yidong <cyd@gnu.org>
Sat, 4 Feb 2012 14:56:32 +0000 (22:56 +0800)
committerChong Yidong <cyd@gnu.org>
Sat, 4 Feb 2012 14:56:32 +0000 (22:56 +0800)
commit735cc5ca6fe9b19aa9f69eb696baef2b8b4bd0fb
treecf9722413f79647d3c302142d8e9cc95bdfa13af
parentd7f29f8e5c589e4676b2ab53fea7a8b4cfcd4be3
Update Functions chapter of Lisp manual; document closures.

* doc/emacs/functions.texi (What Is a Function): Add closures.  Mention
"return value" terminology.  Add xref for command-execute.  Remove
unused "keystroke command" terminology.
(Lambda Expressions): Give a different example than in the
following subsection.  Add xref to Anonymous Functions.
(Function Documentation): Remove gratuitous markup.
(Function Names): Move introductory text to `What Is a Function'.
(Defining Functions): Fix defun argument spec.
(Anonymous Functions): Document lambda macro explicitly.  Mention
effects on lexical binding.
(Function Cells): Downplay direct usage of fset.
(Closures): New node.
(Inline Functions): Remove "open-code" terminology.
(Declaring Functions): Minor tweak; .m is not C code.

* doc/emacs/variables.texi (Variables): Don't refer to "global value".
(Local Variables, Void Variables): Copyedits.
(Lexical Binding): Minor clarification of example.
(File Local Variables): Mention :safe and :risky defcustom args.
(Lexical Binding): Add xref to Closures node.
admin/FOR-RELEASE
doc/lispref/ChangeLog
doc/lispref/elisp.texi
doc/lispref/functions.texi
doc/lispref/variables.texi
doc/lispref/vol1.texi
doc/lispref/vol2.texi
etc/NEWS