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:46:23 +0200 Message-ID: <838u3lbbe8.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> <83bn8hbcpp.fsf@gnu.org> <87a8o1ics6.fsf@web.de> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1453232788 521 80.91.229.3 (19 Jan 2016 19:46:28 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 19 Jan 2016 19:46:28 +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:46:27 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 1aLcES-0002QJ-Ds for ged-emacs-devel@m.gmane.org; Tue, 19 Jan 2016 20:46:24 +0100 Original-Received: from localhost ([::1]:39004 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLcER-0005uG-Te for ged-emacs-devel@m.gmane.org; Tue, 19 Jan 2016 14:46:23 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52753) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLcEO-0005ty-7D for emacs-devel@gnu.org; Tue, 19 Jan 2016 14:46:21 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aLcEJ-0001DZ-Kl for emacs-devel@gnu.org; Tue, 19 Jan 2016 14:46:20 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:36840) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLcEJ-0001DL-Gz; Tue, 19 Jan 2016 14:46:15 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2354 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aLcEI-0000Rf-P7; Tue, 19 Jan 2016 14:46:15 -0500 In-reply-to: <87a8o1ics6.fsf@web.de> (message from Michael Heerdegen on Tue, 19 Jan 2016 20:34:33 +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:198387 Archived-At: > From: Michael Heerdegen > Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org > Date: Tue, 19 Jan 2016 20:34:33 +0100 > > I really wanted to discuss it, not that you just make some change. (I made the change because John asked for it.) If you want to discuss this, then I'm not sure I'm the one you should discuss this with. I never use alist-get in any of my code; the only reason I know about its existence is because it was marked undocumented in NEWS, and I went through NEWS as part of finishing the documentation for v25.1. If you ask my opinion as someone who writes documentation quite a lot, then I don't think we can do _anything_ in the manual to make this feature of this particular function more discoverable. With the size of the manual we have, you have to _know_ what you are looking for to find it quickly. > I still think the typical Emacs user will ask himself: "Where is > alist-put?". Don't you think (info "(elisp) Association Lists") should > answer this question? IME, the best way to answer such questions is to add alist-put.