From unknown Sat Jun 21 10:28:41 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#28584 <28584@debbugs.gnu.org> To: bug#28584 <28584@debbugs.gnu.org> Subject: Status: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands Reply-To: bug#28584 <28584@debbugs.gnu.org> Date: Sat, 21 Jun 2025 17:28:41 +0000 retitle 28584 24.5; Emacs manual: add index entries for `multi-isearch-*' c= ommands reassign 28584 emacs submitter 28584 Drew Adams severity 28584 wishlist thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 24 13:49:48 2017 Received: (at submit) by debbugs.gnu.org; 24 Sep 2017 17:49:48 +0000 Received: from localhost ([127.0.0.1]:56402 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwB2K-0007VC-BR for submit@debbugs.gnu.org; Sun, 24 Sep 2017 13:49:48 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40500) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwB2I-0007Uy-5S for submit@debbugs.gnu.org; Sun, 24 Sep 2017 13:49:47 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dwB2C-0006Kb-5K for submit@debbugs.gnu.org; Sun, 24 Sep 2017 13:49:40 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:37156) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dwB2C-0006KV-2C for submit@debbugs.gnu.org; Sun, 24 Sep 2017 13:49:40 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:59704) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dwB2B-0007oo-3O for bug-gnu-emacs@gnu.org; Sun, 24 Sep 2017 13:49:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dwB28-0006F8-2H for bug-gnu-emacs@gnu.org; Sun, 24 Sep 2017 13:49:39 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:48979) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dwB27-0006Ec-PF for bug-gnu-emacs@gnu.org; Sun, 24 Sep 2017 13:49:35 -0400 Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v8OHnXwB018959 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 24 Sep 2017 17:49:34 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id v8OHnXiu011064 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 24 Sep 2017 17:49:33 GMT Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id v8OHnWHl022820 for ; Sun, 24 Sep 2017 17:49:33 GMT MIME-Version: 1.0 Message-ID: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> Date: Sun, 24 Sep 2017 10:49:31 -0700 (PDT) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6776.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) In the Emacs manual, if you use `i multi' then, even if you have a way to substring-match index entries, you see nothing about using Isearch across multiple files or buffers. There are these index entries, for example: `multiple-file search and replace' `search and replace in multiple files' But those just take you to node `Tags Search'. Please consider doc changes, to (1) include more doc for Isearching across multiple files and buffers, (2) index that doc, and (3) cross-reference between that doc and node `Tags Search'. The existing index entries mentioned above no doubt need to be changed, to distinguish tags-based searching from Isearching. For #1: Please document the `multi-isearch-*' commands more thoroughly. Currently, `multi-isearch-files', and `multi-isearch-files-regexp' are not mentioned. In GNU Emacs 24.5.1 (i686-pc-mingw32) of 2015-04-11 on LEG570 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/usr --host=3Di686-pc-mingw32' From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 24 19:25:02 2017 Received: (at 28584) by debbugs.gnu.org; 24 Sep 2017 23:25:03 +0000 Received: from localhost ([127.0.0.1]:56780 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwGGk-0000Oc-I1 for submit@debbugs.gnu.org; Sun, 24 Sep 2017 19:25:02 -0400 Received: from mail-pf0-f180.google.com ([209.85.192.180]:48947) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwGGi-0000Nx-H8 for 28584@debbugs.gnu.org; Sun, 24 Sep 2017 19:25:00 -0400 Received: by mail-pf0-f180.google.com with SMTP id n24so2903821pfk.5 for <28584@debbugs.gnu.org>; Sun, 24 Sep 2017 16:25:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:mime-version; bh=TfYWFrgNDtd0SZWsLWjtkIlHFRKWZeNEUbu4uq4mG70=; b=pcTp5mzkDCf4Lx5t57e3lek5EFr52qmTeUP3KJyZSPkl7kN86LJ54jA90hIQzwASa+ tdeuB54bk9KjYjcvm3nZSPBQlVyMmYTOnxBbI0k6l1jGpz7ZsD8kB91SXREzbtE95SPI zVL7GXewQin7e5Wnglo+P+1d2Wrd+I7+WYdSMs7/glZllPtc/OYmojAPuX25G7gyreHx k+4zHIeanRVk6ztaekgogl8u/kmvs5w6iUqUoDfeyJSowgYbVowQB3648AEHMp66Qyj+ 4BdCLUWGsO0UEjD6zEkmQtJm/2L4givG6PZpySdJZRIoOtaXiVjVRd3hp478O9nWMMtx Hmww== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:in-reply-to:date:message-id :references:user-agent:mime-version; bh=TfYWFrgNDtd0SZWsLWjtkIlHFRKWZeNEUbu4uq4mG70=; b=KlB2dcISdahT+EOvJxtCwNljU43QiszT43Lak2qbqUF/2FQN6pVQJsoPlgIm3rtE/K yWJmQdTTak9erqlNiXHUDrrs6jT0PMCJLT23+TVpYXbofLlcM5MJISoXfq0CrQmja5V7 rRt7NqoUUrbjFgaRUTqZCBZA55DPlpoEtGhf3XQFtQvAfIIhj3zObGVTRP0WZtEaNwL2 Ty4x1ikU5/j331H5+UfcnX7e2Hmf2d9qTZRSyvHPiPnEOmzVHt8RyskuphtdF+00wOVy jYAC6I69/n2HizLjEmuGDza7H/c6SP607Is0ZWMwdSBh6vKZOWPy05MUVVKHyPmHUP17 yZQg== X-Gm-Message-State: AHPjjUju8suAArYmpXYR0mLWbz5oWfgQkUHpsEGdSRzWJvEsmSYuw6kH EKnh30c2tfGhMgx08b8vPh2nf3D5 X-Google-Smtp-Source: AOwi7QA57z4bohNbVm0MfGDAEHMmfSHqFZLPgwBSQ74zyrGQeEkrjBWTkxe0eGevgvYtCt9D8TWCPw== X-Received: by 10.99.117.13 with SMTP id q13mr5791015pgc.366.1506295494695; Sun, 24 Sep 2017 16:24:54 -0700 (PDT) Received: from Vulcan.local (76-234-69-149.lightspeed.frokca.sbcglobal.net. [76.234.69.149]) by smtp.gmail.com with ESMTPSA id n2sm8518324pgs.89.2017.09.24.16.24.53 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 24 Sep 2017 16:24:53 -0700 (PDT) From: John Wiegley X-Google-Original-From: "John Wiegley" Received: by Vulcan.local (Postfix, from userid 501) id A94C3906827E; Sun, 24 Sep 2017 16:24:52 -0700 (PDT) To: Drew Adams Subject: Re: bug#28584: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands In-Reply-To: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> (Drew Adams's message of "Sun, 24 Sep 2017 10:49:31 -0700 (PDT)") Date: Sun, 24 Sep 2017 16:09:19 -0700 Message-ID: References: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> User-Agent: Gnus/5.130016 (Ma Gnus v0.16) Emacs/26.0 (darwin) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 28584 Cc: 28584@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) >>>>> "DA" == Drew Adams writes: DA> In the Emacs manual, if you use `i multi' then, even if you have a way to DA> substring-match index entries, you see nothing about using Isearch across DA> multiple files or buffers. DA> There are these index entries, for example: DA> `multiple-file search and replace' DA> `search and replace in multiple files' Maybe I'm misunderstanding, but isn't the second index entries just what you wanted to find? -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2 From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 24 20:38:24 2017 Received: (at 28584) by debbugs.gnu.org; 25 Sep 2017 00:38:24 +0000 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 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 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 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 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 MIME-Version: 1.0 Message-ID: <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> Date: Sun, 24 Sep 2017 17:38:13 -0700 (PDT) From: Drew Adams To: John Wiegley Subject: RE: bug#28584: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands References: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> 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)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-Spam-Score: -5.1 (-----) X-Debbugs-Envelope-To: 28584 Cc: 28584@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.1 (-----) > 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. From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 25 00:30:13 2017 Received: (at 28584) by debbugs.gnu.org; 25 Sep 2017 04:30:13 +0000 Received: from localhost ([127.0.0.1]:57048 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwL25-00024A-C2 for submit@debbugs.gnu.org; Mon, 25 Sep 2017 00:30:13 -0400 Received: from mail-pf0-f178.google.com ([209.85.192.178]:49386) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwL23-00023j-RB for 28584@debbugs.gnu.org; Mon, 25 Sep 2017 00:30:12 -0400 Received: by mail-pf0-f178.google.com with SMTP id l188so3208068pfc.6 for <28584@debbugs.gnu.org>; Sun, 24 Sep 2017 21:30:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:mime-version; bh=cIrIkJnJNE8FxqM3YBXKsm9Sdn2g91qLjbrvXZ3djwI=; b=h4ShVtFDzB1yDrVJX8WnNr2/3zenaaXAGk5rY9zcXEvbGrxf+EO1o4KuqkwOcQubyr /aNHYms3I/ZCicsc/KyfXbnZshr0vBOxEvHyEteYqdKl4/jIFLPsocdccAO9MikNHgYd 97NGn1A0Gr/L7sjgvKYFK1Cosa2TJKteCsEiuyUBbUbOzAEhez239awE2t9Fva3VRMu3 A9ZXAkOq+DspOiU39ujGtFbh/nqJfP3TdSR5zK7J0HBvcepGNR5Vms93Yssuhqbos3Ll oXMFluiJtNAHOYwlKVNXPmV9RuudxevYBhjgenMeK1RElXQ26Q5PchBfet4VMjjsQUZj 4XVw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:in-reply-to:date:message-id :references:user-agent:mime-version; bh=cIrIkJnJNE8FxqM3YBXKsm9Sdn2g91qLjbrvXZ3djwI=; b=e8Qxpqzq+xk2JGVEZwooLZ1HMxhA/ybCpWAJvPeagpbjJSB10EyzmIx8lrkXmdbKn+ MAb9Yk9z4GxboxjAZHM0BOaCyP4IYxC7MjRT5tEEuWiCUQdZQXZRTQikMbClbEzjbgYu w3KVl12yOthZlzeelgIA1tEt3gCtrHrBjdakyLsyQbrkkGrcxHKlWzAu5UCWx4ZOR/vl jT9mYqGIa1RECy0YNTTYVIYy9xP/avtg8ZdXs45ii1h2RBbJ0UyUKtUzxwiqiompOYKh XUwH3yUxt4PLUt09LFPTNLRi+ArdOhv3iO0DTQffvmCWh9xE3sgHdQFFpLA4vYKDabJ9 Bwng== X-Gm-Message-State: AHPjjUiIMGplB3OJ33OJVa/Sk11Z3eV0cQavp3Fl+KE8tBSezBBOmw/4 y36BJScsjDkt7nlmMwQg7Pk0I3Sl X-Google-Smtp-Source: AOwi7QAybEuS81EnwueUFVGFebRZAhZzaKK+7ih2sR93gQGXwys7WiNLtanwwh/YmvumgO0v9O937w== X-Received: by 10.99.112.79 with SMTP id a15mr6441956pgn.154.1506313805879; Sun, 24 Sep 2017 21:30:05 -0700 (PDT) Received: from Vulcan.local (76-234-69-149.lightspeed.frokca.sbcglobal.net. [76.234.69.149]) by smtp.gmail.com with ESMTPSA id f74sm9053096pfa.36.2017.09.24.21.30.04 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 24 Sep 2017 21:30:05 -0700 (PDT) Received: by Vulcan.local (Postfix, from userid 501) id 70C67906A72A; Sun, 24 Sep 2017 21:30:04 -0700 (PDT) From: John Wiegley To: Drew Adams Subject: Re: bug#28584: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands In-Reply-To: <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> (Drew Adams's message of "Sun, 24 Sep 2017 17:38:13 -0700 (PDT)") Date: Sun, 24 Sep 2017 21:29:16 -0700 Message-ID: References: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> User-Agent: Gnus/5.130016 (Ma Gnus v0.16) Emacs/26.0 (darwin) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.8 (--) X-Debbugs-Envelope-To: 28584 Cc: 28584@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.8 (--) >>>>> Drew Adams writes: > 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). I mean the second thing you had listed: `search and replace in multiple files' But now I see that also refers to Tags-based search and replace. Yes, we should have an index entry for Isearching across files. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2 From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 25 09:42:06 2017 Received: (at 28584) by debbugs.gnu.org; 25 Sep 2017 13:42:06 +0000 Received: from localhost ([127.0.0.1]:57548 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwTeA-0005mV-Kv for submit@debbugs.gnu.org; Mon, 25 Sep 2017 09:42:06 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:46610) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwTe8-0005m0-Uu for 28584@debbugs.gnu.org; Mon, 25 Sep 2017 09:42:05 -0400 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v8PDfw5K027741 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 25 Sep 2017 13:41:58 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id v8PDfwha001658 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 25 Sep 2017 13:41:58 GMT Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id v8PDfwRo004812; Mon, 25 Sep 2017 13:41:58 GMT MIME-Version: 1.0 Message-ID: <09b64866-de79-423d-b001-b00366d22500@default> Date: Mon, 25 Sep 2017 06:41:56 -0700 (PDT) From: Drew Adams To: John Wiegley Subject: RE: bug#28584: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands References: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> 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)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 28584 Cc: 28584@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > > 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)= . >=20 > I mean the second thing you had listed: > `search and replace in multiple files' > But now I see that also refers to Tags-based search and replace. >=20 > Yes, we should have an index entry for Isearching across files. And across (non-file) buffers. And not just Isearching. The same node includes `multi-occur*'. And not just an _addition_ of index entries for this (for both files and buffers). The _existing_ index entries I mentioned are misleading. They should be changed to specify finding certain "identifiers" in files (but not non-file buffers, I imagine). They are not really about searching, in the general sense. IOW, we should have index entries for (1) actually searching and other index entries for (2) finding identifiers. (The former can find text matches of any kind, not just identifiers.) From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 25 10:19:47 2017 Received: (at 28584) by debbugs.gnu.org; 25 Sep 2017 14:19:47 +0000 Received: from localhost ([127.0.0.1]:58534 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwUEd-0000Oh-6D for submit@debbugs.gnu.org; Mon, 25 Sep 2017 10:19:47 -0400 Received: from mail-pf0-f175.google.com ([209.85.192.175]:48859) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwUEa-0000OJ-Ug for 28584@debbugs.gnu.org; Mon, 25 Sep 2017 10:19:45 -0400 Received: by mail-pf0-f175.google.com with SMTP id n24so3858306pfk.5 for <28584@debbugs.gnu.org>; Mon, 25 Sep 2017 07:19:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:mime-version; bh=3ywIm1MzqWtmzLL8g8z9mCz5Ymn2Q0XTkJfdINOlOYY=; b=Z+1EzcjlV0Pv91GdVSY7xGnD//x+NLQ4sTatIvm2sP56SD2T7+XTSvo3SZ7aP1HKNQ 0w/vHQC9BCYI3ZLBavX/Lqi6pz1VQHXCOAR8AioI8iSCJp6223DolG2aaJnEpSxr5OhM FN93eZQB8lTF+pdBUxqQhyDnRLo4NIIgxLfom+s3LnPJSoO/GkQjHsIiDjQ9nI6gHrUI sRjPire+8V51AWkgroHRHXSxse5EtDa4XIuhsr5P87pQwz3UEALLjyFejrLHMW08y9yH B65it8YOYn1lY8PI47+sFxk/7AX9h+7jOuke9kHMPnHs5cKjuc17TEweLo80E3K09Qpn LVjg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:in-reply-to:date:message-id :references:user-agent:mime-version; bh=3ywIm1MzqWtmzLL8g8z9mCz5Ymn2Q0XTkJfdINOlOYY=; b=q27m8TyvicO5V+ezB2kC1sLUuL7gGBAX+NhI7O+9fzaDTdNvOfIrRs3vSTEAe83Keu saIoU+tuz0zD74cdo+1YGR5hlvbhX+Ol9I0et4OELUxLa5byjzXI2rnXOvee93X8X9E0 a5HRfA0MbYh7MSkUJxEWRX+C5T+OHx2S4on24eZkb6hJUSorUFJo+LlVETk56o2H2zwS ZiQndwGPAMq4tyUIwjiifK/pCx6VGDZyAkSfMOhnzTwEPO1ceopxE+uQlp3BY/Pe/SKL STmQdU6AWSA59JoCv6JEMxQwtQIClFoRohR3NJieQvnmVcrPKdYO18wqTDH2ve45otse Hchw== X-Gm-Message-State: AHPjjUi+3NuyGAlmJRMVvFhLailnKv5J4aeoDEzDWUKILn06NE1XQvqu 0DSgqk07JOdSIvn11rs9MR6iujdp X-Google-Smtp-Source: AOwi7QDMKrAHYo8hOPkuFZdNht+tfvEgEi0AiZIJeZMy5pWiU7EMjtU7ORVulD1GXKsBkbncfZLEoA== X-Received: by 10.84.216.78 with SMTP id f14mr7773942plj.394.1506349178658; Mon, 25 Sep 2017 07:19:38 -0700 (PDT) Received: from Vulcan.local (76-234-69-149.lightspeed.frokca.sbcglobal.net. [76.234.69.149]) by smtp.gmail.com with ESMTPSA id g16sm12531063pgn.62.2017.09.25.07.19.37 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 25 Sep 2017 07:19:37 -0700 (PDT) Received: by Vulcan.local (Postfix, from userid 501) id E6517906E06B; Mon, 25 Sep 2017 07:19:36 -0700 (PDT) From: John Wiegley To: Drew Adams Subject: Re: bug#28584: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands In-Reply-To: <09b64866-de79-423d-b001-b00366d22500@default> (Drew Adams's message of "Mon, 25 Sep 2017 06:41:56 -0700 (PDT)") Date: Mon, 25 Sep 2017 07:16:01 -0700 Message-ID: References: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> <09b64866-de79-423d-b001-b00366d22500@default> User-Agent: Gnus/5.130016 (Ma Gnus v0.16) Emacs/26.0 (darwin) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.8 (--) X-Debbugs-Envelope-To: 28584 Cc: 28584@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.8 (--) >>>>> Drew Adams writes: > And not just an _addition_ of index entries for this (for both files and > buffers). The _existing_ index entries I mentioned are misleading. They > should be changed to specify finding certain "identifiers" in files (but not > non-file buffers, I imagine). They are not really about searching, in the > general sense. But doesn't it also find `M-x tags-query-replace`? In which case, it is a search. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2 From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 25 11:13:20 2017 Received: (at 28584) by debbugs.gnu.org; 25 Sep 2017 15:13:20 +0000 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 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 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 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 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 MIME-Version: 1.0 Message-ID: Date: Mon, 25 Sep 2017 08:13:09 -0700 (PDT) From: Drew Adams To: John Wiegley Subject: RE: bug#28584: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands References: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> <09b64866-de79-423d-b001-b00366d22500@default> 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)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 28584 Cc: 28584@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > > 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. From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 25 11:20:36 2017 Received: (at 28584) by debbugs.gnu.org; 25 Sep 2017 15:20:36 +0000 Received: from localhost ([127.0.0.1]:58640 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwVBU-0007U6-K1 for submit@debbugs.gnu.org; Mon, 25 Sep 2017 11:20:36 -0400 Received: from mail-pg0-f41.google.com ([74.125.83.41]:56924) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dwVBT-0007Tt-5P for 28584@debbugs.gnu.org; Mon, 25 Sep 2017 11:20:35 -0400 Received: by mail-pg0-f41.google.com with SMTP id 7so4135447pgd.13 for <28584@debbugs.gnu.org>; Mon, 25 Sep 2017 08:20:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:mime-version; bh=Ng8qNqO4Vx38yt9ixus+J4aDfJWtgu3MeDv/TmFpDoM=; b=OzM9XGfUzZbmG2i3wp58QK93OsC83ibuUBzKJyE5Ys58Rn2IcHsuquveQ7xcVAagi0 CCj1mks9idUcGUfLYkKllLV3ESRxO5zjkuYW2HBXGDOCuKXt9yvV44nhSgvGzDTrAuPc MDUc3svDZE8EQRodpJPVtahxiqgWzNgCvSS+6EETZUJGjys1hPvjoQvBPQN/KuVTFlIZ 4YA8ZRi8azlOptnlDI50vdepSOZ+XlvD3zrdfs01z9Hc1lGpuKgItwdJ20x+5KS38B3g t5TBSeey8y2z/j3WyZuM2ublRMgwyoRf/X28ZvAydc5HyQxAPnGNpIaGKjT1X3C3U0Sl iN1A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:in-reply-to:date:message-id :references:user-agent:mime-version; bh=Ng8qNqO4Vx38yt9ixus+J4aDfJWtgu3MeDv/TmFpDoM=; b=Tyu63P4HpLQmbPEFrjsuA5o6ntkz0SnIfCh+HlCFRqRFuVupWsAplGVGAmIJGpToOd DZWH1JMf+uI3iaTbs5ivZJsOR9NAPu8OGQNzxsThkteEX2GdtgF/vQI2HjjYKX4mPLtY cKi1kQVh8LJOwUcQLSgOqcrkaMZayAVDiVoWGcKC/4oq/N7HtOvtG4rUna7iXex+Ysgn GJ27tLCwIx4xhlsth7BM++m8EaU9zeBSo0cUOzG701fUtbkbLatgOMCyErFTWXfr7hn1 0sQbsp/BJtHQOOZ10tL+VKbtxEaR5+dKQoae7ysmtKZlFwY76RS6Ax5Okk4Yj09RP2Q5 sdCw== X-Gm-Message-State: AHPjjUgYqQf+5JkQjmKELE4qb26Yny8PgR5iu5jnlKdr44JzVOo2sS3I cWilcPkJZSJT0FudNn4mFWnhFrlM X-Google-Smtp-Source: AOwi7QBFuMqcKgik3Iuxd27i5YDeRT4Trwe6PY03/mwewYMHwPA0SjglW9bc1oOYIlOTmeFcJztHsw== X-Received: by 10.99.104.6 with SMTP id d6mr8054453pgc.168.1506352829103; Mon, 25 Sep 2017 08:20:29 -0700 (PDT) Received: from Vulcan.local (76-234-69-149.lightspeed.frokca.sbcglobal.net. [76.234.69.149]) by smtp.gmail.com with ESMTPSA id e20sm11234059pgn.68.2017.09.25.08.20.28 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 25 Sep 2017 08:20:28 -0700 (PDT) From: John Wiegley X-Google-Original-From: John Wiegley Received: by Vulcan.local (Postfix, from userid 501) id 69EA590703B0; Mon, 25 Sep 2017 08:20:27 -0700 (PDT) To: Drew Adams Subject: Re: bug#28584: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands In-Reply-To: (Drew Adams's message of "Mon, 25 Sep 2017 08:13:09 -0700 (PDT)") Date: Mon, 25 Sep 2017 08:20:13 -0700 Message-ID: References: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> <09b64866-de79-423d-b001-b00366d22500@default> User-Agent: Gnus/5.130016 (Ma Gnus v0.16) Emacs/26.0 (darwin) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 28584 Cc: 28584@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) >>>>> Drew Adams writes: > 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. I think I would like this also; I too use the index quite a bit to find things in the Elisp/Emacs manuals. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2 From debbugs-submit-bounces@debbugs.gnu.org Sat Sep 30 08:11:21 2017 Received: (at 28584-done) by debbugs.gnu.org; 30 Sep 2017 12:11:21 +0000 Received: from localhost ([127.0.0.1]:40098 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dyGc5-0001QY-2j for submit@debbugs.gnu.org; Sat, 30 Sep 2017 08:11:21 -0400 Received: from eggs.gnu.org ([208.118.235.92]:52445) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dyGc3-0001QK-1J for 28584-done@debbugs.gnu.org; Sat, 30 Sep 2017 08:11:19 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dyGbt-000290-Pv for 28584-done@debbugs.gnu.org; Sat, 30 Sep 2017 08:11:13 -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.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:50416) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dyGbt-00028v-M8; Sat, 30 Sep 2017 08:11:09 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3197 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dyGbs-0006zm-Gb; Sat, 30 Sep 2017 08:11:09 -0400 Date: Sat, 30 Sep 2017 15:11:00 +0300 Message-Id: <83k20g4ca3.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> (message from Drew Adams on Sun, 24 Sep 2017 17:38:13 -0700 (PDT)) Subject: Re: bug#28584: 24.5; Emacs manual: add index entries for `multi-isearch-*' commands References: <5ef55653-62f0-43d8-9c6c-2dbfb8da21d7@default> <0d2ae30c-1627-490a-bbaa-a53ea4a6235c@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 28584-done Cc: jwiegley@gmail.com, 28584-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > Date: Sun, 24 Sep 2017 17:38:13 -0700 (PDT) > From: Drew Adams > Cc: 28584@debbugs.gnu.org > > 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). Thanks, I've now fixed the indexing about these issues. From unknown Sat Jun 21 10:28:41 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 29 Oct 2017 11:24:06 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator