GNU bug report logs - #42750
26.3; Elisp manual, `Lambda Components' and `Defining Functions'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 42750 in the body.
You can then email your comments to 42750 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.3; Elisp manual, `Lambda Components' and `Defining Functions'
Date: Fri, 7 Aug 2020 11:30:44 -0700 (PDT)

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''

Message #8 received at 42750 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: 42750 <at> debbugs.gnu.org
Subject: RE: bug#42750: 26.3; Elisp manual, `Lambda Components' and `Defining
 Functions'
Date: Fri, 7 Aug 2020 11:40:50 -0700 (PDT)

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'.

Message #13 received at 42750-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 42750-done <at> debbugs.gnu.org
Subject: Re: bug#42750: 26.3;
 Elisp manual, `Lambda Components' and `Defining Functions'
Date: Thu, 13 Aug 2020 17:10:02 +0300

> Date: Fri, 7 Aug 2020 11:30:44 -0700 (PDT)
> From: Drew Adams <drew.adams <at> 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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.