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: Mon, 25 Sep 2017 08:13:09 -0700 (PDT) Message-ID: References: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> <09b64866-de79-423d-b001-b00366d22500@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 1506352551 13048 195.159.176.226 (25 Sep 2017 15:15:51 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 25 Sep 2017 15:15:51 +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 17:15:44 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 1dwV6j-0002mT-JT for geb-bug-gnu-emacs@m.gmane.org; Mon, 25 Sep 2017 17:15:41 +0200 Original-Received: from localhost ([::1]:42939 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dwV6r-00075u-1J for geb-bug-gnu-emacs@m.gmane.org; Mon, 25 Sep 2017 11:15:49 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33242) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dwV5B-0005Zq-77 for bug-gnu-emacs@gnu.org; Mon, 25 Sep 2017 11:14:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dwV57-00045T-V4 for bug-gnu-emacs@gnu.org; Mon, 25 Sep 2017 11:14:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:49940) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dwV57-00045N-Rx for bug-gnu-emacs@gnu.org; Mon, 25 Sep 2017 11:14:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1dwV57-0005Rl-MV for bug-gnu-emacs@gnu.org; Mon, 25 Sep 2017 11:14: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 15:14: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.150635240020876 (code B ref 28584); Mon, 25 Sep 2017 15:14:01 +0000 Original-Received: (at 28584) by debbugs.gnu.org; 25 Sep 2017 15:13:20 +0000 Original-Received: from localhost ([127.0.0.1]:58621 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwV4S-0005Qe-99 for submit@debbugs.gnu.org; Mon, 25 Sep 2017 11:13:20 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:48467) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwV4Q-0005QR-EZ for 28584@debbugs.gnu.org; Mon, 25 Sep 2017 11:13:19 -0400 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v8PFDB3b007254 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 25 Sep 2017 15:13:12 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id v8PFDBTg002062 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 25 Sep 2017 15:13:11 GMT Original-Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id v8PFDBM3003205; Mon, 25 Sep 2017 15:13:11 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: userv0021.oracle.com [156.151.31.71] 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:137408 Archived-At: > > And not just an _addition_ of index entries for this (for both files an= d > > buffers). The _existing_ index entries I mentioned are misleading. They > > should be changed to specify finding certain "identifiers" in files (bu= t > > not non-file buffers, I imagine). They are not really about searching, > > in the general sense. >=20 > But doesn't it also find `M-x tags-query-replace`? In which case, > it is a search. Yes, it does. I was unclear, er, wrong, in saying that. But as all "search" doc is not in the same place, we need separate index entries. Those should characterize, as much as is practical, the differences. That is, a given index entry should let you know, by its name (text), what the target node covers. Since we will need different entries for the different nodes that deal with search (differently), the entry text needs to distinguish the sense. Equally important to indexing clearly the nodes that deal with these different kinds of multi-file/buffer search is providing cross-references between them. This is all the more important because they both deal with searching (across files/buffers), in some sense. For example, if a user follows an index entry to get to the doc for finding identifiers, s?he should see there that there are also other kinds of search, documented in another location. It would be good if the nodes in question pointed out the particular kinds of searching (i.e., the difference between them), where they provide the xref. Another possibility is to have a general node about searching and replacing, which describes what's available generally (pointing out differences) and then dispatches with a menu to the nodes that currently exist. Someone new (or old) to Emacs, who is not aware of what is available for searching, should be offered a high-level overview of search & replace, which covers, occur/grep-style searching, find(-dired)-style searching, tags/xref-style searching, query-replace, and isearch searching (did I leave anything out?). I'm occasionally surprised, for example, to see that some users don't realize (or at least don't think about the fact) that occur/grep search only single-line contexts.