From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Stephen Berman Newsgroups: gmane.emacs.bugs Subject: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual Date: Thu, 20 Oct 2016 10:10:06 +0200 Message-ID: <87shrrzbj5.fsf@rub.de> References: <87k2d4xog0.fsf@wme03370.wme.owhc.net> <83d1iwus27.fsf@gnu.org> <87funrq57g.fsf@gmx.net> <83shrrtq8f.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1476951094 4273 195.159.176.226 (20 Oct 2016 08:11:34 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 20 Oct 2016 08:11:34 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) Cc: a.lloyd.flanagan@gmail.com, 24740@debbugs.gnu.org, Stephen Berman To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Oct 20 10:11:30 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx8RY-0007Ia-SO for geb-bug-gnu-emacs@m.gmane.org; Thu, 20 Oct 2016 10:11:16 +0200 Original-Received: from localhost ([::1]:53098 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bx8Ra-0006wn-Th for geb-bug-gnu-emacs@m.gmane.org; Thu, 20 Oct 2016 04:11:18 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33033) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bx8RS-0006lW-Sb for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2016 04:11:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bx8RK-00044c-AT for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2016 04:11:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:34127) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1bx8RK-00044Y-7F for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2016 04:11:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bx8RK-0001wv-2M for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2016 04:11:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stephen Berman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 Oct 2016 08:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24740 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 24740-submit@debbugs.gnu.org id=B24740.14769510177435 (code B ref 24740); Thu, 20 Oct 2016 08:11:02 +0000 Original-Received: (at 24740) by debbugs.gnu.org; 20 Oct 2016 08:10:17 +0000 Original-Received: from localhost ([127.0.0.1]:40317 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx8Qb-0001vr-9h for submit@debbugs.gnu.org; Thu, 20 Oct 2016 04:10:17 -0400 Original-Received: from mout.gmx.net ([212.227.17.21]:59192) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx8QZ-0001vd-C2 for 24740@debbugs.gnu.org; Thu, 20 Oct 2016 04:10:15 -0400 Original-Received: from rosalinde ([89.245.121.151]) by mail.gmx.com (mrgmx101) with ESMTPSA (Nemesis) id 0LzGV3-1d1Q9p0l0r-014Rwv; Thu, 20 Oct 2016 10:10:08 +0200 In-Reply-To: <83shrrtq8f.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 20 Oct 2016 10:49:04 +0300") X-Provags-ID: V03:K0:0SLRD8EZkLsjrKCNvKv2GOB49snKGUU0fdEhOPo8ddeHm8F3iSd feCvdp27Ck7d4cfpCwmghnt7uhKXGldsA5uM8pe8/e8JcvW7u7D8VVdGkXe+rPgJTjY8yqk ClYlWAylFpKep6rNgQ6YruYZfzebkHZl2PA/xXuNd7V8i02D5kVnZ0AtQWPqpA/nRLbVkFU dtKF0DDc79hccAJOEl8gA== X-UI-Out-Filterresults: notjunk:1;V01:K0:hh0CCHWf2VU=:e2kBNp2T9ALiIAE0sBzg29 Y6yGJh0xkciIFokH/9cf0wIbgAbLahsshggqtmrVjuicHetVmogIcbwQSGVfrNvZle44PqWo/ Daas+v9OFP0z0Ss+f/bfV+4FNCTIBzof5c9SlC7iDhuhDMSeRgTvNcF4tv3sW/nvDQj4vj6I9 lz5HxDqx3pJeQWOszdXzis3G2ef4Z1OJ11q4abQDpX+WY7BygLBEN+9qeiA0IfAfj10ksUOhV jIfNwAcMvU7XMmae/i4aP0R4AnFOpplj8uualxANK+xjbr78lXZeG9YV5eq3ZIy3+ecC1OOv3 REgMjhpp3Z7vHlhE9/eqhglZ+Pbb132b8HNqrpDMWDMPkSyL4DNVsrkVKjh89nEMvh05bnAbm N/0bBVG3ldxZ9CbrNRmrpLo24SWT5+MlmFaP6RufQL+kbz2oSWInrH1qy5nPUvT2rtP2Ra0F7 Ml+W9lGXNgG5H+d93iV2gazfO8D5ZVFu474gOnUD5xzSB7zOpkR6mCnbIlQw5Gxy2e0/nBEJ9 Axku+wEVZ4zOl9FDLkPOCyj5eY4S8Owq6pVWYcMLd4XWLjZaDV0mJEYdP95Db0eamCeKC3glv ZwXG+p8Z2WoMfHpezDO3hpbZnzRXKQbJZlyeDBQ9X/lbzZSJ1xCgmZoErfJVuGo5gl5Sl8OYH XdlOtUgknmOFoUb/1QEcAT2SCFXnYfQnoUsbmU4g2JYH4uoVDpl3xeMJWIGugibsUkUWJyH57 mvdla8fzO1v89iwcBFYZzZQsGih8zZlG3VooKElYW07N/vyeidiXUANoRq/GOKynnIRIXuAE 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: 208.118.235.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:124719 Archived-At: On Thu, 20 Oct 2016 10:49:04 +0300 Eli Zaretskii wrote: >> From: Stephen Berman >> Cc: eliz@gnu.org, a.lloyd.flanagan@gmail.com >> Date: Thu, 20 Oct 2016 01:39:15 +0200 >> >> > -@defun alist-get key value &optional default remove >> > +@defun alist-get key alist &optional default remove >> > This function is like @code{assq}, but instead of returning the entire >> > -association for @var{key}, @code{(@var{key} . @var{value})}, it >> > -returns just the @var{value}. If @var{key} is not found in >> > -@var{alist} it returns @var{default}. >> > +association for @var{key} in @var{alist}, >> > +@w{@code{(@var{key} . @var{value})}}, it returns just the @var{value}. >> ^^^^^^^^^^^ >> > +If @var{key} is not found in @var{alist}, it returns @var{default}. >> >> Shouldn't the text be "it returns just the value", i.e. without the >> markup, since `value' is no longer a formal argument of the function >> signature? > > @var is not only for formal arguments, it's for any symbol which > stands for something else. That is why @var is also used in the cons > cell description; it is not because KEY and VALUE happen to appear in > the function argument list. Ok, thanks for the clarification. I think the distinction would be made clearer if the definite article were omitted: "it returns just VALUE", as it is in the subsequent sentence; the definite article makes it sound to me more like a use than a mention. Steve Berman