From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#4725: 23.1; doc of misearch-* commands (commands?) Date: Wed, 14 Oct 2009 13:49:52 -0700 Message-ID: <18FECACAE8904F2A9A26016A02CCA5F0@us.oracle.com> Reply-To: Drew Adams , 4725@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1255554740 24751 80.91.229.12 (14 Oct 2009 21:12:20 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 14 Oct 2009 21:12:20 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Oct 14 23:12:09 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MyB4N-0006il-0x for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Oct 2009 23:07:39 +0200 Original-Received: from localhost ([127.0.0.1]:53270 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyB4M-0008VQ-Ea for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Oct 2009 17:07:38 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MyB44-0008Ot-EP for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 17:07:20 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MyB3z-0008MW-8o for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 17:07:19 -0400 Original-Received: from [199.232.76.173] (port=37919 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyB3y-0008MQ-WF for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 17:07:15 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:59552) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MyB3y-000251-9z for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 17:07:14 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9EL7B3H003609; Wed, 14 Oct 2009 14:07:12 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n9EKt6Qw000886; Wed, 14 Oct 2009 13:55:06 -0700 Resent-Date: Wed, 14 Oct 2009 13:55:06 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Wed, 14 Oct 2009 20:55:05 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 4725 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.125555341132759 (code B ref -1); Wed, 14 Oct 2009 20:55:05 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 14 Oct 2009 20:50:11 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9EKo9SQ032719 for ; Wed, 14 Oct 2009 13:50:10 -0700 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MyAnQ-0003EH-Un for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:50:08 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MyAnM-0003Dk-Cr for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:50:08 -0400 Original-Received: from [199.232.76.173] (port=41529 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyAnM-0003Dh-83 for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:50:04 -0400 Original-Received: from rcsinet12.oracle.com ([148.87.113.124]:17320 helo=rgminet12.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MyAnK-0008Br-31 for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:50:03 -0400 Original-Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rgminet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n9EKnbgw019791 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 14 Oct 2009 20:49:38 GMT Original-Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n9EG5pQb016632 for ; Wed, 14 Oct 2009 20:49:58 GMT Original-Received: from abhmt012.oracle.com by acsmt358.oracle.com with ESMTP id 20409917021255553386; Wed, 14 Oct 2009 15:49:46 -0500 Original-Received: from dradamslap1 (/141.144.160.48) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 14 Oct 2009 13:49:46 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcpND+DuBHS9nYUNRI2+oHs0IMISKw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: acsmt353.oracle.com [141.146.40.153] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090203.4AD63975.0120:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Wed, 14 Oct 2009 17:07:19 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:31938 Archived-At: emacs -Q In NEWS it says: ** The package misearch.el has been added. It allows Isearch to search through multiple buffers. A variable `multi-isearch-next-buffer-function' defines the function to call to get the next buffer to search in the series of multiple buffers. Top-level commands `multi-isearch-buffers', `multi-isearch-buffers-regexp', `multi-isearch-files' and `multi-isearch-files-regexp' accept a single argument that specifies a list of buffers/files to search for a string/regexp. But this is false. The functions `multi-isearch-buffers', `multi-isearch-buffers-regexp', `multi-isearch-files' and `multi-isearch-files-regexp', defined in misearch.el, are not defined as commands. 1. Shouldn't they be commands? I.e., this is the first bug. Or else change the NEWS item. 2. I find no explanation of using Isearch with multiple buffers or files anywhere, including in the Emacs manual. This needs to be documented somewhere. Logically, this should be explained in a new section of the Isearch chapter of the Emacs manual. It is even the case that multi-isearch is handled, in its essentials, in isearch.el (not in misearch.el). So this is really an integral part of Isearch. It needs to be properly documented as such. That means at least (1) in the Emacs manual and (2) in the file Commentary of isearch.el. I would even say that it should be documented how to use the multi-isearch framework to set up multiple buffers etc. for searching. It's not obvious (1) that you can do that or (2) how to do that. There is no reason not to let Emacs-Lisp programmers know about this. This is provided out of the box as part of Isearch, and it should be well documented. In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600) of 2009-07-29 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4)'