GNU bug report logs - #17623
24.4.50; incorrect example for `apply-partially' in (elisp) `Calling Functions'

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Wed, 28 May 2014 23:55:01 UTC

Severity: minor

Found in version 24.4.50

Done: Stefan Kangas <stefan <at> marxist.se>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: Michael Heerdegen <michael_heerdegen <at> web.de>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 17623 <at> debbugs.gnu.org
Subject: bug#17623: 24.4.50; incorrect example for `apply-partially' in (elisp) `Calling Functions'
Date: Sat, 28 Jun 2014 17:53:15 +0200
Hi,

BTW, the second sentence here from (info "(elisp) Calling Functions") is
confusing too wrt what it says about arguments.

,----------------------------------------------------------------------
| The act of fixing some of the function’s arguments is
| called "partial application" of the function(1).  The result is a new
| function that accepts the rest of arguments and calls the original
| function with all the arguments combined.
`----------------------------------------------------------------------

IMHO we should be more clearer about arguments, but then we can keep the
1+ example.  I think it would be more important to say that
`apply-partially` is most useful in combination with functionals, as it
is explained later on that info page.  That the result accepts any
number of arguments is more kind of an implementation detail.


Michael.




This bug report was last modified 3 years and 262 days ago.

Previous Next


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