GNU bug report logs - #21206
Bug#793067: Bug#792328: info: can no longer find the Emacs manual

Message received at submit <at> debbugs.gnu.org:

Received: (at submit) by debbugs.gnu.org; 7 Aug 2015 12:27:46 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Aug 07 08:27:46 2015
Received: from localhost ([127.0.0.1]:41876 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1ZNgkS-0006nY-FC
	for submit <at> debbugs.gnu.org; Fri, 07 Aug 2015 08:27:45 -0400
Received: from eggs.gnu.org ([208.118.235.92]:54571)
 by debbugs.gnu.org with esmtp (Exim 4.80)
 (envelope-from <gavinsmith0123@HIDDEN>) id 1ZNgkP-0006nP-HF
 for submit <at> debbugs.gnu.org; Fri, 07 Aug 2015 08:27:42 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <gavinsmith0123@HIDDEN>) id 1ZNgkN-0007AH-TM
 for submit <at> debbugs.gnu.org; Fri, 07 Aug 2015 08:27:41 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: *
X-Spam-Status: No, score=1.1 required=5.0 tests=BAYES_50,
 FREEMAIL_ENVFROM_END_DIGIT,FREEMAIL_FROM,T_DKIM_INVALID autolearn=disabled
 version=3.3.2
Received: from lists.gnu.org ([2001:4830:134:3::11]:47951)
 by eggs.gnu.org with esmtp (Exim 4.71)
 (envelope-from <gavinsmith0123@HIDDEN>) id 1ZNgkN-0007AB-Qc
 for submit <at> debbugs.gnu.org; Fri, 07 Aug 2015 08:27:39 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:39831)
 by lists.gnu.org with esmtp (Exim 4.71)
 (envelope-from <gavinsmith0123@HIDDEN>) id 1ZNgkM-00084O-QS
 for bug-gnu-emacs@HIDDEN; Fri, 07 Aug 2015 08:27:39 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <gavinsmith0123@HIDDEN>) id 1ZNgkK-00078o-QH
 for bug-gnu-emacs@HIDDEN; Fri, 07 Aug 2015 08:27:38 -0400
Received: from mail-ig0-x229.google.com ([2607:f8b0:4001:c05::229]:37277)
 by eggs.gnu.org with esmtp (Exim 4.71)
 (envelope-from <gavinsmith0123@HIDDEN>)
 id 1ZNgkK-00078k-LK; Fri, 07 Aug 2015 08:27:36 -0400
Received: by igbpg9 with SMTP id pg9so30441126igb.0;
 Fri, 07 Aug 2015 05:27:36 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
 h=mime-version:in-reply-to:references:date:message-id:subject:from:to
 :cc:content-type;
 bh=7oba9bv3y8+ICRT9+wUgqIyQoxhCOBzwt0nR07EpNyM=;
 b=IUZcz7s/9dZ7ZdVPbu+uPfHwaCDzXTpCM0jEPTlLbv0dXXUVA+YINSiFWqg7HvsbD0
 SE6LO7tsR2ASJagiBzl1vae5h8adh10htHsu1XDCmH9ryVjgeQw6Gjxc6sa060GtxA+m
 wwCCqxH5+sNqEeIWo4mFAIxk1zUuuxOvbSj7B9Lqh93JYfESX/WC+fQ3+YFXM4+Zqj6e
 RerKK/+zExHwdnXREfasA6sVNlgCQ82j7G0T2zwjpK3E+UBTPgDt/r5ZvVE/3HSPRSgH
 eDbe9AtkZ2cW0YS3PiQ+9waI9iwtiU8DCyJyz0WAN2hSzuCrQ/zCrSJrTzColD02AR/P
 pfhw==
MIME-Version: 1.0
X-Received: by 10.50.124.4 with SMTP id me4mr2564846igb.34.1438950456172; Fri,
 07 Aug 2015 05:27:36 -0700 (PDT)
Received: by 10.36.87.204 with HTTP; Fri, 7 Aug 2015 05:27:36 -0700 (PDT)
In-Reply-To: <834mkbscxa.fsf@HIDDEN>
References: <87io8x6z7i.fsf@HIDDEN>
 <201508032155.t73LtVPb018995@HIDDEN>
 <20150803231023.GH17940@HIDDEN>
 <CAKPWYQ0A18vh=hk2wWZW425AsUS9Q919OV0UYZt08REDeT=DcQ@HIDDEN>
 <834mkbscxa.fsf@HIDDEN>
Date: Fri, 7 Aug 2015 13:27:36 +0100
Message-ID: <CAKPWYQ3XCzt39mNEOsFRTUGsdfGFAvtYM=ShnbDzDJo3Ff8vvQ@HIDDEN>
Subject: Re: Bug#793067: Bug#792328: info: can no longer find the Emacs manual
From: Gavin Smith <gavinsmith0123@HIDDEN>
To: bug-gnu-emacs@HIDDEN
Content-Type: text/plain; charset=UTF-8
X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address
 (bad octet value).
X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address
 (bad octet value).
X-Received-From: 2001:4830:134:3::11
X-Spam-Score: -3.8 (---)
X-Debbugs-Envelope-To: submit
Cc: Texinfo <bug-texinfo@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.8 (---)

I implemented an option in the standalone Info browser to search the
subdirectory containing the current Info file when following a
cross-reference to another manual, before searching through the Info
file search path. Emacs Info could have a similar option.

The variable is called "follow-strategy": in Emacs the variable could
be "Info-follow-strategy". The two possible values at the moment are
"remain" and "path". "remain" is the default: it means to try to
remain in the current subdirectory. The other is "path" which means
search through the search path, which was the previous default
behaviour. If you can think of better names please email.

The intention behind this change is to improve support for
installation of multiple versions of manuals at once. For example,
with a dir entry of

* Emacs-23: (emacs-23/emacs)Top.

and with files emacs-23/emacs.info, emacs-23/calc.info
doing "info Emacs-23" gives the emacs-23/emacs.info file. Then
following a cross-reference "*Note (calc)Top::." will find
emacs-23/calc.info, instead of whatever calc.info file was earlier in
the search path. Likewise there can be other subdirectories under the
main Info subdirectory for other versions, like "emacs-24" or
"emacs-25", containing the corresponding Info files.

This should be useful for projects like Emacs with many manuals that
all reference each other, and when finding the manual for the same
version is desirable.

This appears to provide the functionality that some users wanted, for
example the Debian maintainers. However, let me point out what this
doesn't accomplish:

* References to the "emacs" manual from outwith the "emacs-23"
subdirectory will not be capable of finding "emacs-23/emacs.info",
unless "emacs-23" is in the search path.
* Such dir entries cannot at present be automatically generated by
appropriately invoking install-info (the program to update dir files),
or by Automake-generated build systems that install Info files. So
there still isn't a convenient way to install and access multiple
versions of Info manuals at once.
* References to subdirectories in node specifications aren't treated
the way they need to be for this to work by the Info browser from the
Texinfo 6.0 release; this has been changed since then in the
development sources.

Please email bug-texinfo@HIDDEN with any suggestions that could be
useful for the Texinfo project.

Eli Zaretskii asked me to file this bug report. I emailed
bug-gnu-emacs because M-x report-emacs-bug isn't set up to send emails
for me.