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 15:17:52 -0700 Message-ID: <200BE6E2E4C04E0CB402FC249FD0F66E@us.oracle.com> References: <18FECACAE8904F2A9A26016A02CCA5F0@us.oracle.com> <878wfdvdtu.fsf@mail.jurta.org> 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 1255559255 7030 80.91.229.12 (14 Oct 2009 22:27:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 14 Oct 2009 22:27:35 +0000 (UTC) Cc: 4725@emacsbugs.donarmstrong.com To: "'Juri Linkov'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Oct 15 00:27:24 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 1MyCJY-0002UE-1I for geb-bug-gnu-emacs@m.gmane.org; Thu, 15 Oct 2009 00:27:24 +0200 Original-Received: from localhost ([127.0.0.1]:39288 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyCJX-0004y5-HV for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Oct 2009 18:27:23 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MyCJS-0004xh-Fr for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 18:27:18 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MyCJN-0004vz-Sx for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 18:27:18 -0400 Original-Received: from [199.232.76.173] (port=35933 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyCJN-0004vw-KP for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 18:27:13 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:42457) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MyCJM-0007b5-Vs for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 18:27: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 n9EMRBQi016066; Wed, 14 Oct 2009 15:27:11 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n9EMP6KW015529; Wed, 14 Oct 2009 15:25:06 -0700 Resent-Date: Wed, 14 Oct 2009 15:25: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 22:25:06 +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.125555868014674 (code B ref 4725); Wed, 14 Oct 2009 22:25:06 +0000 Original-Received: (at 4725) by emacsbugs.donarmstrong.com; 14 Oct 2009 22:18:00 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from rgminet12.oracle.com (rcsinet12.oracle.com [148.87.113.124]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9EMHx9w014671 for <4725@emacsbugs.donarmstrong.com>; Wed, 14 Oct 2009 15:18:00 -0700 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rgminet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n9EMHSUe009440 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 14 Oct 2009 22:17:29 GMT Original-Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n9EKmDp1020656; Wed, 14 Oct 2009 22:18:49 GMT Original-Received: from abhmt010.oracle.com by acsmt353.oracle.com with ESMTP id 20410526401255558666; Wed, 14 Oct 2009 15:17:46 -0700 Original-Received: from dradamslap1 (/141.144.160.48) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 14 Oct 2009 15:17:46 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <878wfdvdtu.fsf@mail.jurta.org> Thread-Index: AcpNGYaHxiNgMoFIQ3GfJqDxdVrSeAAASjvg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: acsmt354.oracle.com [141.146.40.154] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090205.4AD64E0C.00E6:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Wed, 14 Oct 2009 18:27:17 -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:31942 Archived-At: > > 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. I guess your question is about how to interactively populate the buffer/file list? If so, I'd say keep it simple: If the list variable is already populated, then use that value. This lets users populate the variable ahead of time and then still use these commands interactively. If the list variable is null, then just have a simple loop for users to enter a buffer/file name (e.g. with completion), and end with an empty string. IOW, foo RET bar RET RET to give ("foo" "bar"). Obviously, users can also wrap these functions with a `let' that binds the list variable and define a new command that is appropriate to some particular list that is constructed in some particular way. The point here is just to have a couple rudimentary commands as a basis - IOW, to just turn these functions into commands in a simple way. > > 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. I meant _at least_ #1 AND #2. I think this is an important part of Isearch - at least as important as word search, for instance. There's no reason not to document it in the Emacs manual - the description would be short. The implementation is factored into misearch.el and isearch.el, but the feature should be mentioned (also) in the Commentary of isearch.el, just as other search features are mentioned. That Commentary is the overall description of Isearch, from an implementation point of view. It's OK to also say "see misearch.el for details about multi-search" etc.