bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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


From: Hendrik Tews
Subject: bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
Date: Sat, 26 Dec 2020 22:04:00 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux)

Hi,

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

There is a connection to bug#45437, which see.

I agree that it is questionable to go back in time and annotate
all functions with precise information when they had been added.

However, I believe you should
- change your development process such that, in the future, version
  information for functions and variables is recorded
- not ignorantly closing issues such as 45437, when a couple of
  people spent several hours to debug a problem that takes you
  only 5 minutes to fix. Or how long will it take you to add one
  sentence to the documentation of make-temp-file? Or how many
  hours of other people do you want to waste by saving 5 minutes
  on your side?

I now and then contribute to Proof General, which aims to support
about 3 major emacs version. Please advise how one can develop
backward compatible elisp code when the version in the function
documentation is non-present, plain wrong or misleading.

Best regards,

Hendrik





reply via email to

[Prev in Thread] Current Thread [Next in Thread]