Subject: Re: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual

From: Stephen Berman <[email-masked]>
Date: Thu, 20 Oct 2016 01:39:15 +0200

On Wed, 19 Oct 2016 21:12:00 +0300 Eli Zaretskii <[email-masked]> wrote:

>> From: [email-masked] (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