From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'. Date: Tue, 19 Jan 2016 21:17:54 +0200 Message-ID: <83bn8hbcpp.fsf@gnu.org> References: <20160116143238.27391.97533@vcs.savannah.gnu.org> <8737ttx5dm.fsf@web.de> <83oachbgz0.fsf@gnu.org> <87vb6pih39.fsf@web.de> <83h9i9besq.fsf@gnu.org> <87mvs1ieql.fsf@web.de> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1453231093 3897 80.91.229.3 (19 Jan 2016 19:18:13 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 19 Jan 2016 19:18:13 +0000 (UTC) Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Michael Heerdegen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jan 19 20:18:08 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 1aLbn5-0007Sw-GM for ged-emacs-devel@m.gmane.org; Tue, 19 Jan 2016 20:18:07 +0100 Original-Received: from localhost ([::1]:38921 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLbn4-0003fO-Gc for ged-emacs-devel@m.gmane.org; Tue, 19 Jan 2016 14:18:06 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44049) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLbmo-0003fH-Fc for emacs-devel@gnu.org; Tue, 19 Jan 2016 14:17:51 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aLbmk-00028M-EJ for emacs-devel@gnu.org; Tue, 19 Jan 2016 14:17:50 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:36329) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLbmk-00028I-Au; Tue, 19 Jan 2016 14:17:46 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2323 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aLbmj-0008UO-JC; Tue, 19 Jan 2016 14:17:46 -0500 In-reply-to: <87mvs1ieql.fsf@web.de> (message from Michael Heerdegen on Tue, 19 Jan 2016 19:52:18 +0100) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e 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:198383 Archived-At: > From: Michael Heerdegen > Date: Tue, 19 Jan 2016 19:52:18 +0100 > Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org > > > For the record, that doc string almost made me weep in frustration -- > > about my own stupidity, no doubt, since I couldn't make heads or tails > > out of it, when I compared it with the actual code (including studying > > the _only_ use of it in the context of a gv setter, AFAICT). > > Maybe _only_ because few people know about it. The function was added recently, so we should expect it to be relatively unfamiliar. > The problem I want to solve is: Now that assoc.el is obsolete, there is > no replacement for `aput' besides setf'ing alist-get. > > Manipulating alists is a thing sometimes necessary for customizing > Emacs, it is useful for end users. They should not need to study source > code. I added it now to the list in the section that discusses 'setf', which is where we name functions with this property. I very much doubt that this will help advertising this property in any significant way, but at least now we can stop arguing about it, I hope. As an aside, people who are interested in better documentation are welcome to commit changes to the manuals. I only did that humongous job because no one else would, but it's not like I'm the only one who can (or should) do it, you know. IOW, instead of questioning my judgment, by all means simply make the improvements you think are due. Thanks.