[Top][All Lists]

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

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

From: John Wiegley
Subject: Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'.
Date: Thu, 21 Jan 2016 16:56:06 -0800
User-agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin)

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

reply via email to

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