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

[John Wiegley]

>>>>> 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.

Syntactical it's unfortunate, given what it's trying to do. `gv-letplace'
could use another name...

-- 
John Wiegley                  GPG fingerprint = 4710 CF98 AF9B 327B B80F
http://newartisans.com                          60E1 46C4 BD1A 7AC1 4BA2