From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= Newsgroups: gmane.emacs.bugs Subject: bug#35206: [PATCH] Misleading `list-get' argument description Date: Tue, 9 Apr 2019 16:59:48 +0200 Message-ID: <948BCACD-D6CE-46AD-A31A-82272AB1A077@acm.org> References: <77179D00-DAC7-41E9-BC76-4F0824DC57EF@acm.org> <83ef6b78aa.fsf@gnu.org> <29604A23-C01D-4DE5-9D40-493EAC445056@acm.org> <75D164EF-3F6F-4E45-ADCB-7A6C25DF4453@acm.org> <83a7gz6y1z.fsf@gnu.org> Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.8\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="53166"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 35206-done@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Apr 09 17:00:13 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hDsEP-000DiI-KC for geb-bug-gnu-emacs@m.gmane.org; Tue, 09 Apr 2019 17:00:13 +0200 Original-Received: from localhost ([127.0.0.1]:42896 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hDsEO-00048r-L0 for geb-bug-gnu-emacs@m.gmane.org; Tue, 09 Apr 2019 11:00:12 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:54205) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hDsEG-00047R-Dr for bug-gnu-emacs@gnu.org; Tue, 09 Apr 2019 11:00:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hDsEF-0008KY-CO for bug-gnu-emacs@gnu.org; Tue, 09 Apr 2019 11:00:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:38320) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hDsEF-0008K2-51 for bug-gnu-emacs@gnu.org; Tue, 09 Apr 2019 11:00:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hDsEE-0003xj-U4 for bug-gnu-emacs@gnu.org; Tue, 09 Apr 2019 11:00:02 -0400 Resent-From: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Tue, 09 Apr 2019 15:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 35206 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Mail-Followup-To: 35206@debbugs.gnu.org, mattiase@acm.org, mattiase@acm.org Original-Received: via spool by 35206-done@debbugs.gnu.org id=D35206.155482199415183 (code D ref 35206); Tue, 09 Apr 2019 15:00:02 +0000 Original-Received: (at 35206-done) by debbugs.gnu.org; 9 Apr 2019 14:59:54 +0000 Original-Received: from localhost ([127.0.0.1]:51862 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hDsE6-0003wp-JM for submit@debbugs.gnu.org; Tue, 09 Apr 2019 10:59:54 -0400 Original-Received: from mail151c50.megamailservers.eu ([91.136.10.161]:46030 helo=mail50c50.megamailservers.eu) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hDsE4-0003we-LD for 35206-done@debbugs.gnu.org; Tue, 09 Apr 2019 10:59:53 -0400 X-Authenticated-User: mattiase@bredband.net DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=megamailservers.eu; s=maildub; t=1554821990; bh=OmTq83858+YbYbOF3gCZRHyrcdO699Io6rNZdyzAzI4=; h=Subject:From:In-Reply-To:Date:Cc:References:To:From; b=Lx5CfdOABhsP7EE583a5AhjtIZPsgAJX9x0Z3i8GaEjNq36jxG5fiPlQ5Q0QkpPi2 CYb2yvwrYAjursrgpMLwyDrL8Kr/ogRrmEY7f/lqKwpJu6XEG9JGO2EwhC/5dL6S/r UsFF6STAAY+tojK1WzjVm6D9KAHdN3KxP1y+Sexw= Feedback-ID: mattiase@acm.or Original-Received: from [192.168.1.64] (c-e636e253.032-75-73746f71.bbcust.telenor.se [83.226.54.230]) (authenticated bits=0) by mail50c50.megamailservers.eu (8.14.9/8.13.1) with ESMTP id x39Exmfs014166; Tue, 9 Apr 2019 14:59:50 +0000 In-Reply-To: <83a7gz6y1z.fsf@gnu.org> X-Mailer: Apple Mail (2.3445.104.8) X-CTCH-RefID: str=0001.0A0B020B.5CACB366.005D, ss=1, re=0.000, recu=0.000, reip=0.000, cl=1, cld=1, fgs=0 X-CTCH-VOD: Unknown X-CTCH-Spam: Unknown X-CTCH-Score: 0.000 X-CTCH-Flags: 0 X-CTCH-ScoreCust: 0.000 X-CSC: 0 X-CHA: v=2.3 cv=ILEs9DnG c=1 sm=1 tr=0 a=M+GU/qJco4WXjv8D6jB2IA==:117 a=M+GU/qJco4WXjv8D6jB2IA==:17 a=jpOVt7BSZ2e4Z31A5e1TngXxSK0=:19 a=kj9zAlcOel0A:10 a=mDV3o1hIAAAA:8 a=J_sKoqKBZ7BRS39qZrwA:9 a=CjuIK1q_8ugA:10 a=_FVE-zBwftR9WsbkzFJk:22 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:157421 Archived-At: 9 apr. 2019 kl. 16.41 skrev Eli Zaretskii : >=20 > 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).