From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#66554: [PATCH] Add the public API of Compat to the core Date: Sat, 10 Feb 2024 21:12:00 +0200 Message-ID: <86eddkt9q7.fsf@gnu.org> References: <87pm1ggrdx.fsf@posteo.net> <83r0idx1p1.fsf@gnu.org> <87mst1tgrt.fsf@posteo.net> <874jf39rn7.fsf@daniel-mendler.de> <871qa47ch1.fsf@posteo.net> <87a5osfka1.fsf@daniel-mendler.de> <87y1c3s2ts.fsf@posteo.net> <864jer59gm.fsf@gnu.org> <87h6ils91z.fsf@posteo.net> <86r0hpz8o2.fsf@gnu.org> <87r0hpqs8i.fsf@posteo.net> <875xz05h6m.fsf@posteo.net> <86sf24xj9t.fsf@gnu.org> <87plx7e74o.fsf@posteo.net> <861q9nxt6t.fsf@gnu.org> <878r3s471v.fsf@posteo.net> <86mss8tgxl.fsf@gnu.org> <87o7co2ro9.fsf@posteo.net> <86le7stew9.fsf@gnu.org> <87y1bsqku2.fsf@daniel-mendler.de> <86il2wtd1w.fsf@gnu.org> <87sf20qj8x.fsf@daniel-mendler.de> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1549"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 66554@debbugs.gnu.org, philipk@posteo.net, stefankangas@gmail.com, monnier@iro.umontreal.ca To: Daniel Mendler Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Feb 10 20:13:08 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 1rYsmh-0000G3-5Q for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 10 Feb 2024 20:13:07 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rYsmO-0005X8-DP; Sat, 10 Feb 2024 14:12:48 -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 1rYsmN-0005Wt-6q for bug-gnu-emacs@gnu.org; Sat, 10 Feb 2024 14:12:47 -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 1rYsmM-0005i3-T7 for bug-gnu-emacs@gnu.org; Sat, 10 Feb 2024 14:12:46 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rYsmc-0004U0-BK for bug-gnu-emacs@gnu.org; Sat, 10 Feb 2024 14:13:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 10 Feb 2024 19:13:02 +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.170759235017157 (code B ref 66554); Sat, 10 Feb 2024 19:13:02 +0000 Original-Received: (at 66554) by debbugs.gnu.org; 10 Feb 2024 19:12:30 +0000 Original-Received: from localhost ([127.0.0.1]:34362 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rYsm5-0004Se-J7 for submit@debbugs.gnu.org; Sat, 10 Feb 2024 14:12:30 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38358) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rYsm2-0004SI-Ix for 66554@debbugs.gnu.org; Sat, 10 Feb 2024 14:12:29 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rYslf-0005TH-NF; Sat, 10 Feb 2024 14:12:03 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=Yo4aRHvi376nCvSRBuac1ZJHZPTyH2Ej6XIH+jMWPxs=; b=YSRA9heKacgg dDVSVmT8nRDmOnD6pvAQBQtolZt+GwKJzGR27M72096E0dG8Xy/enQ/BTz28frlPWpGwImIRNkq+b RaRNvW2M5QqB9jr+oGm+O+lH5DxMMfXQYtYvundu6pjUpUsQVnD0O5gjWODGwBcupPIiXEchuglgr wWUO8JrIiln+UEl1ZLhdqQVmLWAP9Q7pQcnM1sfvClLJSpY9avZIhnmWqVD7VX52hjbJkGwPU9I9/ 3aFmdyDJ31tE4w9gx9Jntv95bvq3XVl16Tt75wtDWGoRVSMVuHBOnnlv+91YWUpnvbRD5tOcqGmEZ jH2S9kRxs6ZTuPTNiiQaLg==; In-Reply-To: <87sf20qj8x.fsf@daniel-mendler.de> (message from Daniel Mendler on Sat, 10 Feb 2024 19:14:38 +0100) 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:279788 Archived-At: > From: Daniel Mendler > Cc: philipk@posteo.net, 66554@debbugs.gnu.org, stefankangas@gmail.com, > monnier@iro.umontreal.ca > Date: Sat, 10 Feb 2024 19:14:38 +0100 > > Eli Zaretskii writes: > > >> From: Daniel Mendler > >> Cc: Philip Kaludercic , 66554@debbugs.gnu.org, > >> stefankangas@gmail.com, monnier@iro.umontreal.ca > >> Date: Sat, 10 Feb 2024 18:40:21 +0100 > >> > >> Eli Zaretskii writes: > >> > >> >> From: Philip Kaludercic > >> >> Cc: mail@daniel-mendler.de, 66554@debbugs.gnu.org, stefankangas@gmail.com, > >> >> monnier@iro.umontreal.ca > >> >> Date: Sat, 10 Feb 2024 16:46:30 +0000 > >> >> > >> >> I might be mistaken, but from a cursory peak at package.el, specifically > >> >> `package-activate-1', the Info search path is only updated if the > >> >> package is activated. If the core-package takes priority over an > >> >> external package, the external package shouldn't get activated. > >> >> > >> >> This hasn't been a problem in the past, because core packages don't come > >> >> with their own manuals, but this is an exception since core-Compat is > >> >> not really the same code as ELPA-Compat. > >> >> > >> >> One way to fix this, would be to explain how to disable a package via > >> >> `package-load-list' in the Compat manual. I'll have to try it out, but > >> >> if it works, I think that solution should be acceptable. > >> > > >> > Another way to fix this is simply to include the Compat manual in > >> > emacs.git. > >> > >> No, this won't be useful. The Compat manual available at a given time is > >> not relevant for the Emacs version developed at that time. If we would > >> include the manual Compat 30 in Emacs 30, the manual will document > >> functionality already present and documented in the Emacs 30 manual > >> itself. The Compat 30 manual is only relevant for Emacs versions 29 and > >> older. > > > > People who actually install and activate Compat from ELPA will have > > the manual which comes with it first on the Info search path, no? So > > where's the problem, and what does "won't be useful" mean in this > > context? To recap, we are discussing ways to make the cross-reference > > to the Compat manual work in as many use cases as possible, in > > particular when Compat is either not installed or "not activated". > > I assume it will lead to less confusion if we focus on documenting the > compat.el functionality in the Elisp manual and refer to the Compat > manual on ELPA via an http link, instead of copying the Compat manual. > There should not be a cross-reference problem then? But we will be back to the issue of having too much to say in the ELisp manual about a relatively minor, perhaps even obscure, aspects. Which is why I'd prefer not to have all the information in the ELisp reference.