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#54961: 28.1; info-display-manual completions issues Date: Tue, 19 Apr 2022 19:55:30 +0300 Message-ID: <835yn5ui65.fsf@gnu.org> References: <87wnfpccuu.fsf@gnus.org> <08B1B8C9-F276-4B4A-BC41-8719124A5C9A@gmail.com> <868rs2tm4w.fsf@mail.linkov.net> <8BC9ABD6-CC64-492B-8DF9-946F5348D52B@gmail.com> <83wnflvdms.fsf@gnu.org> <6D90FA16-36D2-4C4D-9872-AEB9BA858E8E@gmail.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="13035"; mail-complaints-to="usenet@ciao.gmane.io" Cc: larsi@gnus.org, 54961@debbugs.gnu.org, juri@linkov.net To: Howard Melman , Alan Third Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Apr 19 18:57:23 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 1ngrAJ-0003E7-3Z for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 19 Apr 2022 18:57:23 +0200 Original-Received: from localhost ([::1]:46416 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ngrAI-0005dI-2l for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 19 Apr 2022 12:57:22 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59672) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ngr9y-0005d8-Bd for bug-gnu-emacs@gnu.org; Tue, 19 Apr 2022 12:57:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:50123) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ngr9y-0002Z6-2P for bug-gnu-emacs@gnu.org; Tue, 19 Apr 2022 12:57:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ngr9y-0002DZ-15 for bug-gnu-emacs@gnu.org; Tue, 19 Apr 2022 12:57:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 19 Apr 2022 16:57:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 54961 X-GNU-PR-Package: emacs Original-Received: via spool by 54961-submit@debbugs.gnu.org id=B54961.16503873648457 (code B ref 54961); Tue, 19 Apr 2022 16:57:01 +0000 Original-Received: (at 54961) by debbugs.gnu.org; 19 Apr 2022 16:56:04 +0000 Original-Received: from localhost ([127.0.0.1]:44020 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ngr92-0002CL-66 for submit@debbugs.gnu.org; Tue, 19 Apr 2022 12:56:04 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:37858) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ngr8z-0002Bi-Gi for 54961@debbugs.gnu.org; Tue, 19 Apr 2022 12:56:02 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:44406) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ngr8s-0002Gl-7Q; Tue, 19 Apr 2022 12:55:55 -0400 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=pdAvE/BTlvQLzoTh+ermUXsfwMXj4YF+YBjvxN1RR+w=; b=J1jARK3ibqsK 5Ref4xIdqZxMwjWEU5N5hffaV0W5th0DDet8oH03EqlxMWggBf2SfSB7PpHPKxzhEz0mCNk8c4uvb /jx76m25N8Pgmi042iazMTK4nBwYQfzpLgZKdA1A8n6C9nT6Pm1Zc8hWu+5Sz4kcaL6WFXv1I8gSP LmCnv8mry0GiCQ7V/CeEpOcZiSkhFvN+rh+RbpypEKRAxnxZ8yhSSpotY4med5b+wc2y2rLgJplyO dJ8zCYODVJ9aEqzFCAh641HgFOz2eMLjocInqAHxeLZ+t7ThApw+GvWZEofPXGZ/wcFmlJ9VbDoZw hJ0w8AnJblFz9nezNWPAfw==; Original-Received: from [87.69.77.57] (port=2342 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ngr8j-0001LO-S2; Tue, 19 Apr 2022 12:55:53 -0400 In-Reply-To: <6D90FA16-36D2-4C4D-9872-AEB9BA858E8E@gmail.com> (message from Howard Melman on Tue, 19 Apr 2022 09:27:11 -0400) 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" Xref: news.gmane.io gmane.emacs.bugs:230250 Archived-At: > From: Howard Melman > Date: Tue, 19 Apr 2022 09:27:11 -0400 > Cc: Juri Linkov , > Lars Ingebrigtsen , > 54961@debbugs.gnu.org > > >> I see various section headings for other manuals installed in > >> /usr/local/share/info but not for the ones in the Emacs provided > >> dir file. > > > > I don't understand: the DIR file that comes with Emacs already has > > sections in it. > > > >> This is vanilla Emacs 28 -Q on a mac. The top is the Info > >> dir right after starting Emacs and the bottom is the contents of > >> /Applications/GnuEmacs.app/Contents/Resources/info/dir. > > > > Seems like you have more than one DIR file (which is completely > > normal). > > on emacs -Q (on mac) > > Info-default-directory-list > ("/Applications/GnuEmacs.app/Contents/Resources/info/" "/usr/local/share/info/" "/usr/share/info/") > > after running C-h i, Info-directory-list is the same > ("/Applications/GnuEmacs.app/Contents/Resources/info/" "/usr/local/share/info/" "/usr/share/info/") > > There's a dir in each of those. The dir in the GnuEmacs.app has sections > like "Emacs editing modes" and "Emacs misc features" (shown in the bottom > of the screenshot). /usr/local/share/info/dir has sections like "Programming > & development tools" and "Individual utilities". When I run C-h i the directory > that's displayed doesn't have sections from the former (as shown in the top > of the screenshot) and has different ones for the latter (there's "Software development" > and "Individual utilities"). > > When I run info, I don't see sections from the emacs supplied dir like "Emacs > editing modes". Shouldn't I? Is that a bug? I'm afraid I don't know, because it sounds like there's some macOS specific behavior here. The doc string of Info-directory-list says: When `Info-directory-list' is initialized from the value of `Info-default-directory-list', and Emacs is installed in one of the standard directories, the directory of Info files that come with Emacs is put last (so that local Info files override standard ones). When `Info-directory-list' is initialized from the value of `Info-default-directory-list', and Emacs is not installed in one of the standard directories, the first element of the resulting list is the directory where Emacs installs the Info files that come with it. This is so that Emacs's own manual, which suits the version of Emacs you are using, will always be found first. This is useful when you install an experimental version of Emacs without removing the standard installation. But then info-initialize, which is supposed to implement the above, deviates from that behavior on macOS, with this commentary: ;; For a self-contained (ie relocatable) NS build, AFAICS we ;; always want the included info directory to be at the head of ;; the search path, unless it's already in INFOPATH somewhere. ;; It's at the head of Info-default-directory-list, ;; but there's no way to get it at the head of Info-directory-list ;; except by doing it here. I cannot say I understand this reasoning, and neither do I understand whether this explains what you see in your case (because I don't know what is meant by "self-contained i.e. relocatable NS build". Maybe Alan (CC'ed) can help us out here. The order of the directories in Info-directory-list then determines the order of looking for DIR files in those directories, and eventually the order you see them in the DIR node produced by "C-h i" by concatenating all those DIR files, see Info-insert-dir. Maybe you should step in Edebug through that function to see what happens there and why. > I have installed various emacs packages via package-install. They don't all have > info manuals, but all the ones that do appear above Emacs in top level Info. > Yesterday I reported bugs for several and several changed to use > "@dircategory Emacs misc features". I updated them via list-packages and > see in their info files stuff like: > > INFO-DIR-SECTION Emacs misc features > START-INFO-DIR-ENTRY > * Embark: (embark). Emacs Mini-Buffer Actions Rooted in Keymaps. > END-INFO-DIR-ENTRY > > But when I restart emacs and run C-h i I still see them listed above emacs > and no sections. I will ask again: are those manuals installed using the install-info command? That is the command responsible for adding manuals to the DIR menus while paying attention to their sections.