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

[John Wiegley]

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