GNU bug report logs - #20232
25.0.50; doc string of `multi-isearch-buffer-list'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 20232 in the body.
You can then email your comments to 20232 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.0.50; doc string of `multi-isearch-buffer-list'
Date: Mon, 30 Mar 2015 10:36:36 -0700 (PDT)

Please add a doc string.  Seems that if anything in `misearch.el'
deserves a doc string it is this variable.

This is presumably the easiest and best thing for code to test, to see
if Isearch is currently searching more than one buffer.  At least a
glance at the code gives me that impression.  It seems better, I'm
guessing, than testing either of these:

* (and multi-isearch-next-buffer-current-function
       (buffer-live-p multi-isearch-current-buffer))

* Option multi-isearch-search.


In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2014-10-20 on LEG570
Bzr revision: 118168 rgm <at> gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'

Message #8 received at 20232 <at> debbugs.gnu.org (full text, mbox):

From: Juri Linkov <juri <at> linkov.net>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 20232 <at> debbugs.gnu.org
Subject: Re: bug#20232: 25.0.50; doc string of `multi-isearch-buffer-list'
Date: Tue, 31 Mar 2015 23:38:03 +0300

> Please add a doc string.  Seems that if anything in `misearch.el'
> deserves a doc string it is this variable.
>
> This is presumably the easiest and best thing for code to test, to see
> if Isearch is currently searching more than one buffer.  At least a
> glance at the code gives me that impression.  It seems better, I'm
> guessing, than testing either of these:
>
> * (and multi-isearch-next-buffer-current-function
>        (buffer-live-p multi-isearch-current-buffer))
>
> * Option multi-isearch-search.

You can see in `isearch-message-prefix' that `multi-isearch-file-list'
is used to test if Isearch is currently searching more than one file,
so do you need to have a doc string for `multi-isearch-file-list' as well?

Message #11 received at 20232 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Juri Linkov <juri <at> linkov.net>
Cc: 20232 <at> debbugs.gnu.org
Subject: RE: bug#20232: 25.0.50; doc string of `multi-isearch-buffer-list'
Date: Thu, 2 Apr 2015 09:21:38 -0700 (PDT)

> You can see in `isearch-message-prefix' that `multi-isearch-file-list'
> is used to test if Isearch is currently searching more than one file,
> so do you need to have a doc string for `multi-isearch-file-list' as well?

Yes, I think so.  Thx.

(I've been using a build from 2014/10, where `isearch.el' does not refer to
`multi-search-file-list'.)

Message #16 received at 20232-done <at> debbugs.gnu.org (full text, mbox):

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: 20232-done <at> debbugs.gnu.org
Subject: Re: 25.0.50; doc string of `multi-isearch-buffer-list'
Date: Tue, 07 Apr 2015 10:15:42 -0700

I gave a shot at documenting those vars as master commit 
29500239d3289803275ed6d4c774ab4488918564 and am marking this as done.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.