--- Begin Message ---
Subject: |
[PATCH] Add the public API of Compat to the core |
Date: |
Sun, 15 Oct 2023 09:35:22 +0000 |
Tags: patch
See https://lists.gnu.org/archive/html/emacs-devel/2023-10/msg00260.html
for the background behind this proposal.
In GNU Emacs 30.0.50 (build 5, x86_64-pc-linux-gnu, GTK+ Version
3.24.37, cairo version 1.16.0) of 2023-10-13 built on quetzal
Repository revision: 97959349651a8fb170c1c754e73a4d86ed24d018
Repository branch: master
System Description: Debian GNU/Linux 12 (bookworm)
Configured using:
'configure --with-pgtk --with-imagemagick --with-tree-sitter'
0001-Add-the-public-API-of-Compat-to-the-core.patch
Description: Text Data
--- End Message ---
--- Begin Message ---
Subject: |
Re: bug#66554: [PATCH] Add the public API of Compat to the core |
Date: |
Sun, 11 Feb 2024 21:52:04 +0000 |
Philip Kaludercic <philipk@posteo.net> writes:
> Eli Zaretskii <eliz@gnu.org> writes:
>
>>> From: Philip Kaludercic <philipk@posteo.net>
>>> Cc: mail@daniel-mendler.de, 66554@debbugs.gnu.org, stefankangas@gmail.com,
>>> monnier@iro.umontreal.ca
>>> Date: Sat, 10 Feb 2024 16:29:00 +0000
>>>
>>> >> Note that Compat provides replacement functions with extended
>>> >> functionality for functions that are already defined (@code{sort},
>>> >> @code{assoc}, @dots{}). These functions may have changed their
>>> >> calling convention (additional optional arguments) or may have changed
>>> >> their behavior. These functions must be looked up explicitly with
>>> >> @code{compat-function} or called explicitly with @code{compat-call}.
>>> >> We call them ``Extended Definitions''. In contrast, newly ``Added
>>> >> Definitions'' can be called as usual.
>>> >
>>> > Thanks. I suggest to copy the above paragraph to the ELisp reference
>>> > manual,
>>>
>>> OK, can do.
>>>
>>> > and add a cross-reference to the Compat manual after it.
>>>
>>> IIUC the cross-reference will be broken, unless the user has installed
>>> Compat manually.
>>
>> I wouldn't be worried about that: the cross-reference is readable, and
>> the reader will understand what it says even if it cannot be followed.
>> We do that for other manuals, which belong to other packages that
>> might not be installed.
>
> OK. I don't have access to the machine with the latest version of the
> patch, but as soon as I get that going again, I'll update it and push
> the change to master.
I have pushed the patch to master, and will therefore close this bug
report. Thanks to everyone involved for helping out.
--- End Message ---