emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Docu


From: Eli Zaretskii
Subject: Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'.
Date: Fri, 22 Jan 2016 09:07:06 +0200

> From: John Wiegley <address@hidden>
> Cc: address@hidden,  address@hidden
> Date: Thu, 21 Jan 2016 16:56:06 -0800
> 
> >>>>> Eli Zaretskii <address@hidden> writes:
> 
> >> > (defmacro alist-put (key value place &optional default remove)
> >> >   (gv-letplace (_ setter) `(alist-get ,key ,place ,default ,remove)
> >> >     (funcall setter value)))
> >> 
> >> Not without a decent doc string.
> 
> 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.

The doc string should explain the arguments, so that should be added
to the text you propose.

Thanks.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]