From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eric Abrahamsen Newsgroups: gmane.emacs.bugs Subject: bug#34708: alist-get has unclear documentation Date: Sun, 03 Mar 2019 08:49:14 -0800 Message-ID: <87zhqbhpit.fsf@ericabrahamsen.net> References: <87wolhr5k6.fsf@web.de> <87y35xdu4w.fsf@web.de> <87mumcdu7f.fsf@web.de> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="146819"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Michael Heerdegen , "Miguel V. S. Frasson" , 34708@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Mar 03 17:50:15 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1h0UJa-000c1p-Vc for geb-bug-gnu-emacs@m.gmane.org; Sun, 03 Mar 2019 17:50:15 +0100 Original-Received: from localhost ([127.0.0.1]:41494 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h0UJa-0001wu-01 for geb-bug-gnu-emacs@m.gmane.org; Sun, 03 Mar 2019 11:50:14 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:40084) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h0UJQ-0001wo-A8 for bug-gnu-emacs@gnu.org; Sun, 03 Mar 2019 11:50:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1h0UJP-00008d-FQ for bug-gnu-emacs@gnu.org; Sun, 03 Mar 2019 11:50:04 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:45116) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1h0UJO-000055-RB for bug-gnu-emacs@gnu.org; Sun, 03 Mar 2019 11:50:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1h0UJO-0004zP-Kf for bug-gnu-emacs@gnu.org; Sun, 03 Mar 2019 11:50:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eric Abrahamsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 03 Mar 2019 16:50:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34708 X-GNU-PR-Package: emacs Original-Received: via spool by 34708-submit@debbugs.gnu.org id=B34708.155163176419122 (code B ref 34708); Sun, 03 Mar 2019 16:50:02 +0000 Original-Received: (at 34708) by debbugs.gnu.org; 3 Mar 2019 16:49:24 +0000 Original-Received: from localhost ([127.0.0.1]:58660 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h0UIm-0004yM-BU for submit@debbugs.gnu.org; Sun, 03 Mar 2019 11:49:24 -0500 Original-Received: from ericabrahamsen.net ([52.70.2.18]:34624 helo=mail.ericabrahamsen.net) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h0UIk-0004y8-1r for 34708@debbugs.gnu.org; Sun, 03 Mar 2019 11:49:23 -0500 Original-Received: from localhost (97-126-72-117.tukw.qwest.net [97.126.72.117]) (Authenticated sender: eric@ericabrahamsen.net) by mail.ericabrahamsen.net (Postfix) with ESMTPSA id 1C095FA02D; Sun, 3 Mar 2019 16:49:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ericabrahamsen.net; s=mail; t=1551631756; bh=uwmMvbv6ZY5wra/VhzPWoZJxMvr3qmGWzvKBIiXvYXU=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From; b=tAoYL1tyEwFo7Adb4IZ7TCSkM4DInskyHVRxDjUK8D3yNzffHAx4kmIn2bjT48F99 7DHAaMDgZ/vY8bJxZ6hTE+hkdCM+X4KcxMBM01A7zJmacb+V2JuwZpHdkS1ak7/gm1 t4ysX8/Kk6sia0Qgb8Q0+cCPQO4UJWaIrA9O+gcA= In-Reply-To: (Drew Adams's message of "Sun, 3 Mar 2019 07:51:51 -0800 (PST)") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:155998 Archived-At: On 03/03/19 07:51 AM, Drew Adams wrote: [...] >> Eric suggested to say "this form is a setf-able place" but this also >> doesn't answer the question what this (form) is. `alist-get' is not a >> form, it's the name of a function. In my opinion it would be cleaner >> to say something like "the name of this function can be used to build >> place expressions" or "can be used in place expressions" or so. >> Better ideas welcome. Well I used "form" because it _is_ the form -- (alist-get KEY ALIST) -- that is the setf-able place, not the function/macro/name of the function. At least as far as the coder is concerned. > Yes wrt the substance (content). But an active > phrasing is often better than the passive "__ can > be used". Say what this does by saying what you > can do with it. > > You can use function `alist-get' in a PLACE-expression > argument to `setf'. In this role it specifies an > alist element whose value `setf' sets: > (setf (alist-get KEY ALIST) NEW-VALUE) > > Here, `setf' sets the value part of an element > of ALIST whose key is KEY to NEW-VALUE. But I like the above better anyway!