Subject: bug#35206: [PATCH] Misleading `list-get' argument description

From: Mattias Engdegård <[email-masked]>
Date: Tue, 9 Apr 2019 13:45:34 +0200

> 
> Comparison of KEY against the car of each ALIST element
> is made using TESTFN, or `eq' if nil or omitted.

If no knowledge whatsoever of alists can be assumed on the part of the reader, perhaps this would be better:

   "Return the value associated with KEY in ALIST.
+The value is the cdr of the first element in ALIST whose car is equal to KEY.
 If KEY is not found in ALIST, return DEFAULT.
-Use TESTFN to lookup in the alist if non-nil.  Otherwise, use `assq'.
+Equality is defined by TESTFN or by `eq' if nil or omitted.