[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
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., (continued)
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Eli Zaretskii, 2016/01/19
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., John Wiegley, 2016/01/19
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Michael Heerdegen, 2016/01/20
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Stefan Monnier, 2016/01/20
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Michael Heerdegen, 2016/01/20
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Stefan Monnier, 2016/01/20
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Michael Heerdegen, 2016/01/21
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Eli Zaretskii, 2016/01/21
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Eli Zaretskii, 2016/01/21
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Michael Heerdegen, 2016/01/21
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'.,
John Wiegley <=
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Eli Zaretskii, 2016/01/22
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., John Wiegley, 2016/01/22
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Michael Heerdegen, 2016/01/22
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., John Wiegley, 2016/01/22
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Michael Heerdegen, 2016/01/22
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Michael Heerdegen, 2016/01/22
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., John Wiegley, 2016/01/22
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Richard Stallman, 2016/01/22
- Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Michael Heerdegen, 2016/01/22
- RE: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'., Drew Adams, 2016/01/19