From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#66554: [PATCH] Add the public API of Compat to the core Date: Thu, 18 Jan 2024 12:33:31 -0800 Message-ID: References: <87pm1ggrdx.fsf@posteo.net> <87y1cwpanh.fsf@posteo.net> <877ckgpa45.fsf@daniel-mendler.de> <87mstbpyd7.fsf@posteo.net> <87h6jjah1g.fsf@daniel-mendler.de> <87edenptba.fsf@posteo.net> <87bk9raaad.fsf@daniel-mendler.de> <87a5pbvbxc.fsf@posteo.net> <875xzza8jw.fsf@daniel-mendler.de> <87edemldlw.fsf@posteo.net> <83cyu6ifzw.fsf@gnu.org> <875xzyl8lq.fsf@posteo.net> <837ckeievw.fsf@gnu.org> <87h6jiqtsp.fsf@daniel-mendler.de> <835xzyiagj.fsf@gnu.org> <871qamkx0m.fsf@posteo.net> <83wmsdhgw8.fsf@gnu.org> <87wmsdxvz6.fsf@daniel-mendler.de> <878r4ml8sg.fsf@posteo.net> <83v87qwg48.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="21780"; mail-complaints-to="usenet@ciao.gmane.io" Cc: mail@daniel-mendler.de, monnier@iro.umontreal.ca, 66554@debbugs.gnu.org To: Eli Zaretskii , Philip Kaludercic Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jan 18 21:34:15 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1rQZ5a-0005Mm-TY for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 18 Jan 2024 21:34:14 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rQZ5N-0001kH-Sh; Thu, 18 Jan 2024 15:34:01 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rQZ5M-0001js-DO for bug-gnu-emacs@gnu.org; Thu, 18 Jan 2024 15:34:00 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rQZ5M-0008Ld-5K for bug-gnu-emacs@gnu.org; Thu, 18 Jan 2024 15:34:00 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rQZ5N-0006KH-TU for bug-gnu-emacs@gnu.org; Thu, 18 Jan 2024 15:34:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 18 Jan 2024 20:34:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66554 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 66554-submit@debbugs.gnu.org id=B66554.170561002224285 (code B ref 66554); Thu, 18 Jan 2024 20:34:01 +0000 Original-Received: (at 66554) by debbugs.gnu.org; 18 Jan 2024 20:33:42 +0000 Original-Received: from localhost ([127.0.0.1]:56790 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rQZ53-0006Jb-SD for submit@debbugs.gnu.org; Thu, 18 Jan 2024 15:33:42 -0500 Original-Received: from mail-ed1-x52d.google.com ([2a00:1450:4864:20::52d]:48318) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rQZ51-0006JL-V1 for 66554@debbugs.gnu.org; Thu, 18 Jan 2024 15:33:40 -0500 Original-Received: by mail-ed1-x52d.google.com with SMTP id 4fb4d7f45d1cf-55a349cf29cso27969a12.0 for <66554@debbugs.gnu.org>; Thu, 18 Jan 2024 12:33:38 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1705610012; x=1706214812; darn=debbugs.gnu.org; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:from:to:cc:subject:date:message-id:reply-to; bh=UvaaJgKpmR59JCZGzw+wcbfbcUvd5vF679uxDrSIEN4=; b=mtFPn/I0h+bhkCpvz92BiUQchRWyMiZ31GXqQkluTestWB3wIIZT9fDuLN00NTnlhD n0FmKSCigcgvn1BTZqaUmW8ShT7KQeBSY0C3/h4bhrUt7xAF5QRVgh0vIo7SBAs6WKD7 xznVrJSjwkPNeaaHcK42Gns/6kAbOzz50fm784a9WPDRX1Yx98p7ZkASFPZJRBUzM5Sa nlMvT268y8ArINppZrWdKRGJbOIHvTcdiMePGs6GE0gkCCD2LXE73lmc9xVJ3TO0aHvA xg551/D6/WHM44RJ8SE6pYSoldYujiK6iVgdrmWjZ+I+wm+Aum8vc6TlTR2zQMyQPinF aFGw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1705610012; x=1706214812; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=UvaaJgKpmR59JCZGzw+wcbfbcUvd5vF679uxDrSIEN4=; b=a8QgWfQ/+2hMG/4QEtH/A3pMX8bQ4Peuads56gGuOFBcCT6QmLHHtNAQLvlEz5Rwmu pGB+AgTFTpApU4lTbptzJouE8NaNWoObhW4Nqu+Tu6ypJb0fHFIrhhulEy5e4bLddZQk FBZwl+37oss/wOtAQkWRr3C6OtWkBXURDVlcs9DjXhd9euM8AbpwzrppF4cMcKWWgq1G 32+njoPRZVaRW7nkKLEPe4l1z7Mk8fePE8v6d/qn1ecasRqx5HjSbVak1JnOHTwNSCVM sQct/ALDHAOkfZWS3+ZAT6Kzjtjz+wx0M+FRDOpKkgR4XKMyzwLhC17Q/Zmoy5tyvgh3 /aUQ== X-Gm-Message-State: AOJu0Ywtb5X6XNyPCrZbD9MUrTezzS22/8UBNwBE7+3vNZ5QtPlVLkgU EnX1YR1Meso1+zoEXpBf+QrClsP9X6eV6ZBRbdgK96aIqsWel06rVvvrZcgI/1FFaRjzBdGY5Fe 3Uoa7n1/c4vFa9DDAjORVvgJhSGk= X-Google-Smtp-Source: AGHT+IE5GWdEjZmW2pNl5C39L/BA4efIWSQeG+xRVnU4cPpn3RJshJZF53MDJyc2nRaKndyifqmT75fwYl16GU2K3bw= X-Received: by 2002:aa7:c412:0:b0:559:667c:efaa with SMTP id j18-20020aa7c412000000b00559667cefaamr823048edq.36.1705610012114; Thu, 18 Jan 2024 12:33:32 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 18 Jan 2024 12:33:31 -0800 In-Reply-To: <83v87qwg48.fsf@gnu.org> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:278451 Archived-At: Eli Zaretskii writes: >> +** New package Compat >> +The Compat package on GNU ELPA provides forwards-compatibility >> +support, so that packages that still provide support for older > > I think this is known as "backward compatibility". AFAIU, backwards-compatibility is about making code written for Emacs 28 work without changes on Emacs 29 (N -> N+1). But forwards-compatibility is about making code written for Emacs 29 work without changes on Emacs 28 (N -> N-1). Compat is doing the latter. >> +versions of Emacs can still make use of newer definitions that can be >> +reasonably re-implemented in Elisp. Now a "pseudo" Compat package is >> +part of Emacs, that doesn't provide any compatibility support, but >> +only implements the public-facing API of Compat so that core packages >> +can use Compat, while also preventing the installation of Compat on >> +the most recent version of Emacs. > > Not sure this detailed description is useful. Why not just say that > Compat is now also available with Emacs? Maybe this could be moved to the git commit message, and we could focus in the documentation on what the consequences are for users and authors of third-party packages (not authors of :core packages, who are basically in the know already).