From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.devel Subject: Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'. Date: Fri, 22 Jan 2016 12:58:19 +0100 Message-ID: <874me5g71g.fsf@web.de> 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> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1453463933 9806 80.91.229.3 (22 Jan 2016 11:58:53 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 22 Jan 2016 11:58:53 +0000 (UTC) Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jan 22 12:58:45 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 1aMaMV-0003Fd-Op for ged-emacs-devel@m.gmane.org; Fri, 22 Jan 2016 12:58:43 +0100 Original-Received: from localhost ([::1]:52875 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMaMV-0003kQ-9x for ged-emacs-devel@m.gmane.org; Fri, 22 Jan 2016 06:58:43 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50126) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMaMD-0003hn-1R for emacs-devel@gnu.org; Fri, 22 Jan 2016 06:58:25 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aMaM9-0004Cw-TO for emacs-devel@gnu.org; Fri, 22 Jan 2016 06:58:25 -0500 Original-Received: from mout.web.de ([212.227.15.14]:60822) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMaM9-0004CX-Kp; Fri, 22 Jan 2016 06:58:21 -0500 Original-Received: from drachen.dragon ([92.77.162.209]) by smtp.web.de (mrweb002) with ESMTPSA (Nemesis) id 0LaTpn-1ZhmZ12DMt-00mIwn; Fri, 22 Jan 2016 12:58:20 +0100 In-Reply-To: (John Wiegley's message of "Thu, 21 Jan 2016 16:56:06 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-Provags-ID: V03:K0:6ShK5zzkLxx84yk1OqYKybp1SrFtN1k+VwOVrL2TLapC4tUNT3B 1u9568wzXiYrtyTZNMlA4EtwPi3MZ8zkiAB2LKGAndFyZ8vFdPWMTNq6Rto+0pnreki0HLW lObJOXp/yH+k23pPyvcl5dSwBGFy/5svl1HQLGmq2YAerkKY+Q6pUaNrqz2sKgLECXyXZJ9 A8ZhKiu+zkaMlZgq6PcyQ== X-UI-Out-Filterresults: notjunk:1;V01:K0:Md9jSf3CUlU=:SnIUMoq9Da9Sw6/nOlCW9w L0taNmpnyvbYsBEMZGIMdsFXRQvQLXd0xOffDYHrb1D87Jih3Ov/eXSW9kZg+rGqt+ZHO9naB ZLrtVhMLjr7LoYOuP0raywQlMMtd7FKACgCydr4/VF/droHn+Lp4uC5O8prN5TYmo2pOfNgRq leKwWp4uKSb85frH3spz7eG43qyJcxmw1jgJV2ZsF2c0ULA+FyXu7Mnl54Ki6FG1jAon/g6wA 3TBTUjD/cYfv9Z72TUw08JnO2jzQ0PuEHfKSjshxT5eNzUU/QL9Ob6HSCHtsaGTOGdw3e/N6o a1Ljb+i7XzYIYClG+FZjRORW61C5MKLGe72w/B/rVljrbZ3i2EWVf5BjIbmzWTyRK4A7Xqj7V giGvqstFbFj/flIi4wE6+dnC8sqOZpODl+TEXCVs147wlXMZb3ddFOKMpQaGUbL2CLypHPvUl 5rNz1Cgubi8+xS3CMQ34lCZfzRZnvgPS7jXXy5ELQ+o0WCxKyxEqsETQf/xAjMJO44+Jv9QAr rmHXgzOjOM6A5jLPvUchDD5a39546G2qmz28WiGXg2cwKiQeNV/fpaqS6q8M2qrGM26zGui9A uSxZsvTRKhf+1yNc+0Kk/nrP0FtmF1zb46lGKi+4mV2wTN4+BMIVuTRJ+Jw1rgJEDaxBO+Vap 1EAqtS0vpWBunM6qKfuXfJm3Mt+19als5W7ZwJfHCOxiZO1IxQ/MnGpfo+poyaePbaiyCnizW XoGen2dOk6OrEpisvVvTmkBjYFnOP/bwqEQ6pO7GQVaaaeTIR+6ljjjXXwLusmGG38TjkvGu X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 212.227.15.14 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:198574 Archived-At: John Wiegley writes: > >> > (defmacro alist-put (key value place &optional default remove) > >> > (gv-letplace (_ setter) `(alist-get ,key ,place ,default ,remove) > >> > (funcall setter value))) > I hear you. For that code above, the comment would be: > > 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. Not quite, or at least imprecise: SETTER is a function that is called with an expression, and returns the code that does what you describe. Note that there is no backquote used in the above definition of `alist-put'. So, strictly speaking, the name "setter" is not 100% correct. Michael.