Subject: bug#23548: closed (Re: bug#23548: 25.0.93; lists.texi (alist-get): Document optional arg 'remove'.)

From: [email-masked] (GNU bug Tracking System)
Date: Wed, 08 Jun 2016 00:01:03 +0000

Your bug report

#23548: 25.0.93; lists.texi (alist-get): Document optional arg 'remove'.

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
23548: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=23548
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#23548: 25.0.93; lists.texi (alist-get): Document optional arg 'remove'.
From: Glenn Morris <[email-masked]>
To: [email-masked]
Date: Tue, 07 Jun 2016 20:00:27 -0400
List-Id: <debbugs-submit.debbugs.gnu.org>

Version: 25.1

Thanks; I tweaked the docs.

Subject: 25.0.93; lists.texi (alist-get): Document optional arg 'remove'.
From: Tino Calancha <[email-masked]>
To: [email-masked]
Date: Mon, 16 May 2016 23:13:35 +0900 (JST)
List-Id: <debbugs-submit.debbugs.gnu.org>

* 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 <[email-masked]>
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