From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#17623: 24.4.50; incorrect example for `apply-partially' in (elisp) `Calling Functions' Date: Sat, 28 Jun 2014 19:55:10 +0300 Message-ID: <8338ep6kk1.fsf@gnu.org> References: <9fd43ff1-d6cf-4ac6-b173-2fd634f45a98@default> <871tua2o12.fsf@web.de> <1ac7ebe5-6b43-4367-beb8-df7d9f5b6750@default> <87tx75ni8k.fsf@web.de> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8BIT X-Trace: ger.gmane.org 1403974598 18793 80.91.229.3 (28 Jun 2014 16:56:38 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 28 Jun 2014 16:56:38 +0000 (UTC) Cc: 17623@debbugs.gnu.org To: Michael Heerdegen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jun 28 18:56:29 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1X0vvK-00021b-Ts for geb-bug-gnu-emacs@m.gmane.org; Sat, 28 Jun 2014 18:56:23 +0200 Original-Received: from localhost ([::1]:55343 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X0vvK-0006fM-KG for geb-bug-gnu-emacs@m.gmane.org; Sat, 28 Jun 2014 12:56:22 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48119) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X0vvB-0006d2-K2 for bug-gnu-emacs@gnu.org; Sat, 28 Jun 2014 12:56:19 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1X0vv5-0000Yn-O7 for bug-gnu-emacs@gnu.org; Sat, 28 Jun 2014 12:56:13 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:45136) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X0vv5-0000Yg-Kg for bug-gnu-emacs@gnu.org; Sat, 28 Jun 2014 12:56:07 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1X0vuz-0007eI-Qi for bug-gnu-emacs@gnu.org; Sat, 28 Jun 2014 12:56:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 28 Jun 2014 16:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 17623 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 17623-submit@debbugs.gnu.org id=B17623.140397453429360 (code B ref 17623); Sat, 28 Jun 2014 16:56:01 +0000 Original-Received: (at 17623) by debbugs.gnu.org; 28 Jun 2014 16:55:34 +0000 Original-Received: from localhost ([127.0.0.1]:36286 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1X0vuW-0007dQ-US for submit@debbugs.gnu.org; Sat, 28 Jun 2014 12:55:33 -0400 Original-Received: from mtaout23.012.net.il ([80.179.55.175]:38211) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1X0vuR-0007d0-RG for 17623@debbugs.gnu.org; Sat, 28 Jun 2014 12:55:29 -0400 Original-Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0N7W00L001EZ8100@a-mtaout23.012.net.il> for 17623@debbugs.gnu.org; Sat, 28 Jun 2014 19:55:21 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N7W00LX91O84B70@a-mtaout23.012.net.il>; Sat, 28 Jun 2014 19:55:20 +0300 (IDT) In-reply-to: <87tx75ni8k.fsf@web.de> X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:90942 Archived-At: > From: Michael Heerdegen > Date: Sat, 28 Jun 2014 17:53:15 +0200 > Cc: 17623@debbugs.gnu.org > > 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. Sorry, I don't understand this critique. Perhaps if you suggested an alternative wording, it would become clear what is it that confused you about the current text. Thanks.