Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'.

[Michael Heerdegen]

Eli Zaretskii <address@hidden> writes:

> branch: emacs-25
> commit 2460cfac091c6a5b095816bef9e639f9da88f432
> Author: Eli Zaretskii <address@hidden>
> Commit: Eli Zaretskii <address@hidden>
>
>     * doc/lispref/lists.texi (Association Lists): Document 'alist-get'.
> ---
>  doc/lispref/lists.texi |    8 ++++++++
>  etc/NEWS               |    1 +
>  2 files changed, 9 insertions(+), 0 deletions(-)
>
> diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi
> index d961caf..c18c408 100644
> --- a/doc/lispref/lists.texi
> +++ b/doc/lispref/lists.texi
> @@ -1556,6 +1556,14 @@ keys may not be symbols:
>  @end smallexample
>  @end defun
>  
> address@hidden alist-get key value &optional default
> +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}.  It returns @var{default} if @var{key}
> +is not found in @var{alist}, defaulting to @code{nil} if @var{default}
> +is omitted.
> address@hidden defun
> +

Should we add that it is also a valid place expression ("setf'able")?  Or
to the docstring?  That fact doesn't seem to be discoverable at all now.


Thanks,

Michael.