[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: Tue, 19 Jan 2016 23:40:47 -0800
User-agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin)

>>>>> Yuri Khan <address@hidden> writes:

> Good documentation advertises relationships between separately
> documented entities at both ends.

No doubt, except when there are many, many-to-many relationships. Too much
information can, at times, obscure the main point.

The use of `setf' is mainly orthogonal to the purpose of `alist-get'. Yes, you
can use them in combination, but so can a lot of other functions with either
of those. We're not going to add all those possibilities to both docstrings.

If setf+alist-get were a primary use case for alist-get, I'd be more
convinced; but it's just one possible combination.

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]