[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#35206: [PATCH] Misleading `list-get' argument description
From: |
Mattias Engdegård |
Subject: |
bug#35206: [PATCH] Misleading `list-get' argument description |
Date: |
Tue, 9 Apr 2019 16:59:48 +0200 |
9 apr. 2019 kl. 16.41 skrev Eli Zaretskii <eliz@gnu.org>:
>
> Find an element of ALIST whose `car' equals KEY and return its `cdr'.
> ...
> Equality with KEY is tested by TESTFN, defaulting to `eq'.
Thank you, I pushed that change (except that I used "the first element" instead
of "an element" for precision).
> IMO, this isn't about assuming knowledge, this is about being as
> explicit as reasonably possible about what the function does.
> (Strictly speaking, both your suggestion and mine still assume some
> knowledge about alists, because we never explain what is an alist, nor
> what is an "element" of an alist.)
That's all right -- I was mainly concerned with the quite misleading TESTFN
description, and looked at the docs of similar functions (assq, assoc).