Subject: bug#45438: 27.1; please fix misleading documentation for assoc-delete-all

From: Richard Stallman <[email-masked]>
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)