From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.bugs Subject: bug#4725: 23.1; doc of misearch-* commands (commands?) Date: Thu, 15 Oct 2009 00:57:17 +0300 Organization: JURTA Message-ID: <878wfdvdtu.fsf@mail.jurta.org> References: <18FECACAE8904F2A9A26016A02CCA5F0@us.oracle.com> Reply-To: Juri Linkov , 4725@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1255558069 3579 80.91.229.12 (14 Oct 2009 22:07:49 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 14 Oct 2009 22:07:49 +0000 (UTC) Cc: 4725@emacsbugs.donarmstrong.com To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Oct 15 00:07:38 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 1MyC0P-0001ws-HR for geb-bug-gnu-emacs@m.gmane.org; Thu, 15 Oct 2009 00:07:37 +0200 Original-Received: from localhost ([127.0.0.1]:50552 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyC0O-0000RD-Ou for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Oct 2009 18:07:36 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MyC08-000092-DB for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 18:07:20 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MyC03-0008TH-Gi for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 18:07:19 -0400 Original-Received: from [199.232.76.173] (port=39496 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyC03-0008SV-Bl for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 18:07:15 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:53851) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MyC01-0002lg-KP for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 18:07:13 -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 n9EM7B0o013141; Wed, 14 Oct 2009 15:07:11 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n9EM58BQ012103; Wed, 14 Oct 2009 15:05:08 -0700 Resent-Date: Wed, 14 Oct 2009 15:05:08 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Juri Linkov Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Wed, 14 Oct 2009 22:05:07 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 4725 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by 4725-submit@emacsbugs.donarmstrong.com id=B4725.125555752710941 (code B ref 4725); Wed, 14 Oct 2009 22:05:07 +0000 Original-Received: (at 4725) by emacsbugs.donarmstrong.com; 14 Oct 2009 21:58:47 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from mx1.starman.ee (smtp-out1.starman.ee [85.253.0.3]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9ELwjmM010934 for <4725@emacsbugs.donarmstrong.com>; Wed, 14 Oct 2009 14:58:47 -0700 X-Virus-Scanned: by Amavisd-New at mx1.starman.ee Original-Received: from mail.starman.ee (82.131.99.144.cable.starman.ee [82.131.99.144]) by mx1.starman.ee (Postfix) with ESMTP id 9BA8F3F41AE; Thu, 15 Oct 2009 00:58:39 +0300 (EEST) In-Reply-To: <18FECACAE8904F2A9A26016A02CCA5F0@us.oracle.com> (Drew Adams's message of "Wed, 14 Oct 2009 13:49:52 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.50 (x86_64-pc-linux-gnu) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Wed, 14 Oct 2009 18: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:31941 Archived-At: > 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. Yes, they should be commands. These command should allow the user to select interactively a list of buffers or files to search. Currently I have no idea about the best UI for this. Suggestions welcome. > 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. (3) the Emacs Lisp Reference Manual (4) in the file Commentary of misearch.el I prefer (4) since it is not a core feature to be documented in the Info manual. -- Juri Linkov http://www.jurta.org/emacs/