* bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
@ 2020-12-25 22:13 Hendrik Tews
2020-12-25 22:32 ` Lars Ingebrigtsen
0 siblings, 1 reply; 11+ messages in thread
From: Hendrik Tews @ 2020-12-25 22:13 UTC (permalink / raw)
To: 45438
Hi,
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.
Thanks,
Hendrik
^ permalink raw reply [flat|nested] 11+ messages in thread
* bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
2020-12-25 22:13 bug#45438: 27.1; please fix misleading documentation for assoc-delete-all Hendrik Tews
@ 2020-12-25 22:32 ` Lars Ingebrigtsen
2020-12-26 10:28 ` Richard Stallman
2020-12-26 21:17 ` Hendrik Tews
0 siblings, 2 replies; 11+ messages in thread
From: Lars Ingebrigtsen @ 2020-12-25 22:32 UTC (permalink / raw)
To: Hendrik Tews; +Cc: 45438
Hendrik Tews <hendrik.tews@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
^ permalink raw reply [flat|nested] 11+ messages in thread
* bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
2020-12-25 22:32 ` Lars Ingebrigtsen
@ 2020-12-26 10:28 ` Richard Stallman
2020-12-26 10:58 ` Eli Zaretskii
2020-12-26 21:04 ` Hendrik Tews
2020-12-26 21:17 ` Hendrik Tews
1 sibling, 2 replies; 11+ messages in thread
From: Richard Stallman @ 2020-12-26 10:28 UTC (permalink / raw)
To: Lars Ingebrigtsen; +Cc: hendrik.tews, 45438
[[[ 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)
^ permalink raw reply [flat|nested] 11+ messages in thread
* bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
2020-12-26 10:28 ` Richard Stallman
@ 2020-12-26 10:58 ` Eli Zaretskii
2020-12-26 21:56 ` Lars Ingebrigtsen
2020-12-27 5:38 ` Richard Stallman
2020-12-26 21:04 ` Hendrik Tews
1 sibling, 2 replies; 11+ messages in thread
From: Eli Zaretskii @ 2020-12-26 10:58 UTC (permalink / raw)
To: rms; +Cc: larsi, hendrik.tews, 45438
> From: Richard Stallman <rms@gnu.org>
> Date: Sat, 26 Dec 2020 05:28:00 -0500
> Cc: hendrik.tews@kernkonzept.com, 45438@debbugs.gnu.org
>
> 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.
If the suggestion is to use ChangeLog data for this feature, then I
think it won't be easy, because it isn't easy to parse the ChangeLog
text for gleaning this more accurate information. For starters, we
sometimes say "New function", sometimes just "New", and sometimes have
lists of functions (all of which are new) with a single "New" entry.
It would be better to have a DB of this data, which we would update
with each major release, than to try to parse ChangeLog files, IMO.
^ permalink raw reply [flat|nested] 11+ messages in thread
* bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
2020-12-26 10:58 ` Eli Zaretskii
@ 2020-12-26 21:56 ` Lars Ingebrigtsen
2020-12-27 5:38 ` Richard Stallman
1 sibling, 0 replies; 11+ messages in thread
From: Lars Ingebrigtsen @ 2020-12-26 21:56 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: hendrik.tews, rms, 45438
Eli Zaretskii <eliz@gnu.org> writes:
> It would be better to have a DB of this data, which we would update
> with each major release, than to try to parse ChangeLog files, IMO.
A database would be nice, but I'm against adding yet more formalism in
this area -- it's already a pain getting people to adhere to our current
conventions.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 11+ messages in thread
* bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
2020-12-26 10:58 ` Eli Zaretskii
2020-12-26 21:56 ` Lars Ingebrigtsen
@ 2020-12-27 5:38 ` Richard Stallman
2020-12-27 17:47 ` Eli Zaretskii
1 sibling, 1 reply; 11+ messages in thread
From: Richard Stallman @ 2020-12-27 5:38 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: larsi, hendrik.tews, 45438
[[[ 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. ]]]
> > is that the data that describe-function consults does not have all the
> > information that we have.
> If the suggestion is to use ChangeLog data for this feature, then I
> think it won't be easy, because it isn't easy to parse the ChangeLog
> text for gleaning this more accurate information.
I'm not suggesting we do anything about this problem. Do you see
any reason to?
--
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)
^ permalink raw reply [flat|nested] 11+ messages in thread
* bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
2020-12-27 5:38 ` Richard Stallman
@ 2020-12-27 17:47 ` Eli Zaretskii
2020-12-28 5:25 ` Richard Stallman
0 siblings, 1 reply; 11+ messages in thread
From: Eli Zaretskii @ 2020-12-27 17:47 UTC (permalink / raw)
To: rms; +Cc: larsi, hendrik.tews, 45438
> From: Richard Stallman <rms@gnu.org>
> Cc: larsi@gnus.org, hendrik.tews@kernkonzept.com,
> 45438@debbugs.gnu.org
> Date: Sun, 27 Dec 2020 00:38:30 -0500
>
> > If the suggestion is to use ChangeLog data for this feature, then I
> > think it won't be easy, because it isn't easy to parse the ChangeLog
> > text for gleaning this more accurate information.
>
> I'm not suggesting we do anything about this problem. Do you see
> any reason to?
We were asked to consider doing that by 2 different people. I agree
that the problem is not an urgent one nor a grave one, but if someone
wants to work on making that part of documentation more accurate, I
think gleaning the info from ChangeLog is not the best approach.
^ permalink raw reply [flat|nested] 11+ messages in thread
* bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
2020-12-27 17:47 ` Eli Zaretskii
@ 2020-12-28 5:25 ` Richard Stallman
0 siblings, 0 replies; 11+ messages in thread
From: Richard Stallman @ 2020-12-28 5:25 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: larsi, hendrik.tews, 45438
[[[ 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. ]]]
> but if someone
> wants to work on making that part of documentation more accurate, I
> think gleaning the info from ChangeLog is not the best approach.
I agree. I never meant to imply that we should try to scrape ChangeLog
for this -- though it might give correct results in most cases.
--
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)
^ permalink raw reply [flat|nested] 11+ messages in thread
* bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
2020-12-26 10:28 ` Richard Stallman
2020-12-26 10:58 ` Eli Zaretskii
@ 2020-12-26 21:04 ` Hendrik Tews
1 sibling, 0 replies; 11+ messages in thread
From: Hendrik Tews @ 2020-12-26 21:04 UTC (permalink / raw)
To: Richard Stallman, Lars Ingebrigtsen, 45438
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
^ permalink raw reply [flat|nested] 11+ messages in thread
* bug#45438: 27.1; please fix misleading documentation for assoc-delete-all
2020-12-25 22:32 ` Lars Ingebrigtsen
2020-12-26 10:28 ` Richard Stallman
@ 2020-12-26 21:17 ` Hendrik Tews
1 sibling, 0 replies; 11+ messages in thread
From: Hendrik Tews @ 2020-12-26 21:17 UTC (permalink / raw)
To: Lars Ingebrigtsen, 45438
Lars Ingebrigtsen <larsi@gnus.org> writes:
> assoc-delete-all has a convoluted history -- it was introduced in 1999,
The function introduced in July 1999 by Dave Love compared
elements with eq - it was definitely not assoc-delete-all, even
though it shared the same name for a couple of month.
Hendrik
^ permalink raw reply [flat|nested] 11+ messages in thread
[parent not found: <<87zh21fsb3.fsf@cert.kernkonzept.com>]
end of thread, other threads:[~2020-12-28 5:25 UTC | newest]
Thread overview: 11+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-12-25 22:13 bug#45438: 27.1; please fix misleading documentation for assoc-delete-all Hendrik Tews
2020-12-25 22:32 ` Lars Ingebrigtsen
2020-12-26 10:28 ` Richard Stallman
2020-12-26 10:58 ` Eli Zaretskii
2020-12-26 21:56 ` Lars Ingebrigtsen
2020-12-27 5:38 ` Richard Stallman
2020-12-27 17:47 ` Eli Zaretskii
2020-12-28 5:25 ` Richard Stallman
2020-12-26 21:04 ` Hendrik Tews
2020-12-26 21:17 ` Hendrik Tews
[not found] <<87zh21fsb3.fsf@cert.kernkonzept.com>
[not found] ` <<87blehcyai.fsf@gnus.org>
[not found] ` <<E1kt6no-0002VV-Ma@fencepost.gnu.org>
[not found] ` <<834kk8n8a8.fsf@gnu.org>
2020-12-26 18:59 ` Drew Adams
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).