From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#28584: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands Date: Sun, 24 Sep 2017 17:38:13 -0700 (PDT) Message-ID: <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> References: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1506299956 26631 195.159.176.226 (25 Sep 2017 00:39:16 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 25 Sep 2017 00:39:16 +0000 (UTC) Cc: 28584@debbugs.gnu.org To: John Wiegley Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Sep 25 02:39:06 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwHQN-00063y-PG for geb-bug-gnu-emacs@m.gmane.org; Mon, 25 Sep 2017 02:39:04 +0200 Original-Received: from localhost ([::1]:40114 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dwHQV-0000c0-0o for geb-bug-gnu-emacs@m.gmane.org; Sun, 24 Sep 2017 20:39:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48542) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dwHQP-0000bm-Fs for bug-gnu-emacs@gnu.org; Sun, 24 Sep 2017 20:39:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dwHQM-0005zq-D0 for bug-gnu-emacs@gnu.org; Sun, 24 Sep 2017 20:39:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:48170) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dwHQM-0005zc-8a for bug-gnu-emacs@gnu.org; Sun, 24 Sep 2017 20:39:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1dwHQL-00027D-T0 for bug-gnu-emacs@gnu.org; Sun, 24 Sep 2017 20:39:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 25 Sep 2017 00:39:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 28584 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 28584-submit@debbugs.gnu.org id=B28584.15062999048087 (code B ref 28584); Mon, 25 Sep 2017 00:39:01 +0000 Original-Received: (at 28584) by debbugs.gnu.org; 25 Sep 2017 00:38:24 +0000 Original-Received: from localhost ([127.0.0.1]:56851 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwHPk-00026M-4H for submit@debbugs.gnu.org; Sun, 24 Sep 2017 20:38:24 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:43500) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwHPj-000269-16 for 28584@debbugs.gnu.org; Sun, 24 Sep 2017 20:38:23 -0400 Original-Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v8P0cGxE012564 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 25 Sep 2017 00:38:16 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id v8P0cGt1026754 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 25 Sep 2017 00:38:16 GMT Original-Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id v8P0cEYa020234; Mon, 25 Sep 2017 00:38:14 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6776.5000 (x86)] X-Source-IP: userv0022.oracle.com [156.151.31.74] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:137381 Archived-At: > DA> In the Emacs manual, if you use `i multi' then, even > DA> if you have a way to substring-match index entries, > DA> you see nothing about using Isearch across multiple > DA> files or buffers. >=20 > DA> There are these index entries, for example: > DA> `multiple-file search and replace' > DA> `search and replace in multiple files' >=20 > Maybe I'm misunderstanding, but isn't the second index > entries just what you wanted to find? Not sure what you mean by "the second index entries". Both of the index entries I mentioned go to the same place - doc about tags search (only). This is the point: The only index entries that have to do with searching multiple files are entries for tags search. There are none for Isearch across multiple files. For some time now, Isearch has also been able to search multiple files (and multiple non-file buffers). But there are no index entries in the manual for doc about this feature. There should be. Tags search is not the only way now to search multiple files (and buffers). The text of both of the index entries I mentioned would _seem_ to cover both tags search and Isearch. There should be separate entries for these very different ways of searching multiple files. Fixing that by adding index entries would take care of what I wrote in the bug Subject line. But the bug report mentioned more than that. My bug report was for Emacs 24.5. The other part of the report, beyond adding index entries, was to add doc for the `multi-isearch-files(-regexp)' commands. They were not covered in Emacs 24.5. Only `multi-isearch-buffers(-regexp)' were covered (in node `Other Repeating Search'). Trying with Emacs 25.2, I see `multi-isearch-files(-regexp)' are now covered, so the part of the bug that asks for that can be ignored. But in Emacs 25.2 only the same `multi' index entries are available, and they still take you to doc that says nothing about Isearch. Instead of taking you to node `Tags Search' they now take you to node `Identifier Search' (which is its replacement). That changes nothing really for this bug - that node is still all about (only) tags or xref. It says nothing about Isearch across multiple files or buffers. The kind of "finding" that is described in node `Identifier Search' is not Isearch. We should have `multi' index entries for node `Other Repeating Search'. And we should have cross-references between the nodes that deal with these very different ways to search across multiple files or buffers. Index entries for searching across files or buffers should indicate whether they are about Isearch or "identifier" search. That's the first thing. The second thing is to add xrefs between the nodes that cover these very different kinds of search.