From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Tino Calancha Newsgroups: gmane.emacs.bugs Subject: bug#23548: 25.0.93; lists.texi (alist-get): Document optional arg 'remove'. Date: Mon, 16 May 2016 23:13:35 +0900 (JST) Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; format=flowed; charset=US-ASCII X-Trace: ger.gmane.org 1463407890 4265 80.91.229.3 (16 May 2016 14:11:30 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 16 May 2016 14:11:30 +0000 (UTC) To: 23548@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon May 16 16:11:15 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1b2JEk-0001g9-VF for geb-bug-gnu-emacs@m.gmane.org; Mon, 16 May 2016 16:11:11 +0200 Original-Received: from localhost ([::1]:44056 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2JEk-0004zK-AO for geb-bug-gnu-emacs@m.gmane.org; Mon, 16 May 2016 10:11:10 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38681) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2JEg-0004xc-V8 for bug-gnu-emacs@gnu.org; Mon, 16 May 2016 10:11:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b2JEb-0004xx-Rq for bug-gnu-emacs@gnu.org; Mon, 16 May 2016 10:11:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:41511) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2JEb-0004xr-OX for bug-gnu-emacs@gnu.org; Mon, 16 May 2016 10:11:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1b2JEb-0005Ux-LF for bug-gnu-emacs@gnu.org; Mon, 16 May 2016 10:11:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Tino Calancha Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 May 2016 14:11:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 23548 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.146340783421098 (code B ref -1); Mon, 16 May 2016 14:11:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 16 May 2016 14:10:34 +0000 Original-Received: from localhost ([127.0.0.1]:53848 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1b2JE9-0005UE-Sn for submit@debbugs.gnu.org; Mon, 16 May 2016 10:10:34 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:47669) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1b2JE9-0005U3-0x for submit@debbugs.gnu.org; Mon, 16 May 2016 10:10:33 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b2JDz-0004pO-SS for submit@debbugs.gnu.org; Mon, 16 May 2016 10:10:27 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:43874) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2JDz-0004pE-Ou for submit@debbugs.gnu.org; Mon, 16 May 2016 10:10:23 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38604) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2JDx-0004ZY-Pa for bug-gnu-emacs@gnu.org; Mon, 16 May 2016 10:10:22 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b2JDt-0004nh-FZ for bug-gnu-emacs@gnu.org; Mon, 16 May 2016 10:10:20 -0400 Original-Received: from calancha-ilc.kek.jp ([130.87.234.234]:60076) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2JDt-0004nE-5Q for bug-gnu-emacs@gnu.org; Mon, 16 May 2016 10:10:17 -0400 Original-Received: by calancha-ilc.kek.jp (Postfix, from userid 500) id 2A1F55942; Mon, 16 May 2016 23:13:35 +0900 (JST) Original-Received: from localhost (localhost [127.0.0.1]) by calancha-ilc.kek.jp (Postfix) with ESMTP id 110815530 for ; Mon, 16 May 2016 23:13:35 +0900 (JST) X-X-Sender: calancha@calancha-ilc.kek.jp User-Agent: Alpine 2.20 (LRH 67 2015-01-07) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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: 208.118.235.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:118283 Archived-At: * doc/lispref/lists.texi (alist-get): Document optional arg. 'remove'. Rename second argument to 'alist'. In GNU Emacs 25.0.93.3 (x86_64-pc-linux-gnu, GTK+ Version 2.24.30) Repository revision: 6de0715f5467d4b925e2dfe082174529ace3b174 >From 23f7df037e23c867cfa0090936c9f974e6e83175 Mon Sep 17 00:00:00 2001 From: Tino Calancha Date: Mon, 16 May 2016 23:01:14 +0900 Subject: [PATCH] ; * lists.texi (alist-get): Document optional arg 'remove'. --- doc/lispref/lists.texi | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi index c18c408..7d411af 100644 --- a/doc/lispref/lists.texi +++ b/doc/lispref/lists.texi @@ -1556,12 +1556,17 @@ Association Lists @end smallexample @end defun -@defun alist-get key value &optional default +@defun alist-get key alist &optional default remove This function is like @code{assq}, but instead of returning the entire association for @var{key}, @code{(@var{key} . @var{value})}, it returns just the @var{value}. It returns @var{default} if @var{key} is not found in @var{alist}, defaulting to @code{nil} if @var{default} is omitted. + +When using this function to set the value at @var{key} +to @var{new-val}, if @var{remove} evaluates non-@code{nil} and +@var{default} is @code{eql} to @var{new-val}, then the entry at +@var{key} is deleted. @end defun @defun rassq value alist -- 2.8.1