diff options
author | Eli Zaretskii <eliz@gnu.org> | 2020-08-13 17:08:37 +0300 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2020-08-13 17:08:37 +0300 |
commit | 69568674b3bb5b5f65f2c1342aded205a00f696a (patch) | |
tree | 26962661c908951d3523c51c1b1db03e5ed5a4af /doc/lispref/functions.texi | |
parent | 1c0bc1ccd85615bcc26409ee047513e9e26f108e (diff) | |
download | emacs-69568674b3bb5b5f65f2c1342aded205a00f696a.tar.gz emacs-69568674b3bb5b5f65f2c1342aded205a00f696a.tar.bz2 emacs-69568674b3bb5b5f65f2c1342aded205a00f696a.zip |
Improve documentation of function argument lists
* doc/lispref/functions.texi (Lambda Components)
(Defining Functions): Add a cross-reference to "Argument List".
(Argument List): Improve the section name. (Bug#42750)
Diffstat (limited to 'doc/lispref/functions.texi')
-rw-r--r-- | doc/lispref/functions.texi | 9 |
1 files changed, 5 insertions, 4 deletions
diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi index bc8ec0ef1b0..2898cb4d2b4 100644 --- a/doc/lispref/functions.texi +++ b/doc/lispref/functions.texi @@ -267,7 +267,8 @@ reason functions are defined to start with @code{lambda} is so that other lists, intended for other uses, will not accidentally be valid as functions. - The second element is a list of symbols---the argument variable names. + The second element is a list of symbols---the argument variable +names (@pxref{Argument List}). This is called the @dfn{lambda list}. When a Lisp function is called, the argument values are matched up against the variables in the lambda list, which are given local bindings with the values provided. @@ -342,7 +343,7 @@ stored as symbol function definitions to produce named functions (@pxref{Function Names}). @node Argument List -@subsection Other Features of Argument Lists +@subsection Features of Argument Lists @kindex wrong-number-of-arguments @cindex argument binding @cindex binding arguments @@ -583,8 +584,8 @@ a function. @defmac defun name args [doc] [declare] [interactive] body@dots{} @code{defun} is the usual way to define new Lisp functions. It defines the symbol @var{name} as a function with argument list -@var{args} and body forms given by @var{body}. Neither @var{name} nor -@var{args} should be quoted. +@var{args} (@pxref{Argument List}) and body forms given by @var{body}. +Neither @var{name} nor @var{args} should be quoted. @var{doc}, if present, should be a string specifying the function's documentation string (@pxref{Function Documentation}). @var{declare}, |