[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 23:39:57 -0800
User-agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin)

>>>>> Eli Zaretskii <address@hidden> writes:

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

What I wrote should really be a comment above the code, to explain what it
does to human beings. The actual docstring should be along the lines of "Get a
value from an alist"...

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]