From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'. Date: Thu, 21 Jan 2016 23:39:57 -0800 Message-ID: References: <20160116143238.27391.97533@vcs.savannah.gnu.org> <8737ttx5dm.fsf@web.de> <83oachbgz0.fsf@gnu.org> <87vb6pih39.fsf@web.de> <83h9i9besq.fsf@gnu.org> <87mvs1ieql.fsf@web.de> <83bn8hbcpp.fsf@gnu.org> <87a8o1ics6.fsf@web.de> <838u3lbbe8.fsf@gnu.org> <87vb6osb0o.fsf@web.de> <87h9i86tke.fsf@web.de> <878u3in7ye.fsf@web.de> <83fuxq95jt.fsf@gnu.org> <83d1su94bn.fsf@gnu.org> <83twm66qjp.fsf@gnu.org> Reply-To: John Wiegley NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1453448439 19637 80.91.229.3 (22 Jan 2016 07:40:39 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 22 Jan 2016 07:40:39 +0000 (UTC) Cc: michael_heerdegen@web.de, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jan 22 08:40:32 2016 Return-path: Envelope-to: ged-emacs-devel@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 1aMWKd-0000Is-Ct for ged-emacs-devel@m.gmane.org; Fri, 22 Jan 2016 08:40:31 +0100 Original-Received: from localhost ([::1]:51141 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMWKc-0004gM-JX for ged-emacs-devel@m.gmane.org; Fri, 22 Jan 2016 02:40:30 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45242) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMWKZ-0004fK-PS for emacs-devel@gnu.org; Fri, 22 Jan 2016 02:40:28 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aMWKY-0006CF-O7 for emacs-devel@gnu.org; Fri, 22 Jan 2016 02:40:27 -0500 Original-Received: from mail-pa0-x231.google.com ([2607:f8b0:400e:c03::231]:35122) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMWKU-0006BE-Mf; Fri, 22 Jan 2016 02:40:22 -0500 Original-Received: by mail-pa0-x231.google.com with SMTP id ho8so37235870pac.2; Thu, 21 Jan 2016 23:40:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:reply-to:mail-followup-to:mime-version:content-type; bh=kpL+8Th9WI815hQUPznNulyw0aM1XBaN5ced+YVYjiQ=; b=cLQcV3ZF8Y7egSop6sttcbIv1scjYB5YHQXfUvnuoxbJmtOZc4qgHqBSOGuhnfTIyw OckWjNPrK9w7CQ+ev3JRM13GAs4Oegz1HkXLpEuzTzwYsCYvpepyfHiKXYCtyffj6b0a u/XMAaZxzrgtk7uiGKqZzZGTq9lHgll/j7xQAhblcb0t0jjgBRfQ5zIaN4cIVzrOAFBR 6DGl9lfbiy5J1h+/pbPDPE0xN4sM0zUCF4Lvuc5l3WcMsMkkePhRDKRX8QXMtMcPPIdo +I8zYXsMHElSsfumi34JALODYGk7xEUxoV5CQNpXGFfov/6hYwbdoLtfoOrI6/I36u4Y 39og== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:in-reply-to:date:message-id :references:user-agent:reply-to:mail-followup-to:mime-version :content-type; bh=kpL+8Th9WI815hQUPznNulyw0aM1XBaN5ced+YVYjiQ=; b=LqSKh65j031dN0AOdzbQkbAuZZvp1u5VnVNMzBMPG7d1syyotIqoRtbT+1b+RS59Ck lR5LFDjn12F6auAiKIcf6sKQ2Mr1oZuoSyb+HHWb541uMn2Fgxg5YJT9NjM0OF6IPZuQ n1leRFwvummFnAHK0npOhF5LX9PNyUofYIwZXzCzH1d0Nlbo6tJLgVAVu0Xby39xF0fn ccfxeXmynhZo3UN0LKiC9qdOtl99Dzjhgn4wzfcZ4KmF86cCg/SzJRYa7Yzms9lbQyMi E7iAZ1ou3RMuEddNI+YlpeTjxq6e1xSN7nu83T04VFBxb3zmLzE1AFgrnYRskRLiaV2Y v9mg== X-Gm-Message-State: AG10YOSrkdOH/8mt8nuSYco7z/48rWt0BRltNmP8IQysUE/aL1Jzxsq3Bkxc4jHO76Mc1A== X-Received: by 10.66.230.201 with SMTP id ta9mr2411333pac.52.1453448421785; Thu, 21 Jan 2016 23:40:21 -0800 (PST) Original-Received: from Vulcan.local (76-234-68-79.lightspeed.frokca.sbcglobal.net. [76.234.68.79]) by smtp.gmail.com with ESMTPSA id g87sm7433179pfj.1.2016.01.21.23.40.21 (version=TLS1 cipher=AES128-SHA bits=128/128); Thu, 21 Jan 2016 23:40:21 -0800 (PST) X-Google-Original-From: John Wiegley Original-Received: by Vulcan.local (Postfix, from userid 501) id 652CF1258474A; Thu, 21 Jan 2016 23:40:20 -0800 (PST) In-Reply-To: <83twm66qjp.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 22 Jan 2016 09:07:06 +0200") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin) Mail-Followup-To: Eli Zaretskii , michael_heerdegen@web.de, emacs-devel@gnu.org X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c03::231 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:198559 Archived-At: >>>>> Eli Zaretskii writes: >> Given an expression -- in this case, `alist-get' applied to the arguments >> passed to this macro -- find the `setter' that can "modify in place" the >> object returned by that expression, and immediately use it to replace that >> object with the value passed by the caller. > The doc string should explain the arguments, so that should be added to the > text you propose. What I wrote should really be a comment above the code, to explain what it does to human beings. The actual docstring should be along the lines of "Get a value from an alist"... -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2