bug#42750: 26.3; Elisp manual, `Lambda Components' and `Defining Functions'

bug#42750: 26.3; Elisp manual, `Lambda Components' and `Defining Functions'

[Drew Adams]

In the Elisp manual, I looked for doc describing a lambda list, to point
a user to it.

I tried `i lambda list', which took me to `Lambda Components'.  But
there's nothing there that explains the lambda list
`(ARG-VARIABLES...)'.  And no link to any doc that explains/describes
it.

I tried `i defun', which took me to `Defining Functions'.  But again,
there's nothing there that explains ARGS (syntax, meanings, etc.).  And
no link to any doc that explains/describes that argument list.

Finally, I tried `i arg TAB', and used `argument lists, features', which
took me to `Argument List', which provides the description.  This is
also what's typically called a "lambda list", FWIW.

Please provide links from the first two topics to topic `Argument List',
or otherwise provide the missing descriptions of `(ARG-VARIABLES...)'
and ARGS.

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.18362
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''

bug#42750: 26.3; Elisp manual, `Lambda Components' and `Defining Functions'

[Drew Adams]

Also, the name of topic/node `Argument List'
that's written in the node itself is `Other
Features of Argument Lists'.  That seems wrong.

The content of the node is not "other" features
about argument lists; it's just argument lists.

As it says, it specifies "the complete syntax
for an argument list".  Complete, not just some
"other".

IMO it should be called `Argument List' or
`Lambda List' or some such.  It doesn't matter
that it follows an introductory `Simple Lambda'
node, whose full title is anyway `A Simple
Lambda Expression Example'.

bug#42750: 26.3; Elisp manual, `Lambda Components' and `Defining Functions'

[Eli Zaretskii]

> Date: Fri, 7 Aug 2020 11:30:44 -0700 (PDT)
> From: Drew Adams <drew.adams@oracle.com>
> 
> Please provide links from the first two topics to topic `Argument List',
> or otherwise provide the missing descriptions of `(ARG-VARIABLES...)'
> and ARGS.

Thanks, done.

> Also, the name of topic/node `Argument List'
> that's written in the node itself is `Other
> Features of Argument Lists'.  That seems wrong.

Fixed.