GNU bug report logs - #45438
27.1; please fix misleading documentation for assoc-delete-all

Previous Next

Full log

View this message in rfc822 format

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Hendrik Tews <hendrik.tews <at> kernkonzept.com>
Cc: 45438 <at> debbugs.gnu.org
Subject: bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
Date: Fri, 25 Dec 2020 23:32:05 +0100

Hendrik Tews <hendrik.tews <at> kernkonzept.com> writes:

> assoc-delete-all was introduced in emacs 26.2, however,
> describe-function says "Probably introduced at or before Emacs
> version 21.1.". Please fix this to report the right version
> number where assoc-delete-all was introduced. With this kind of
> misleading information, it is very difficult to write code that
> is backward compatible to a number of different emacs major
> versions.

Indeed, but Emacs does not have a history of when functions are
introduced -- we only have guesswork.  Which is why it says "probably".

assoc-delete-all has a convoluted history -- it was introduced in 1999,
and then renamed to assq-delete-all, before being reintroduced in 2018
again.  Here the guesser guesses wrong.

Closing.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.