From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Ihor Radchenko Newsgroups: gmane.emacs.bugs Subject: bug#60032: 30.0.50; [WISH] Customizing Info directories Date: Wed, 14 Dec 2022 10:27:19 +0000 Message-ID: <87wn6up9fc.fsf@localhost> References: <87zgbrbfva.fsf@localhost> <83a63rpgzd.fsf@gnu.org> <87r0x3beqx.fsf@localhost> <834jtzpdu9.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="27873"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 60032@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Dec 14 11:30:50 2022 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 1p5P2H-00074L-AQ for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 14 Dec 2022 11:30:49 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p5Ozg-0003Wr-9x; Wed, 14 Dec 2022 05:28:08 -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 1p5Oza-0003Vg-P9 for bug-gnu-emacs@gnu.org; Wed, 14 Dec 2022 05:28:05 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1p5Oza-0002nK-GB for bug-gnu-emacs@gnu.org; Wed, 14 Dec 2022 05:28:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1p5Oza-0007m4-CA for bug-gnu-emacs@gnu.org; Wed, 14 Dec 2022 05:28:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Ihor Radchenko Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 14 Dec 2022 10:28:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 60032 X-GNU-PR-Package: emacs Original-Received: via spool by 60032-submit@debbugs.gnu.org id=B60032.167101365029870 (code B ref 60032); Wed, 14 Dec 2022 10:28:02 +0000 Original-Received: (at 60032) by debbugs.gnu.org; 14 Dec 2022 10:27:30 +0000 Original-Received: from localhost ([127.0.0.1]:38172 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p5Oz3-0007li-Pe for submit@debbugs.gnu.org; Wed, 14 Dec 2022 05:27:30 -0500 Original-Received: from mout02.posteo.de ([185.67.36.66]:36699) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p5Oz1-0007la-MA for 60032@debbugs.gnu.org; Wed, 14 Dec 2022 05:27:28 -0500 Original-Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 2CC62240107 for <60032@debbugs.gnu.org>; Wed, 14 Dec 2022 11:27:21 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1671013642; bh=KAn1A/pkvLIts6Rkt37gUsIzlSdLuL5FxXFX6Q5CVWc=; h=From:To:Cc:Subject:Date:From; b=PofLG2ZFiXw5JE00wYVh9ojVsHFrFRkR7McmR+Cs2/p1ugqUTNVEEzsjYouq2NX/N 56yAvI+66zn6WOZMYWrtWtRYSLS6hR3p6EclscKGVzdubbBToUZlU/VDivM+wAXEtu vvpvxmhifDVBE+tZi5joD1t+cZF+pMnsgYGDBk3kM2jot+oBWd3na5snXNZ7Zd9lHx HsvMERS+D2TmR4/FkWFUbjgsOZSOuo2She7hZ7qjcLfeWb/WBzjthVZ+chvhQRks1b ZUkktvSwAajcsHaafrgKqJQqPTrhza+zZpf9j/oZlBdefQWHc3DywFtxpnOsKufwHm oB5vuz1QV8fZw== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4NXBPj256cz6tmL; Wed, 14 Dec 2022 11:27:21 +0100 (CET) In-Reply-To: <834jtzpdu9.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:250924 Archived-At: Eli Zaretskii writes: >> However, `Info-default-directory-list' being ignored is rather >> surprising, especially given that setting the other defcustom >> (`Info-additional-directory-list') does not allow overriding system >> settings. > > It is done for a good reason. Setting up the list correctly is > difficult enough, what with the requirement that Emacs's own manuals > should sometimes be before the system-wide installation, and sometimes > after it (to support different use cases). When INFOPATH is defined, > and used by the stand-alone Info reader, install-info, and other > stuff, it becomes impossible to DTRT. So we punt, in effect saying: > if you have INFOPATH, you should already know what you are doing. INFOPATH may be set by OS, not by user. For example, it is the case for me. I have never changed the default value of INFOPATH, which is non-empty on Gentoo. > If you want the gory details (which I happily forgot), run "git log -L" > (or vc-region-history) on the area where Info-default-directory-list > is defined and used, and read the discussions related to the changes > and bugs reported against that. I fail to see why a new variable, symmetric to `Info-additional-directory-list' cannot be added. It will be prepended, as opposed to `Info-additional-directory-list', to the Info path. Also, searching through the commits I noticed the following entry in Emacs FAQ: 3.5 How do I install a piece of Texinfo documentation? =E2=80=A2 You can create your own Info directory. You can tell Emacs wh= ere that Info directory is by adding its pathname to the value of the variable =E2=80=98Info-default-directory-list=E2=80=99. For example, = to use a private Info directory which is a subdirectory of your home directory named =E2=80=98Info=E2=80=99, you could put this in your ini= t file (*note Setting up a customization file::): (add-to-list 'Info-default-directory-list "~/Info/") You will need a top-level Info file named =E2=80=98dir=E2=80=99 in thi= s directory which has everything the system =E2=80=98dir=E2=80=99 file has in it, = except it should list only entries for Info files in that directory. You might not need it if (fortuitously) all files in this directory were referenced by other =E2=80=98dir=E2=80=99 files. The node lists = from all =E2=80=98dir=E2=80=99 files in =E2=80=98Info-default-directory-list=E2= =80=99 are merged by the Info system. The above if not true when INFOPATH environment variable is set, AFAIU. >> Changing environment variables is something I never ever needed to >> customize Emacs' behaviour. Once I see it, my thinking goes: "Surely, >> there should be some custom variable.", but no such variable exists. > > Does this include PATH? If not, why not? > > IME, the *PATH variables are quite special: they should generally be > set from outside Emacs, and doing the same via customization options > is usually not a good idea. I agree. However, I expect in-Emacs info reader to be more configurable. It's not like info.el requires external system tools. I prefer Emacs to be portable as much as sanely possible. --=20 Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at