From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'. Date: Tue, 19 Jan 2016 23:40:47 -0800 Message-ID: References: <20160116143238.27391.97533@vcs.savannah.gnu.org> <8737ttx5dm.fsf@web.de> <83oachbgz0.fsf@gnu.org> Reply-To: John Wiegley NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1453275677 23808 80.91.229.3 (20 Jan 2016 07:41:17 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 20 Jan 2016 07:41:17 +0000 (UTC) Cc: Michael Heerdegen , Eli Zaretskii , Emacs developers To: Yuri Khan Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jan 20 08:41:07 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aLnO6-0000BW-8d for ged-emacs-devel@m.gmane.org; Wed, 20 Jan 2016 08:41:06 +0100 Original-Received: from localhost ([::1]:40721 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLnO0-00065P-Jv for ged-emacs-devel@m.gmane.org; Wed, 20 Jan 2016 02:41:00 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51430) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLnNw-00064n-9W for emacs-devel@gnu.org; Wed, 20 Jan 2016 02:40:57 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aLnNv-0006Q7-8m for emacs-devel@gnu.org; Wed, 20 Jan 2016 02:40:56 -0500 Original-Received: from mail-pf0-x236.google.com ([2607:f8b0:400e:c00::236]:33982) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLnNr-0006Ph-BA; Wed, 20 Jan 2016 02:40:51 -0500 Original-Received: by mail-pf0-x236.google.com with SMTP id q63so456341pfb.1; Tue, 19 Jan 2016 23:40:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:reply-to:mail-followup-to:mime-version:content-type; bh=KGoHrDvc+kjFMFoUxFf5zd7WBVvYafMtFo6vquEYnkw=; b=FKeR0W1J4o2JbPaBNHWEc3+V17SDjPLUuxJpJJvjY0eI4WOFLgja2sChetFqJsBDzU 95UTt7bsyEk0NGgYPM0n6xE84G2sF+l0QDGvtO+V31zekNt4WuqRzqIe9khORUtKH0EU SR8CX2cb9rasDNyllQW+reH8/8CP/RuYx3F2yh0mFDCW+tHsqvkB0bvJuCzAf32sjYrN YVZjUIhqSuzUkKmzrA2rLGUMXXxElEk768zbTzpqivX8T0BUQcc6qmtzxTcOdYnHHBwQ 88lgxVPrBg5oCbSxrbvMLfcdedjisfLQ17oGlob5qPD60zBEF4YhnHdkLVgbgQrDMuox abtA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:in-reply-to:date:message-id :references:user-agent:reply-to:mail-followup-to:mime-version :content-type; bh=KGoHrDvc+kjFMFoUxFf5zd7WBVvYafMtFo6vquEYnkw=; b=Cec7kxenijbR/xiCREHtmw1nTrupCG9G+PfgF3K//csN9M42kjeLX7TV01QXYtsiM3 ripkDC98qwFUXud9qWe6IxBRQyd3yjm1drimdMpDu/R5eGsCmH0wP4Dh1EIvMOHOSoqb taZM9ifzlYVB0z98L7I03KdV8SIq2eCfP4AjU/TJDvmNO92YF2IrBfXV7LTJ5bSLDxec VFqmrgQlRETlxxUXoCuk0bjLWYlu+XYb2pXLHRqzsjFOFllp67dXEniJOPyS16vGzkRC ne9KEka+zJFIZaN4tGMP7XPy2VrwCEqYhBsMV30prRKCDLUeSvp+sL9JHc+u42wfBDE2 4B9g== X-Gm-Message-State: ALoCoQla8zjnQTD3+aSy30W5dgTNv/plv/n64QQE8y+pSiJ7/X83FfHGD8Pw7pkoJi5WJbNSQKfsi98boHMK5aTEJ22EAhLbng== X-Received: by 10.98.66.74 with SMTP id p71mr50533106pfa.105.1453275650463; Tue, 19 Jan 2016 23:40:50 -0800 (PST) Original-Received: from Vulcan.local (76-234-68-79.lightspeed.frokca.sbcglobal.net. [76.234.68.79]) by smtp.gmail.com with ESMTPSA id v71sm46352351pfi.91.2016.01.19.23.40.49 (version=TLS1 cipher=AES128-SHA bits=128/128); Tue, 19 Jan 2016 23:40:49 -0800 (PST) X-Google-Original-From: John Wiegley Original-Received: by Vulcan.local (Postfix, from userid 501) id B7D27124FE520; Tue, 19 Jan 2016 23:40:48 -0800 (PST) In-Reply-To: (Yuri Khan's message of "Wed, 20 Jan 2016 13:31:08 +0600") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin) Mail-Followup-To: Yuri Khan , Eli Zaretskii , Michael Heerdegen , Emacs developers X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c00::236 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:198418 Archived-At: >>>>> Yuri Khan 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