From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#17623: 24.4.50; incorrect example for `apply-partially' in (elisp) `Calling Functions' Date: Sat, 23 Oct 2021 11:44:21 +0200 Message-ID: <87ee8cyt1m.fsf@web.de> References: <9fd43ff1-d6cf-4ac6-b173-2fd634f45a98@default> <871tua2o12.fsf@web.de> <1ac7ebe5-6b43-4367-beb8-df7d9f5b6750@default> <87tx75ni8k.fsf@web.de> <8338ep6kk1.fsf@gnu.org> <87pphsor8h.fsf@web.de> <83tx746fgd.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19007"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: 17623-done@debbugs.gnu.org To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Oct 23 11:45:57 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1meDbB-0004iG-Jb for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 23 Oct 2021 11:45:57 +0200 Original-Received: from localhost ([::1]:55532 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1meDb9-0008BM-HL for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 23 Oct 2021 05:45:55 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58490) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1meDaI-0008BE-Iz for bug-gnu-emacs@gnu.org; Sat, 23 Oct 2021 05:45:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:51084) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1meDaI-0000S4-2t for bug-gnu-emacs@gnu.org; Sat, 23 Oct 2021 05:45:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1meDaI-0001e7-0i for bug-gnu-emacs@gnu.org; Sat, 23 Oct 2021 05:45:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 23 Oct 2021 09:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 17623 X-GNU-PR-Package: emacs Original-Received: via spool by 17623-done@debbugs.gnu.org id=D17623.16349822736280 (code D ref 17623); Sat, 23 Oct 2021 09:45:01 +0000 Original-Received: (at 17623-done) by debbugs.gnu.org; 23 Oct 2021 09:44:33 +0000 Original-Received: from localhost ([127.0.0.1]:34397 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meDZp-0001dE-B8 for submit@debbugs.gnu.org; Sat, 23 Oct 2021 05:44:33 -0400 Original-Received: from mout.web.de ([212.227.15.3]:51161) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meDZl-0001cy-Ga for 17623-done@debbugs.gnu.org; Sat, 23 Oct 2021 05:44:31 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1634982263; bh=zGiXDBnx1ARqwFN2hTupWP/Rdz61FmFNjo/J3Owk9gg=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=GUDTSksGlcyoVbPCCvdQp0rmkhSri4UeTz+lZhnm1Vu4Zvg1oCuFFS0SVGS9RzbeF V0wiuNrfykFJzrMN/vGU7+ccL/kCSZSRcUXW7/TnzYsxI4u8jgNQ77DtHf3O/4+ZMJ RRlu9dKxdF+xGUQpvVLGd022j7PJQC0MbCm6L65Y= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Original-Received: from drachen.dragon ([92.208.225.87]) by smtp.web.de (mrweb006 [213.165.67.108]) with ESMTPSA (Nemesis) id 1MuF8z-1myd8l3Jhl-00u72Y; Sat, 23 Oct 2021 11:44:22 +0200 In-Reply-To: (Stefan Kangas's message of "Fri, 22 Oct 2021 22:24:55 -0700") X-Provags-ID: V03:K1:Ff6l5Af+PMq25SPDX5ApFdWkacJSM5y1WPVoVlnH6fkmNcaefob SX9KIkNKMzBU+63qt5tGCI1D5aXTrIfzEgxmSnZjHO5U2dXGdrFxVoNTzDanA/+/ZJNbWQf tqC/0s1GdTSm4w/u8WAFthi07H9VAcU4VO2/kNbhR8ZGmsLDCJXW1OOzm+vg6b/dknOyJZf VG83XaWkv3xi8mPkzflJQ== X-UI-Out-Filterresults: notjunk:1;V03:K0:ErJ0y7HUYjI=:jgrIg8exJ4njosQBatO2/E m09lNa9VZ+dnaYCJ7Y8mmoDZJuYUxq14QwnsGRY0cMmoVBAQo7UIHRBRuLmPMtEOg3zkZimbD CSwHOw5YnxafKv3/aHZl6NNzAcTEi2kiT8qdlbl4ZWzKdlj57sQ+tjXkuSzTSeAWCh1k1cgRW av3JA5566Z25w1AGpPpIAqiI06o6yu8TTiZQN8JPBmla8mZ7E7zA68USSqQMVxchsLRfVqpF8 6ZXdlX5mbYbBtDdIJOp1LrHjLhOaYpyNJfc1464gCJ3ZxmnbRgJNNFR5KUFwrfisoG1Y+FjT3 ENZQKZi83MIfDxSCWAAtUKHgcFvYiJ29kSxRRDuXeiccJSb502fKWt0+snYCDVgxS4taHcPE4 GwVPvev6LwF3H+OTvxeGSztdjBD3abFPh/akDIvA42eNtgiLFz4c37an3tLJN3L471gD7CD1n FMo2dbKe/jWO1Gw9Hi6x0tHV71Bel4Zh0DRsojyvGBhFr3E8dr83qU8VpTpuitCcojo+qVQse mUboWoV+o0HfCL62quukL11mhZ+l4tyV4OdVRgCMk6388qrGfDK0R/FAevNtHmAr4eDDjJwn4 +ZRP2eRpB2Pmp5SpFmuMtbT7Ou4JZhx8iRhimOFwSUMjXtVdYOWwLrbf/LKYh03iIrhLjY09h +LrHE/ZsODEDxLFtoxoQFlJ8EfZh7VjsbhbIYRzTNtcgNDD6fBPi9xtM6u49CuQmaX102lOXI JTt4/EmuEAsD1KioZTQ0bSegaLC+PPHm+YvbVbnN8JKIVX//hf6aR3NZNGYYJLYswMqHZrin X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:217964 Archived-At: Stefan Kangas writes: > There was a discussion here about how to improve the 'apply-partially' > documentation, but it didn't yield any concrete suggestions for > improvements. I read the text we have now, and I find it clear with > regards to the questions raised in this thread, so I'm closing this bug > report. I disagree. The paragraph in the manual explains what the arity of the function returned by `apply-partially' would be. Directly following is an example suggesting that (apply-partially '+ 1) is equivalent to #'1+ - which obviously contradicts that preceding paragraph. I'm a bit confused that you don't consider this a problem, and also that you said there were no concrete suggestions. There were concrete suggestions for improvements. One was to simply spell out the function that is constructed. It is only one line, and would make the semantics clear. BTW, whenever I posted an example using `apply-partially', Stefan told me that it would be more efficient to write out the lambda. That aspect could also be covered: when is worth using? Or delete that paragraph, better to say nothing than to confuse readers. Michael.