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

Previous Next

Full log

Message #15 received at 45438 <at> debbugs.gnu.org (full text, mbox):

From: Richard Stallman <rms <at> gnu.org>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: hendrik.tews <at> kernkonzept.com, 45438 <at> debbugs.gnu.org
Subject: Re: bug#45438: 27.1;
 please fix misleading documentation for assoc-delete-all
Date: Sat, 26 Dec 2020 05:28:00 -0500

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

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

Every new function is listed in the ChangeLog files.
_We_ know when it was introduced.

What this means

  > > assoc-delete-all was introduced in emacs 26.2, however,
  > > describe-function says "Probably introduced at or before Emacs
  > > version 21.1.".

is that the data that describe-function consults does not have all the
information that we have.

Whether it is worth doing the work to make it better, I have no
opinion.  Maybe it is better to do other work instead.

-- 
Dr Richard Stallman
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)

Previous Next

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