From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: "A. Lloyd Flanagan" Newsgroups: gmane.emacs.bugs Subject: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual Date: Thu, 20 Oct 2016 01:00:15 +0000 Message-ID: References: <87k2d4xog0.fsf@wme03370.wme.owhc.net> <83d1iwus27.fsf@gnu.org> <87funrq57g.fsf@gmx.net> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=001a114a94887c2e52053f4173e8 X-Trace: blaine.gmane.org 1476925284 29413 195.159.176.226 (20 Oct 2016 01:01:24 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 20 Oct 2016 01:01:24 +0000 (UTC) To: Stephen Berman , 24740@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Oct 20 03:01:18 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 1bx1jL-0005uz-Kf for geb-bug-gnu-emacs@m.gmane.org; Thu, 20 Oct 2016 03:01:11 +0200 Original-Received: from localhost ([::1]:51778 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bx1jN-0007p0-SN for geb-bug-gnu-emacs@m.gmane.org; Wed, 19 Oct 2016 21:01:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58281) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bx1jI-0007nu-8t for bug-gnu-emacs@gnu.org; Wed, 19 Oct 2016 21:01:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bx1jD-0002ml-Is for bug-gnu-emacs@gnu.org; Wed, 19 Oct 2016 21:01:08 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:33989) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1bx1jD-0002mT-Fi for bug-gnu-emacs@gnu.org; Wed, 19 Oct 2016 21:01:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bx1jC-00005n-DQ for bug-gnu-emacs@gnu.org; Wed, 19 Oct 2016 21:01:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "A. Lloyd Flanagan" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 Oct 2016 01:01: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.1476925234314 (code B ref 24740); Thu, 20 Oct 2016 01:01:02 +0000 Original-Received: (at 24740) by debbugs.gnu.org; 20 Oct 2016 01:00:34 +0000 Original-Received: from localhost ([127.0.0.1]:40179 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx1ik-00004y-6s for submit@debbugs.gnu.org; Wed, 19 Oct 2016 21:00:34 -0400 Original-Received: from mail-qk0-f178.google.com ([209.85.220.178]:34806) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx1ii-0008WM-1z for 24740@debbugs.gnu.org; Wed, 19 Oct 2016 21:00:32 -0400 Original-Received: by mail-qk0-f178.google.com with SMTP id f128so63940492qkb.1 for <24740@debbugs.gnu.org>; Wed, 19 Oct 2016 18:00:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=DKAyGnyCmeFYwYkVpWExvHlizDZp4DO6FPINe/qw/Yk=; b=Q9Z1qA4Ovz1BZh2lzLOzduZf3n2O4Hmh9/b5eHm4tAfpsz2PUFWFSEQmBwLG0O1YWI G0otMJlW+kgtW5XkAlYeL+LI0pPAjK0L2FnTGjHjXJffYE7lBfr83Ao50NDWmZITySrd azr5isxNcORO65fhR3gL7Drholy7szC7hVCXQAzO2+mrw03Ydp4ZwU5q5UQHEh2LLKiE lun0WHGlYZYB4JREN2sRLBCkQeBK+HABIhi28ysdpllb5qi60YAcLBLIIPvqeoVn7wIh 8baLRRMkzCn8dbkVvvzWS1kK8AhUyrKPBy/BQ2dlr4+9sKLeWoEF3pKL4q2QaEK9lqvu ceaA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=DKAyGnyCmeFYwYkVpWExvHlizDZp4DO6FPINe/qw/Yk=; b=iG2Ds+s8lhDhrQ/57bQPsnhO00bPiYbHdcbhFG27XEzTHUsdFon8i7AMOVbOoAhteq iUTvggdZUU/iJkraK5DYEbxuLUodEd7JBktprgZ2KvyXtssRRALdlttfRwYnGNBoCJHo SMr7pK95K4YzWUnth4/kKHnxOAfNEznvsYmH+AWEvspz7Z6TK+cNOQZr1/Z8G3hY1gHr BjAi+EYXjnMlVBO5Qhl/XOjaUE9rIXyKeZuWACxU8xXM/3cR1/OTEfxjLyDcdcD3TP4u Pem0AbPOrlrJm6IaHo4yuDR41Eo3VMVMOLPqnrSmGl8vC+TYu1P/eJ6BtHYiuaWEXshT Y0Sg== X-Gm-Message-State: ABUngvfNwF2fClHHPSSNxnIydGcfpUlPnVxUkH00iD6i2R7UYZ3ceaUkaWGq3Mt8PhDbvzU6ljLjtq4GtJTreg== X-Received: by 10.55.75.215 with SMTP id y206mr8835157qka.26.1476925226493; Wed, 19 Oct 2016 18:00:26 -0700 (PDT) In-Reply-To: <87funrq57g.fsf@gmx.net> 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:124702 Archived-At: --001a114a94887c2e52053f4173e8 Content-Type: text/plain; charset=UTF-8 Yes, good catch. On Wed, Oct 19, 2016, 7:39 PM Stephen Berman wrote: > On Wed, 19 Oct 2016 21:12:00 +0300 Eli Zaretskii wrote: > > >> From: a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan) > >> Date: Wed, 19 Oct 2016 13:01:51 -0400 > >> > >> In the elisp manual, section "Association Lists", the function alist-get > >> is shown with the signature: > >> > >> Function: alist-get key value &optional default remove > >> > >> but it should be > >> > >> Function: alist-get key alist &optional default remove > > > > Thanks, fixed on the emacs-25 branch. > > > > -@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? > > Steve Berman > -- "They have computers, and they may have other weapons of mass destruction." -- Janet Reno --001a114a94887c2e52053f4173e8 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
Yes, good catch.

On Wed, Oct 19, 2016= , 7:39 PM Stephen Berman <step= hen.berman@gmx.net> wrote:
O= n Wed, 19 Oct 2016 21:12:00 +0300 Eli Zaretskii <eliz@gnu.org> wrote:<= br class=3D"gmail_msg">
>> From: a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan)<= br class=3D"gmail_msg"> >> Date: Wed, 19 Oct 2016 13:01:51 -0400
>>
>> In the elisp manual, section "Association Lists", the fu= nction alist-get
>> is shown with the signature:
>>
>> Function: alist-get key value &optional default remove
>>
>> but it should be
>>
>> Function: alist-get key alist &optional default remove
>
> Thanks, fixed on the emacs-25 branch.


> -@defun alist-get key value &optional default remove
> +@defun alist-get key alist &optional default remove
>=C2=A0 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}.=C2=A0 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}= .
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0^^^^^^= ^^^^^
> +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. witho= ut the
markup, since `value' is no longer a formal argument of the function signature?

Steve Berman
--
"They have computers, and they may have= other weapons of mass destruction." -- Janet Reno
--001a114a94887c2e52053f4173e8--