GNU bug report logs - #66554
[PATCH] Add the public API of Compat to the core

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Philip Kaludercic <philipk <at> posteo.net>
Cc: mail <at> daniel-mendler.de, stefankangas <at> gmail.com, monnier <at> iro.umontreal.ca, 66554 <at> debbugs.gnu.org
Subject: bug#66554: [PATCH] Add the public API of Compat to the core
Date: Fri, 19 Jan 2024 08:47:12 +0200

> From: Philip Kaludercic <philipk <at> posteo.net>
> Cc: mail <at> daniel-mendler.de,  66554 <at> debbugs.gnu.org,
>   monnier <at> iro.umontreal.ca,  stefankangas <at> gmail.com
> Date: Thu, 18 Jan 2024 20:47:38 +0000
> 
> Eli Zaretskii <eliz <at> gnu.org> writes:
> 
> >> From: Philip Kaludercic <philipk <at> posteo.net>
> >> Cc: Eli Zaretskii <eliz <at> gnu.org>,  66554 <at> debbugs.gnu.org,
> >>   monnier <at> iro.umontreal.ca,  stefankangas <at> gmail.com
> >> Date: Thu, 18 Jan 2024 19:51:27 +0000
> >> 
> >> Pinging this thread with an updated version of the patch:
> >
> > I find the documentation of this arrangement still insufficient.  The
> > way this stuff works (which required Daniel to write 150 lines of
> > explanation) is mostly kept out of the written docs, so we'll have to
> > rely on people's memory.  Can we document this machinery better?
> 
> I can go into more detail, integrating what Daniel explained, my
> question just is if this is something that really interests someone
> reading the Elisp manual?

My suggestion is to have the details in compat.el; the ELisp reference
should just mention the package as the recommended means for making
3rd-party and ELPA packages compatible with older Emacs versions.

> In this case I just meant "hack" in the sense of a "clever trick", since
> it was not immediately obvious to anyone until you brought it up.

I believe we call that a "kludge".

Previous Next

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